feishu-forward-reader

What This Skill Does

The feishu-forward-reader skill serves as a vital bridge between OpenClaw AI and the Feishu (Lark) ecosystem. By default, OpenClaw interprets Feishu's "Merged and Forwarded Message" format as a opaque container, rendering the actual content unreadable. This skill effectively intercepts these specific message types, queries the Feishu open API, and recursively parses the payload. It extracts original text, rich text (post), and interactive card content while mapping sender IDs to human-readable names. By flattening these structures, the skill allows the OpenClaw agent to process, summarize, or act upon sub-messages trapped within forwarded stacks.

Installation

To install this skill, use the ClawHub command line interface. Ensure you have your OpenClaw environment initialized and that your Feishu application is configured with the necessary scopes:

clawhub install openclaw/skills/skills/konce/feishu-forward-reader

After installation, the skill automatically detects your existing ~/.openclaw/openclaw.json configuration. If you prefer to run it manually or for troubleshooting, you can utilize the provided Python scripts in the scripts/ directory to verify credential connectivity using your App ID and App Secret.

Use Cases

1. Automated Meeting Minutes: When a user forwards a long discussion thread to the OpenClaw agent, this skill parses the entire chain so the AI can generate a summary of the decisions made.
2. Knowledge Base Extraction: Efficiently extract project details or task requirements forwarded from different departments into a centralized project channel.
3. Historical Data Retrieval: Use the agent to analyze historical context that was previously bundled into forwarded messages, ensuring the AI has the full history required for accurate follow-up.

Example Prompts

1. "OpenClaw, please parse the forwarded message with ID om_12345 and tell me the main action items requested by the user."
2. "Look at the last forwarded message in this chat and summarize the three key points discussed by the team members."
3. "Read the content of the forwarded message om_98765 and add the tasks mentioned to my project management board."

Tips & Limitations

• Permissions: This skill requires im:message:readonly to access the chat logs. Ensure your Feishu app has these scopes granted and the bot is added to the relevant chat groups.
• Rate Limiting: Frequent API calls to the Feishu platform may hit rate limits; if you are processing large volumes of forwarded messages, consider adding a sleep delay in your execution script.
• Media Content: Note that binary attachments like files, audio, and video are represented as placeholders; this skill is optimized for text, post, and interactive card content processing.
• Data Privacy: Because this tool reads internal chat content via API, ensure that your OpenClaw instance is secured and that sensitive data is handled in accordance with your organization's compliance policies.