A specialized tool for fetching detailed Feishu message content and full conversation thread history via message IDs.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install feishu-msg-reader
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-msg-reader 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 Message Fetcher?
The Feishu Message Fetcher is a robust integration designed for Openclaw Skills that allows developers and AI agents to programmatically access Feishu communication data. By leveraging the Feishu IM API, this skill can retrieve message bodies across various formats, including text, posts, images, and merged forwards. It is particularly effective at overcoming platform limitations related to interactive cards by providing comprehensive thread context retrieval.
This utility ensures that AI agents have the necessary background information to process user requests accurately within team environments. By integrating this into your Openclaw Skills workflow, you can automate the extraction of chat data while maintaining a high level of security through standardized authentication methods.
Feishu Message Fetcher Use Cases
- Extracting precise message content when an AI agent only possesses a message_id.
- Resolving the actual intent behind [Interactive Card] placeholders by analyzing surrounding thread context.
- Automating the collection of chronological chat history for documentation or summary purposes.
- Empowering agents to follow complex conversation branches within Feishu groups.
How Feishu Message Fetcher Works
- The agent identifies a target message_id from inbound metadata or user input.
- The Openclaw Skills module authenticates with Feishu using credentials stored in the local config or environment variables.
- The skill invokes the Feishu GET message API to pull the specific message payload.
- If the thread flag is enabled, the tool performs additional lookups to aggregate all messages sharing the same root_id, sorted chronologically.
- The fetched data is parsed and returned as a structured JSON object for immediate use by the agent.
Feishu Message Fetcher Setup
To use this within the Openclaw Skills framework, ensure your credentials are set up in your local configuration file.
# The skill automatically reads appId and appSecret from:
# ~/.openclaw/openclaw.json
# Alternatively, set environment variables:
export FEISHU_APP_ID='your_app_id'
export FEISHU_APP_SECRET='your_app_secret'
# Basic usage to fetch a message
python3 scripts/fetch_message.py <message_id>
Feishu Message Fetcher Data Schema & Taxonomy
The skill returns a structured JSON object containing the following primary fields:
| Field | Description |
|---|---|
| message_id | Unique identifier for the retrieved message. |
| msg_type | The format of the message (text, post, image, etc.). |
| content | The parsed message body content. |
| chat_id | The ID of the chat where the message originated. |
| thread | An array containing the full conversation context (when requested). |
| thread_count | Total number of messages in the returned thread. |
Feishu Message Fetcher Advanced Features
- Multi-mode retrieval: Support for single message, full thread context, or raw API response modes.
- Automatic Fallback: Intelligent handling of interactive cards by providing thread context as a workaround for platform API limitations.
- Flexible Authentication: Support for config files, environment variables, or direct tenant_access_token passing.
- Chronological Sorting: Ensures thread context is returned in the exact order of communication for better AI reasoning within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Feishu Merged Message Fetcher
A specialized utility to programmatically retrieve and parse sub-messages within Feishu's merged and forwarded message format.
Feishu Markdown to Blocks
A specialized tool for converting Markdown content into Feishu block structures and inserting them into existing documents with precise positioning.
Feishu Document Sync
A high-performance synchronization tool for managing Feishu documents, spreadsheets, and complex block structures via Markdown.
Feishu Block Operations
Advanced low-level block management for Feishu cloud documents via direct REST API integration.
Feishu Thread Forward
A specialized tool for forwarding Feishu thread-level topics to users, groups, or other threads via the Feishu Open API.
Polymarket Prediction Markets
A comprehensive CLI tool for querying real-time event probabilities and market data from Polymarket.
Featured*
