A comprehensive skill to transform your AI agent into a professional, context-aware Feishu group participant and DM responder.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install feishu-group
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-group 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 Group Integration?
The Feishu Group skill is designed to bridge the gap between AI agents and the unique architecture of the Feishu (Lark) communication platform. While standard integrations often struggle with identifying users in direct messages or formatting content for Feishu's specific UI, this skill provides a robust framework for identity resolution and social etiquette. By leveraging this addition to your Openclaw Skills library, you can ensure your agent recognizes who it is talking to, respects workspace privacy, and maintains a professional presence in both high-traffic group chats and private one-on-one threads.
At its core, this skill solves the challenge of the opaque open_id used by Feishu. It provides scripts to sync organizational contacts into a local lookup table, allowing the agent to address users by name instantly. Furthermore, it embeds specific behavioral guidelines into the agent's soul, preventing common pitfalls like conversation monopolization or markdown rendering errors that can clutter the Feishu interface.
Feishu Group Integration Use Cases
- Resolving anonymous open_id strings into real names during Feishu DM interactions.
- Managing agent participation in large group chats to prevent noise and ensure relevant contributions.
- Maintaining strict multi-user privacy by isolating conversation contexts between different team members.
- Enforcing platform-specific formatting rules to ensure agent responses look clean and readable in the Feishu client.
How Feishu Group Integration Works
- The included Python sync script connects to your Feishu App and retrieves the organization's contact list.
- User mappings (name to open_id) are written to the USER.md workspace file, which acts as a locally cached directory.
- Openclaw Skills inject the contents of USER.md into the system prompt at startup, providing the agent with an immediate lookup table.
- When a message arrives via the gateway, the agent extracts the chat_id or open_id from the inbound metadata.
- The agent matches the ID against the lookup table to identify the sender and applies specific group or DM etiquette rules based on the context.
- Before sending a response, the agent filters its output to comply with Feishu's formatting constraints, such as avoiding complex markdown tables.
Feishu Group Integration Setup
First, run the bundled sync script to populate your user directory. You will need your OpenClaw configuration and Feishu account details:
python3 scripts/sync_feishu_contacts.py <openclaw_config> <feishu_account> <user_md_path>
To keep the directory updated, it is recommended to set up a weekly auto-sync via crontab:
0 7 * * 1 python3 /path/to/scripts/sync_feishu_contacts.py ~/.openclaw/openclaw.json my_app ~/workspace/USER.md
Finally, ensure you restart the gateway after updating USER.md, as workspace files are cached at startup.
Feishu Group Integration Data Schema & Taxonomy
The skill primarily manages data within the USER.md file using a specific Markdown table structure for high-speed context injection:
| Field | Description |
|---|---|
| Name | The display name of the Feishu user. |
| open_id | The app-specific unique identifier (e.g., ou_xxx). |
Metadata Usage:
- Inbound Metadata: Extracts
chat_idandsenderinfo. - OpenID Logic: IDs are treated as per-app identifiers to support multi-instance Openclaw Skills deployments.
Feishu Group Integration Advanced Features
- Automated contact synchronization via cron integration.
- Multi-app support for organizations running multiple agent instances.
- Context-aware silencing logic to prevent agents from responding to casual banter or redundant messages.
- Platform-optimized formatting engine that automatically converts markdown into Feishu-friendly plain text and lists.
- Strict data isolation protocols to prevent information leakage between different users in a shared workspace.
SKILL.md
Loading
Related Openclaw Skills
Feishu Contacts Sync
Automatically synchronizes Feishu (Lark) contact names and their corresponding open_ids into your agent's context to enable accurate sender identification in direct messages.
Developer Agent
An end-to-end development orchestrator that manages git lifecycles, build checks, and AI-driven implementation for high-quality software delivery.
Skill Operator (PassDeck)
A high-performance orchestration engine for collaborative AI agent sessions using CRDT-based persistence and cryptographic verification.
DingTalk Report List API Integration
A professional integration for programmatically retrieving and filtering employee reports and work logs from the DingTalk platform.
Feishu Group Chat & Multi-User Support
A technical framework for OpenClaw agents to intelligently participate in Feishu group chats while maintaining user privacy and platform-specific formatting.
ClawAudit
ClawAudit is a static security analyzer that scans agent skill files for vulnerabilities, prompt injections, and unauthorized data exfiltration patterns.
Featured*
