feishu-sticker

What This Skill Does

The feishu-sticker skill is a powerful automation utility designed to bridge local media management with Feishu's enterprise messaging platform. It allows users to send images as native, high-quality stickers directly into Feishu chats. By abstracting the complex process of authenticating, uploading to Feishu's CDN, and managing image keys, this skill enables seamless visual communication within your workflow. It features sophisticated background processing, including automatic GIF-to-WebP conversion using ffmpeg for optimal performance and size, and intelligent caching based on file MD5 hashes to ensure that common stickers are only uploaded once, drastically reducing latency and network traffic.

Installation

To integrate this skill into your OpenClaw environment, follow these steps:

1. Ensure your OpenClaw agent is initialized. Run the command clawhub install openclaw/skills/skills/autogame-17/feishu-sticker.
2. Prepare your sticker directory by placing your image assets in ~/.openclaw/media/stickers/. You can customize this path by setting the STICKER_DIR environment variable.
3. Navigate to the skill directory and run npm install to resolve dependencies, including critical libraries like ffmpeg-static, axios, and form-data.
4. Ensure your Feishu bot credentials are correctly configured in your environment file, as the skill requires valid OAuth or App-level tokens to interact with the Feishu API.

Use Cases

This skill is perfect for developers or office automation enthusiasts who use Feishu as their primary communication tool. It is ideal for:

• Automated Notifications: Sending reaction stickers to notify teams of successful build pipelines or deployment status.
• Expression Management: Building a curated library of team-specific reaction stickers that can be triggered by natural language queries.
• Workflow Automation: Converting dynamic agent outputs into shareable visual feedback directly in the chat interface.

Example Prompts

• "Send a happy cat sticker to the product team group chat."
• "Find an angry cat sticker and send it to user ou_123456 as a reaction."
• "Send the image located at /downloads/meme.jpg to the general channel."

Tips & Limitations

• Optimization: The skill automatically compresses images larger than 5MB to comply with Feishu's file size limits.
• Performance: While the initial upload may take a moment due to conversion, the MD5 caching ensures subsequent uses are instantaneous.
• Compatibility: Ensure your local FFmpeg environment is compatible with the version provided by ffmpeg-static for reliable GIF conversions. If you encounter issues, verify that your API tokens have permission to send messages to the intended target user or channel.