A specialized tool for forwarding Feishu thread-level topics to users, groups, or other threads via the Feishu Open API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install feishu-thread-forward
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-thread-forward 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 Thread Forward?
The Feishu Thread Forward skill provides a robust mechanism for AI agents to interact with Feishu topic-based communication. Unlike standard message tools that only handle individual messages, this integration specifically targets the thread level (话题), allowing users to preserve the context and UI structure of a discussion when sharing it across different chats. By utilizing Openclaw Skills, developers can bridge the gap in native tool limitations to provide a more intuitive user experience.
This skill is particularly valuable for organizations that rely on Feishu's topic groups. It allows for the programmatic generation of clickable topic cards that link back to the original discussion, ensuring that all participants stay aligned. Whether you are building an automated notification system or a sophisticated virtual assistant, this skill ensures that thread forwarding is handled with technical precision and reliability.
Feishu Thread Forward Use Cases
- Automatically cross-posting important discussion threads from a private team group to a broader department channel.
- Enabling AI agents to forward specific topic context when a user requests to share a discussion.
- Preserving the clickable topic card format during automated information migration within Feishu.
- Synchronizing thread-level updates across multiple related project groups.
How Feishu Thread Forward Works
- The skill first retrieves the necessary thread ID (prefixed with omt_) from the message metadata or via a GET message API call.
- It authenticates using the tenant access token derived from the credentials stored in the local configuration.
- The skill executes a POST request to the Feishu im/v1/threads/{thread_id}/forward endpoint.
- It specifies the target recipient through a receive_id and defines the ID type (such as chat_id or open_id).
- The API generates a native clickable topic card in the target destination, maintaining the thread's visual and logical context.
Feishu Thread Forward Setup
To deploy this within your environment, ensure your bot has the required im:message or im:message:send_as_bot permissions. The skill reads credentials from /root/.openclaw/openclaw.json. You can manually test the forwarding logic using the provided Python script:
python3 skills/feishu-thread-forward/scripts/forward_thread.py \
--thread-id omt_xxxxx \
--receive-id oc_xxxxx \
--receive-id-type chat_id
Feishu Thread Forward Data Schema & Taxonomy
The skill manages data through specific path and query parameters to ensure accurate delivery. Below is the metadata structure used by these Openclaw Skills:
| Parameter | Description | Required |
|---|---|---|
| thread_id | The unique ID of the thread to forward (Path) | Yes |
| receive_id_type | The format of the destination ID (Query) | Yes |
| receive_id | The target identifier (Body) | Yes |
| uuid | An optional idempotency key to prevent duplicate forwards | No |
Feishu Thread Forward Advanced Features
- Idempotency protection using a UUID to prevent duplicate message delivery within a one-hour window.
- Comprehensive error handling for complex Feishu states, including anti-leak modes and secret group restrictions.
- Support for multiple destination types including open_id, union_id, and email for flexible targeting.
- Automated token management integrated with the broader Openclaw Skills ecosystem for seamless authentication.
SKILL.md
Loading
Related Openclaw Skills
Feishu Message Fetcher
A specialized tool for fetching detailed Feishu message content and full conversation thread history via message IDs.
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.
Polymarket Prediction Markets
A comprehensive CLI tool for querying real-time event probabilities and market data from Polymarket.
Web Search (Free)
A zero-cost neural search and autonomous deep research skill for AI agents that operates without API keys via the Exa MCP.
Featured*
