feishu-interactive-card

What This Skill Does

The feishu-interactive-card skill acts as a specialized data retrieval bridge for Feishu messaging environments. When OpenClaw encounters an [Interactive Card] message, standard API behavior often masks the true content as degraded text. This skill circumvents those readability issues by interacting directly with the Feishu IM API to pull the message payload. Beyond simple retrieval, it provides a powerful threading feature that aggregates the entire conversation context. By fetching the root message and subsequent replies, the skill reconstructs the intent behind interactive components, ensuring the AI can interpret user requests accurately even when they rely on rich UI elements.

Installation

To install this skill, use the OpenClaw CLI tool from your terminal. Ensure you have the necessary environment permissions to access the plugin registry.

clawhub install openclaw/skills/skills/deadblue22/feishu-interactive-card

Once installed, the tool will automatically attempt to locate your credentials in ~/.openclaw/openclaw.json. If your credentials are not stored there, you may manually configure them using the FEISHU_APP_ID and FEISHU_APP_SECRET environment variables.

Use Cases

• Deep Contextual Analysis: When a user replies to an interactive card with a follow-up question, use this skill to fetch the parent context to understand what information was displayed on that card.
• Automation Debugging: Retrieve raw message metadata, including sender_id, chat_id, and create_time, to troubleshoot automation triggers.
• Knowledge Retrieval: Efficiently extract text content from complex posts or merge-forward messages within a Feishu thread to perform summarization tasks.

Example Prompts

1. "I see an interactive card here, but it's empty. Please fetch the message with ID 'msg_12345' and tell me what the user is actually asking."
2. "Get the full thread context for message 'msg_98765' so I can understand the context of this support request."
3. "Fetch the content of the latest message in this channel using the current message ID and summarize the entire conversation thread for me."

Tips & Limitations

• Interactive Card Limitation: Because the Feishu API does not return the full JSON structure of interactive cards, always utilize the --thread flag. The card content is usually preceded by a text or post message in the same thread that provides the necessary semantic context.
• Auth Handling: For security, avoid hardcoding tokens in scripts. Use the ~/.openclaw/openclaw.json path for persistent credential management.
• API Usage: Ensure your Feishu App has the necessary IM permissions (im:message:readonly) enabled in the Feishu Developer Console to allow the skill to fetch message contents.