A comprehensive toolkit for automating image uploads, messaging, and visual analysis within the Feishu (Lark) communication platform.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install feishu-img-msg
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-msg 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 Message Skill?
The Feishu Image Message skill provides a robust set of operations for managing image-based communication in Feishu. It enables developers and AI agents to programmatically interact with Feishu's media APIs to upload local files, send image messages to users or groups, and retrieve images for local storage or AI processing.
By integrating this Openclaw Skills module, you can bridge the gap between automated workflows and visual communication in team environments. The skill handles the complexities of Feishu's authentication and media handling, allowing for seamless integration of charts, screenshots, and visual assets into your chat-based operations.
Feishu Image Message Skill Use Cases
- Automating the delivery of generated reports, charts, or visual dashboards directly to Feishu group chats.
- Enabling AI agents to "see" and analyze images sent within Feishu conversations by converting them to base64 for vision models.
- Programmatically backing up images from specific Feishu conversations to local storage or cloud environments.
- Streamlining asset management by generating and reusing Feishu-specific image_keys across multiple messages.
How Feishu Image Message Skill Works
- The skill authenticates with the Feishu API using bot credentials and handles tenant_access_token refreshes automatically to ensure continuous operation.
- When sending images, the skill either uploads a local file to generate a temporary image_key or utilizes an existing key stored in the system.
- The logic identifies the target chat type based on the prefix of the chat_id (oc_ for groups or ou_ for individuals) to ensure correct message routing.
- For retrieval tasks, it fetches binary data from Feishu servers, which can then be saved as a local file or converted into a base64 string for immediate AI consumption.
Feishu Image Message Skill Setup
To utilize this skill within Openclaw Skills, ensure your Feishu bot has the required permissions: im:resource, im:message, and im:message:send_as_bot.
# Verify the installation and view available commands
python3 ~/.openclaw/workspace/skills/feishu-img-msg/scripts/feishu_image.py --help
# Configure your Feishu credentials in your environment settings before use.
Feishu Image Message Skill Data Schema & Taxonomy
The skill organizes its operations around the following data structures and parameters:
| Parameter | Type | Description |
|---|---|---|
image_key |
String | The unique identifier for the image hosted on Feishu servers. |
chat_id |
String | Destination identifier (oc_ for groups, ou_ for users). |
chat_type |
String | Type of chat: group or user. |
file_path |
String | Local path to the image file (JPG, PNG, GIF, BMP, WebP). |
base64 |
String | Encoded image data returned for AI viewing. |
Feishu Image Message Skill Advanced Features
- Multi-format support including WebP and GIF for rich media communication within team channels.
- AI-optimized "view" mode that extracts base64 data, enabling multimodal LLMs to interpret Feishu images directly.
- Intelligent error handling for token expiration (error codes 99991400/99991401) with automated retry logic.
- Support for large file handling with a maximum single image size limit of 30MB.
- Account aliasing to manage multiple Feishu bot configurations (defaulting to "main").
SKILL.md
Loading
Related Openclaw Skills
Feishu FAQ Bot
A high-performance FAQ management tool for Feishu bots that builds searchable knowledge bases from Markdown files using fuzzy matching.
tmux-terminal
A powerful terminal automation skill that leverages tmux to drive interactive TUI applications and manage persistent background processes.
Test-Driven Development (TDD)
A unified TDD skill that enforces test-first development through automated spec parsing, pattern discovery, and the RED-GREEN-REFACTOR cycle.
MCP Builder
A comprehensive framework for architecting robust Model Context Protocol servers that enable AI agents to interact seamlessly with external APIs and services.
Agent Communication Hub
A high-performance communication layer providing direct messaging, pub/sub events, and persistent storage for autonomous agent interactions.
Agent Memory Persistence
A robust SQLite-backed storage system for AI agents that provides long-term memory, metadata management, and semantic retrieval.
Featured*
