A specialized tool for Openclaw Skills that automatically extracts and parses structured JSON data from interactive message cards on enterprise platforms.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install interactive-card-reader
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 interactive-card-reader 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 Interactive Card Reader?
The Interactive Card Reader is a developer-centric extension designed for Openclaw Skills to bridge the gap between AI agents and rich message formats. It enables agents to natively understand interactive cards, message cards, and form cards from platforms like Feishu, QQ, and Enterprise WeChat by accessing their raw JSON structures via official APIs.
By moving beyond simple text scraping or OCR, this skill provides AI agents with high-fidelity access to UI elements, button values, and hidden metadata within chat interfaces. This ensures that your automation workflows within Openclaw Skills are powered by accurate, structured data rather than unreliable text approximations.
Interactive Card Reader Use Cases
- Extracting form data from Feishu interactive cards for automated database entry.
- Analyzing the structure of enterprise notification cards to trigger conditional AI responses.
- Enabling AI agents to interpret UI components like buttons and dropdowns within a chat message.
- Automating the collection of metadata from complex multi-element message cards.
How Interactive Card Reader Works
- The skill monitors incoming messages or specific triggers to detect a message ID or card reference.
- It initiates an authentication handshake using platform-specific credentials to obtain access tokens.
- The script calls the respective platform API, such as the Feishu IM service, to retrieve the full message body.
- Raw JSON content is processed to isolate the interactive card structure from metadata.
- The card content is parsed into a flattened, AI-friendly format that highlights key-value pairs and UI elements.
- The structured data is returned to the AI agent within the Openclaw Skills framework for further action.
Interactive Card Reader Setup
To integrate this into your environment, follow these steps:
# Install the skill from the hub
clawhub install interactive-card-reader
# Or install from local source
cd ~/.openclaw/workspace/skills/interactive-card-reader
bash install.sh
Configure your platform credentials in config/feishu-config.json with your app_id and app_secret to enable API access.
Interactive Card Reader Data Schema & Taxonomy
The skill manages configuration and temporary data through a structured file system:
| Component | File Path | Details |
|---|---|---|
| Platform Config | config/platform-config.json |
Toggles for Feishu, QQ, and WeChat support. |
| Feishu Config | config/feishu-config.json |
Stores API keys and token caching logic. |
| Token Cache | data/token-cache.json |
Stores active bearer tokens and expiration timestamps. |
| Parsed Output | Standard JSON | Returns msg_type, title, and an array of elements. |
Interactive Card Reader Advanced Features
- Intelligent Token Lifecycle Management with automatic refresh every 7000 seconds.
- Silent Execution Mode to prevent AI output clutter when no cards are detected.
- Platform Priority Routing to handle messages across multiple enterprise channels.
- Native JSON output optimized for Large Language Model context windows within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Image Content Extractor
A smart OCR tool that automatically detects image types and extracts structured content into high-quality Markdown format.
Context Manager
An intelligent context management skill that automates session transitions through background monitoring and seamless memory persistence.
ClawBox Link to Docs
Converts web URLs into two distinct Feishu documents: a high-fidelity source archive and a structured analysis brief.
mol-render
A powerful tool for generating ray-traced 3D ball-and-stick molecular models from SMILES strings or PDB structures.
Context Manager
An intelligent context management skill that automates session switching and memory persistence to ensure uninterrupted AI agent workflows.
Playwright Scraper
A high-performance browser automation tool for scraping complex, JavaScript-heavy websites using real browser interactions.
Featured*
