feishu-contacts
Search Feishu contacts by name/pinyin/department. Use when you need to find a person's open_id, email, or department info before sending messages or emails.
Why use this skill?
Efficiently search, locate, and retrieve Feishu contact details and department information for seamless AI-driven communication and task automation.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/guyun94/feishu-contactsWhat This Skill Does
The feishu-contacts skill serves as a powerful interface between your OpenClaw agent and the Feishu (Lark) corporate directory. By maintaining a local, searchable cache of your organization's user and department data, it enables the agent to accurately identify, locate, and retrieve detailed metadata for colleagues. Whether you need to find an open_id for instant messaging, pull an email address for a calendar invite, or aggregate contact information for an entire department, this tool acts as the primary resolution layer for any task involving organizational communication.
Installation
To begin, ensure your Feishu application is configured in ~/.openclaw/openclaw.json with the appId and appSecret. Your application requires contact:user:read, contact:user:read_v2, and contact:department:read permissions. Install the skill using: clawhub install openclaw/skills/skills/guyun94/feishu-contacts. After installation, run the synchronization script once to populate your local database: python3 ~/.openclaw/skills/feishu-contacts/scripts/feishu-contacts.py sync. Repeat this sync command whenever new employees join or department structures change.
Use Cases
This skill is indispensable for automating corporate workflows. Use it to map natural language names (e.g., "Zhang San") to unique machine identifiers (open_id) required for automated messaging. It is also critical for bulk communications, such as identifying all members of a specific department and retrieving their specific email addresses to facilitate internal communications. The tool is essential for tasks requiring absolute accuracy, preventing the agent from making errors based on ambiguity or outdated memory.
Example Prompts
- "Find the Feishu ID for Li Ming from the engineering department so I can send him the updated project specs."
- "Get the email addresses for everyone in the Product department and draft a summary email for our meeting."
- "Search for all users matching 'Wang' and list their contact info so I can coordinate the team lunch."
Tips & Limitations
Always prioritize using search before taking any action. If the search returns multiple candidates, ask the user to clarify. Remember that the local cache is only as good as your last sync command; if someone is missing, always run sync first. While search is fast and locally cached, use the get command when you need the most up-to-date, real-time API data, such as a user's current phone number or updated email address. Never guess or hallucinate user identifiers, as this will lead to failed message delivery.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-guyun94-feishu-contacts": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-read, file-write, external-api, code-execution