Feishu Image

What This Skill Does

The Feishu Image skill allows you to seamlessly upload and send images to Feishu (Lark) chats or directly to users. It intelligently handles both local image files and images from URLs, automatically downloading them before sending. A key feature of this skill is its caching mechanism for image_key. This means that if you attempt to upload the same image multiple times, the skill will reuse the previously obtained image_key, preventing redundant uploads and improving efficiency. This is particularly useful for frequently shared images.

Installation

To install the Feishu Image skill, you can use the following command in your ClawKit environment:

clawhub install openclaw/skills/skills/autogame-17/feishu-image

This command fetches the skill from the specified source repository.

Use Cases

This skill is ideal for several scenarios:

• Automated Notifications: Send status updates, screenshots, or reports as images to specific Feishu channels or individuals.
• Content Sharing: Quickly share visual content from your local machine or from the web directly into Feishu conversations.
• Development & Testing: Integrate image sending into your development workflows for testing purposes, such as sending error logs or debugging screenshots.
• Team Collaboration: Enhance team communication by easily sharing visual information within Feishu.

Example Prompts

1. Send this screenshot to the marketing channel: --target oc_xxxxxxxxxxxx --file /path/to/my/screenshot.png
2. Share this product image with John Doe: --target ou_yyyyyyyyyyyy --url https://example.com/product.jpg
3. Upload and send the latest report image to the project group: --target oc_zzzzzzzzzzzz --file ./reports/latest_report.jpeg

Tips & Limitations

• Configuration: Ensure you have correctly configured your Feishu API credentials by setting the FEISHU_APP_ID and FEISHU_APP_SECRET environment variables. Without these, the skill cannot authenticate with Feishu.
• Target Identification: Double-check that the --target value is a valid Feishu User OpenID (starting with ou_) or Chat ID (starting with oc_). Incorrect IDs will result in sending failures.
• File Paths and URLs: Verify that local file paths are correct and accessible, and that the provided image URLs are publicly accessible and valid.
• Image Size and Format: Be aware of any potential image size or format limitations imposed by the Feishu API. While common formats are usually supported, excessively large files might cause issues.
• Caching: The image_key caching is beneficial for performance but means that if you update a local file with the same name, the skill might send the cached version if the key hasn't changed. Clear cache or use a different filename if this behavior is undesirable.
• Error Handling: Implement robust error handling in your scripts that call this skill, as network issues or invalid inputs can lead to sending failures.