A professional utility for automating the upload and delivery of images and captions to Feishu chats and groups.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install feishu-img-tool
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install feishu-img-tool using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Feishu Image Tool?
The Feishu Image Tool is a high-performance integration designed to simplify media handling within the Feishu (Lark) ecosystem. By incorporating this utility into your Openclaw Skills workflow, you can overcome the platform's multi-step image handling requirements with a single command. The tool bridges the gap between local image files and Feishu's messaging API, allowing for the programatic distribution of charts, reports, and screenshots.
Built for developers and automation experts, this skill provides a robust way to interact with the Feishu SDK. It handles the nuances of image key generation and message formatting, ensuring that your automated agents can communicate visually with the same ease as text-based interactions.
Feishu Image Tool Use Cases
- Delivering automated financial or performance reports directly to stakeholder group chats.
- Sending real-time monitoring screenshots to dev-ops teams during system incidents.
- Automating the distribution of marketing collateral to internal channels for review.
- Integrating visual feedback loops within CI/CD pipelines to notify teams of build outcomes.
How Feishu Image Tool Works
- The skill authenticates with the Feishu API using your application's App ID and App Secret.
- When an image path is provided, the tool performs an upload to the /open-apis/im/v1/images endpoint.
- Upon a successful upload, Feishu returns a unique image_key which represents the hosted asset.
- The tool then initiates a second request to the /open-apis/im/v1/messages endpoint, referencing the image_key and the intended recipient.
- The final message is rendered in the target chat with an optional text caption included alongside the image.
Feishu Image Tool Setup
To get started with this component of your Openclaw Skills setup, you must first configure your Feishu App credentials.
# Method 1: Export as environment variables
export FEISHU_APP_ID="your_app_id"
export FEISHU_APP_SECRET="your_app_secret"
# Method 2: Use a local configuration file
# Create ~/.feishu-image/config.json with the following structure:
{
"appId": "cli_xxx",
"appSecret": "xxx"
}
Ensure that your Feishu application has been granted the im:message and im:image permissions in the Feishu Developer Console.
Feishu Image Tool Data Schema & Taxonomy
The skill utilizes a structured JSON schema for operations and returns specific metadata for every transaction.
| Attribute | Description |
|---|---|
| file_path | The local system path to the image file (Max size: 10 MB). |
| target | The recipient's open_id or chat_id. |
| image_key | A permanent identifier for the uploaded image. |
| formats | Supported extensions: JPG, JPEG, PNG, WEBP, GIF, BMP, ICO. |
| resolution | Up to 12000px for static images; 2000px for GIFs. |
Feishu Image Tool Advanced Features
- Permanent image_key reuse: Optimize performance by uploading once and sending the same key to multiple recipients.
- Flexible targeting: Send images to specific users, group chats, or the current active conversation by omitting the target ID.
- Caption support: Attach contextual text messages to image payloads for more informative notifications.
- SDK integration: Leverages the official @larksuiteoapi/node-sdk for enterprise-grade reliability.
SKILL.md
Loading
Related Openclaw Skills
EvoMap Lite Client
A feature-rich lightweight client for AI agents to participate in the EvoMap ecosystem through automated task loops and Swarm collaboration.
EvoMap Auto Task Publish
An automated task executor for EvoMap that handles the full lifecycle of fetching, claiming, and publishing tasks to earn credits and reputation.
Agent Browser
A high-performance Rust-based headless browser automation CLI that enables AI agents to navigate, interact with, and extract data from web pages.
MailCheck Email Verification
A powerful email validation skill for verifying addresses, bulk processing, and detecting phishing or fraud via the MailCheck API.
Chinese Font Renderer for Python Images
A professional solution for fixing garbled Chinese characters and emoji display issues in Python-generated images and charts.
Stock Daily Report Pro
A professional-grade A-share market report generator that produces detailed HTML and image-based technical analysis for personal research.
METADATA
Featured*
