feishu-contacts

What This Skill Does

The feishu-contacts skill provides a robust mechanism for mapping Feishu (Lark) open_id identifiers to human-readable names. By synchronizing your organization's contact list into your USER.md workspace file, the OpenClaw agent gains the ability to identify who is sending a direct message without requiring expensive or slow external tool calls. Since Feishu’s API architecture for DMs strips away sender names, this skill embeds a lookup table directly into your agent's system prompt context at runtime, enabling zero-latency identification of inbound messages.

Installation

1. Ensure your Feishu/Lark app has the required contact:user.employee_id:readonly or contact:user.base:readonly permissions enabled in the Feishu Developer Console.
2. Install the skill via terminal: clawhub install openclaw/skills/skills/4ier/feishu-contacts-sync.
3. Run the provided Python script: python3 scripts/sync_feishu_contacts.py <config_path> <account_name> <user_md_path>.
4. Initialize the contact table in USER.md using the required markdown header and table format provided in the documentation.
5. Update your AGENTS.md startup instructions to enforce the lookup logic for DM metadata.

Use Cases

• Multi-user environments: Distinguish between team members messaging the agent simultaneously.
• Access Control: Tailor agent responses based on the specific seniority or role of the sender found in the contact list.
• HR Synchronization: Automate the update of contact lists after team restructuring to ensure the agent is always aware of new employees.
• Professionalism: Addressing team members by their names rather than anonymous IDs in logs and message history.

Example Prompts

• "Can you check if the message I just received in the private channel is from Alice or Bob?"
• "Please list all team members currently active in our Feishu workspace based on the synced contacts."
• "When I get a message from 'ou_abc123', how should you greet them according to my USER.md configuration?"

Tips & Limitations

• App Scoping: Remember that open_id values are unique to specific Feishu apps. If you switch apps, you must re-sync the contacts.
• Refresh Cycle: The agent loads USER.md at startup. After running the sync script, you must restart your gateway for the agent to recognize the updated contacts.
• Automation: Configure a weekly crontab to ensure your contact mapping remains current without manual intervention.
• Privacy: The skill stores names locally in your USER.md file; ensure your workspace security practices are followed.