飞书通讯录搜索

飞书通讯录本地缓存搜索。支持中文名、拼音、拼音首字母、英文名模糊匹配。

设置（仅首次使用）

确保 ~/.openclaw/openclaw.json 中已配置飞书应用凭据：

json
{
channels: {
feishu: {
appId: cli_xxx,
appSecret: xxx
}
}
}

飞书应用需要以下权限：

• - contact:user:read — 读取用户信息
• contact:user:read_v2 — 读取用户详细信息
• contact:department:read — 读取部门信息

安装后首次使用前，执行同步：

bash
python3 ~/.openclaw/skills/feishu-contacts/scripts/feishu-contacts.py sync

脚本位置

~/.openclaw/skills/feishu-contacts/scripts/feishu-contacts.py

命令

同步通讯录（定期执行，新入职的人需要 sync 才能搜到）

bash
python3 ~/.openclaw/skills/feishu-contacts/scripts/feishu-contacts.py sync

搜索用户

bash
python3 ~/.openclaw/skills/feishu-contacts/scripts/feishu-contacts.py search <人名>

支持：中文名、拼音（zhangsan）、拼音首字母（zs）、英文名、同音字模糊匹配。

搜索部门

bash
python3 ~/.openclaw/skills/feishu-contacts/scripts/feishu-contacts.py search-dept <部门名>

列出部门所有成员

bash
python3 ~/.openclaw/skills/feishu-contacts/scripts/feishu-contacts.py list-dept

获取用户详情（实时 API 调用）

bash
python3 ~/.openclaw/skills/feishu-contacts/scripts/feishu-contacts.py get

查看缓存信息

bash
python3 ~/.openclaw/skills/feishu-contacts/scripts/feishu-contacts.py info

关键：人员定位规则

任何涉及给某人做某事的操作（发消息、发邮件、创建任务等），必须先通过本工具定位到具体的人。

强制流程

如果 目标是人名：
1. 执行：search <姓名>
2. 获取：openid（飞书消息）/ email（邮件，需 get id>）
3. 结果唯一 → 直接使用
4. 结果多个 → 列出候选让用户选择
5. 结果为空 → 报告找不到，让用户提供更多信息