A specialized utility to programmatically retrieve and parse sub-messages within Feishu's merged and forwarded message format.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install feishu-merged-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-merged-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 Merged Message Fetcher?
The Feishu Merged Message Fetcher is a critical utility for agents operating in the Feishu/Lark ecosystem. Standard API responses for merged messages often return a generic "Merged and Forwarded Message" placeholder without exposing the underlying content. This Openclaw Skills extension addresses this limitation by interfacing with the Feishu REST API to fetch the full message hierarchy.
By retrieving the individual sub-messages nested within a forwarded thread, the skill allows AI agents to maintain full context, identify individual contributors, and process complex historical conversations. This is essential for workflows that involve summarizing long discussions or acting on requests contained within shared message blocks.
Feishu Merged Message Fetcher Use Cases
- The inbound message body displays only "Merged and Forwarded Message" text.
- The system identifies a
msg_typeofmerge_forwardrequiring deep inspection. - Users ask for a summary or analysis of a forwarded conversation thread they have shared.
- An agent needs to extract specific data points or action items from a multi-message archive.
How Feishu Merged Message Fetcher Works
- Extract the
message_idof the parent merged message from the current message context or metadata. - Locate the necessary Feishu API credentials (appId and appSecret) from the local OpenClaw configuration.
- Execute the fetch script to query the Feishu
GET /open-apis/im/v1/messages/{message_id}endpoint. - Receive the JSON response containing the parent message and an array of all sub-messages.
- Map internal placeholders such as mentions and sender IDs to human-readable names.
- Process the chronological list of sub-messages to generate a summary or response for the user.
Feishu Merged Message Fetcher Setup
Ensure your environment is configured with the correct Feishu App credentials and permissions. The Feishu App requires the im:message:readonly scope.
To verify or extract credentials from your configuration, you can use:
python3 -c "import json; d=json.load(open('/root/.openclaw/openclaw.json')); c=d['channels']['feishu']; print(c.get('appId',''), c.get('appSecret',''))"
Run the fetch script manually if needed:
bash <skill_dir>/scripts/fetch_merged_msg.sh <message_id> <app_id> <app_secret>
Feishu Merged Message Fetcher Data Schema & Taxonomy
The skill processes the hierarchical JSON response from the Feishu API. The data is structured as follows:
| Attribute | Description |
|---|---|
data.items[0] |
Represents the parent container (the merge_forward message). |
data.items[1:] |
Chronological list of all sub-messages contained in the merge. |
body.content |
The raw text or post content of the specific sub-message. |
mentions[] |
Metadata mapping user IDs (e.g., @_user_1) to real-world names. |
sender.id |
Identification of the original sender for each nested message. |
Feishu Merged Message Fetcher Advanced Features
- Multi-agent compatibility for collaborative thread analysis.
- Automated mention resolution to ensure accurate attribution within Openclaw Skills summaries.
- Support for extracting message IDs from replied-to metadata as well as direct context.
- Contextual awareness for sub-messages originating from different chat environments.
SKILL.md
Loading
Related Openclaw Skills
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 Bitable Query
High-performance server-side querying and filtering for Feishu Bitable records with multiple output formats.
Feishu Message Fetcher
A specialized tool for fetching detailed Feishu message content and full conversation thread history via message IDs.
Feishu Thread Forward
A specialized tool for forwarding Feishu thread-level topics to users, groups, or other threads via the Feishu Open API.
Featured*
