openclaw-feishu-group-chat

What This Skill Does

The openclaw-feishu-group-chat skill empowers your OpenClaw agent to function as a professional and context-aware participant within Feishu (Lark) environments. It bridges the gap between raw API metadata and human-centric interaction by providing a robust identification system, behavioral guidelines for group versus DM interactions, and strict adherence to Feishu's unique formatting requirements. By maintaining a synchronized contact map in your workspace, the agent ensures it always knows who it is interacting with, even when Feishu metadata provides only opaque identifiers.

Installation

To integrate this skill, ensure you have the OpenClaw CLI installed and run the following command in your terminal: clawhub install openclaw/skills/skills/4ier/openclaw-feishu-group-chat

Once installed, you must perform the initial contact sync to map user IDs to names using the provided script: python3 scripts/sync_feishu_contacts.py <config> <account> ~/workspace/USER.md

Finally, update your AGENTS.md or SOUL.md with the behavioral guidelines provided in the documentation to ensure the agent understands the distinction between group etiquette and private DM protocol.

Use Cases

• Corporate Operations: Automate status reporting and Q&A in project-based Feishu groups.
• Support Desk: Provide personalized assistance in DMs while maintaining strictly segmented privacy between users.
• Team Coordination: Enable the agent to chime in only when relevant to maintain high signal-to-noise ratios in busy communication channels.

Example Prompts

1. "Check the current project status and summarize it for the team in the #dev-ops group, but keep it brief and avoid using markdown formatting."
2. "A user messaged me privately about sensitive credentials; ensure you handle this with high privacy and do not disclose this conversation to other team members."
3. "If you see an @mention from Alice in the general channel, check if we have an update on the pending task and reply concisely."

Tips & Limitations

• Syncing: Because Feishu open_id values are app-specific, always sync contacts using the credentials of the specific app instance the agent is using.
• Formatting: Feishu does not support standard Markdown well. Always favor plain text, line breaks, and simple lists to ensure readability on both mobile and desktop clients.
• Privacy: Regularly audit your SOUL.md to ensure the agent's identity and privacy constraints are properly reinforced during long-running sessions.
• Performance: Always restart the gateway after updating your USER.md to ensure the new contact mapping is loaded into memory.