A powerful directory search tool for Feishu that enables AI agents to locate users and departments via fuzzy matching and local caching.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install feishu-contacts
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-contacts 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 Contacts Search?
The Feishu Contacts Search skill provides a robust interface for Openclaw Skills to interact with your organization's Feishu directory. It bridges the gap between AI agents and communication channels by allowing precise identification of users through Chinese names, pinyin, or department affiliations, ensuring that every automated message or email reaches the correct recipient.
By maintaining a local cache and providing real-time API lookups, it offers a high-performance solution for identity resolution within complex corporate structures. This skill is essential for any automation that requires reliable user identification before performing actions like sending messages, emails, or creating tasks.
Feishu Contacts Search Use Cases
- Resolve ambiguous user names to unique Feishu open_ids before sending instant messages.
- Retrieve employee email addresses for automated report distribution or notifications.
- Locate all members within a specific department to facilitate group-wide communications.
- Synchronize organizational structure data locally to minimize API latency during frequent lookups.
How Feishu Contacts Search Works
- Initialize the connection by configuring Feishu application credentials in the global configuration file.
- Perform an initial synchronization to build a local cache of the organizational directory.
- Execute search queries using name, pinyin, or department identifiers to find specific targets.
- Use the retrieved open_id or email to perform downstream actions like messaging or task creation via other Openclaw Skills.
- Regularly sync the cache to ensure new hires and organizational changes are reflected in the search results.
Feishu Contacts Search Setup
First, configure your Feishu application credentials in ~/.openclaw/openclaw.json:
{
"channels": {
"feishu": {
"appId": "cli_xxx",
"appSecret": "xxx"
}
}
}
Ensure the Feishu app has the following permissions: contact:user:read, contact:user:read_v2, and contact:department:read.
Then, install the necessary dependencies and perform the first sync using these bash commands:
pip install pypinyin
python3 ~/.openclaw/skills/feishu-contacts/scripts/feishu-contacts.py sync
Feishu Contacts Search Data Schema & Taxonomy
The skill manages a local JSON cache to ensure high performance while reducing API rate-limit consumption. Data is organized as follows:
| Component | Details |
|---|---|
| Cache Storage | ~/.openclaw/.feishu-contacts-cache.json |
| Data Objects | Users, Departments, and Department-User mappings |
| Searchable Attributes | Chinese names, Pinyin (full), Pinyin (initials), English names |
| Metadata | open_id, email, department_id, and real-time detail lookups |
Feishu Contacts Search Advanced Features
- Fuzzy matching support for homophones and pinyin initials to improve search accuracy in Openclaw Skills.
- Real-time API integration via the get command for fetching the most up-to-date contact details like mobile numbers.
- Local persistence of organizational data for ultra-fast response times during agent reasoning cycles.
- Support for department-level operations, allowing recursive member listing for complex bulk automation workflows.
SKILL.md
Loading
Related Openclaw Skills
Weather
A lightweight skill for retrieving real-time weather data and forecasts directly from the CLI without requiring API keys.
Lobster
A deterministic workflow runtime for AI agents designed to execute typed JSON pipelines with mandatory human approval gates for side effects.
Luban CLI
A comprehensive command-line framework for managing the lifecycle of machine learning experiments, training jobs, and inference services.
Gas Price Alert
An automated monitoring tool that tracks local gas prices and provides daily alerts for the cheapest fuel options including Costco.
SNU Canvas CLI
A specialized command-line bridge for interacting with the SNU Canvas LMS platform securely and efficiently.
What Would Elon Do? (WED)
A high-velocity strategic planning tool that converts any business idea into a first-principles execution roadmap.
Featured*
