A sophisticated toolset for sending and managing interactive UI elements like buttons, polls, and forms within Feishu (Lark) messages.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install feishu-interactive-cards
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-interactive-cards 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 Interactive Cards?
The Feishu Interactive Cards skill is designed to transform how AI agents communicate by replacing ambiguous text responses with structured, interactive UI components. Built for the Openclaw Skills ecosystem, it allows developers to send rich cards that include buttons, multi-select menus, and input fields, enabling users to make decisions or provide data with a single click.
At its core, this skill prioritizes clarity and speed. By utilizing interactive cards, agents can ensure that destructive actions are confirmed, tasks are tracked visually, and complex inputs are collected without the friction of natural language processing errors. It includes a robust long-polling callback server, meaning you can handle user interactions in real-time without needing a public IP or complex webhook setup.
Feishu Interactive Cards Use Cases
- Requesting user confirmation before performing sensitive or destructive file operations.
- Creating dynamic todo lists where users can check off completed tasks directly in the chat.
- Deploying quick polls or surveys to gather team feedback on specific topics.
- Building structured data entry forms to collect parameters for automated scripts.
- Providing clear choice menus when an AI agent faces uncertainty in a user request.
How Feishu Interactive Cards Works
- The AI agent determines that a user interaction is required and triggers the send-card script with specific parameters.
- An interactive JSON-based card is dispatched to the Feishu platform and displayed to the target user or group.
- The user interacts with the card (e.g., clicks a button or submits a form), which triggers a callback event on Feishu's servers.
- The local callback server, connected via long-polling, receives the interaction data and forwards it to the Openclaw Gateway.
- The agent receives the structured response, processes the logic, and optionally updates the existing card to show the final result or next steps.
Feishu Interactive Cards Setup
First, ensure your credentials are configured in your global configuration file. Then, start the long-polling callback server to listen for user interactions:
cd workspace/skills/feishu-interactive-cards/scripts
node card-callback-server.js
You can then send cards using the provided CLI tool. For example, to send a confirmation card:
node scripts/send-card.js confirmation "Do you want to proceed?" --chat-id YOUR_CHAT_ID
Feishu Interactive Cards Data Schema & Taxonomy
The skill organizes data through structured JSON templates and callback payloads:
| Component | Type | Description |
|---|---|---|
| Card Templates | JSON | Found in the examples/ directory; defines the layout of confirmation, poll, and form cards. |
| Action Value | Object | Hidden metadata within buttons used to pass state (like file paths or IDs) back to the agent. |
| Callback Context | Object | Contains the open_message_id required for updating a card after a user interaction. |
| Gateway Payload | JSON | The formatted event data sent from the callback server to the AI agent for processing. |
Feishu Interactive Cards Advanced Features
- Support for long-polling connectivity, allowing interaction handling behind firewalls or on local machines.
- Real-time card updating capabilities to reflect changing states (e.g., turning a 'Submit' button into a 'Loading' state).
- Automatic event deduplication within a 3-second window to prevent multiple executions from rapid clicking.
- Custom JSON template support for creating highly specialized UI layouts beyond the provided examples.
- Secure integration with Openclaw Skills gateway for centralized event management and multi-agent coordination.
SKILL.md
Loading
Related Openclaw Skills
Wishfinity
A universal save-for-later skill that allows AI agents to organize product discoveries into a centralized, shareable wishlist.
add-wish
A universal product-saving skill that converts any retailer URL into a one-click wishlist link for AI agents.
Spoticlaw
A lightweight Python-based Spotify Web API client designed for AI agents to manage music playback, search, and playlists.
Deep Research
An autonomous multi-model research system that orchestrates four parallel AI agents to generate framework-driven, cross-validated technical reports.
DMM Ranking Lite
A lightweight browser automation tool for Openclaw Skills to extract and translate DMM/FANZA public rankings without needing API credentials.
Code Patent Scanner
A specialized technical analysis tool that scans repositories to identify, score, and document distinctive code patterns for intellectual property preparation.
Featured*
