飞书通讯录工具是一款专为高效查找企业内部人员信息而设计的命令行应用。它通过本地缓存机制，支持对飞书组织架构中的用户和部门进行快速检索，极大提升了日常沟通与协作的效率。该工具的核心价值在于将原本需要多次点击或依赖记忆的人员信息（如open_id、邮箱、手机号等）集中到一个可搜索的数据库中，让开发者或运营人员在发送消息、分配任务或批量通知时能够精准定位目标对象。首次使用需配置飞书应用的API凭据，并执行一次同步操作以拉取完整的通讯录数据。此后，所有查询均基于本地缓存，响应迅速且无需重复登录。 工具的运行环境为Python 3，脚本位于`~/.openclaw/skills/feishu-contacts/scripts/`目录下。其主要功能包括按姓名、拼音、拼音首字母、英文名甚至同音字模糊匹配用户，以及根据部门名称查找部门ID并列出该部门所有成员。对于需要获取最新详细信息的场景（例如邮箱地址），可通过`get`命令实时调用飞书API获取，确保信息的时效性。此外，缓存文件采用JSON格式存储于`~/.openclaw/.feishu-contacts-cache.json`，即使系统重启也不会丢失数据，但建议定期执行`sync`命令以保持数据更新，尤其是新入职员工上线后必须同步才能被搜索到。
核心功能特点
- 支持中文名、拼音、拼音首字母、英文名及同音字模糊匹配搜索用户
- 提供部门级搜索与成员列表导出功能，便于批量操作
- 本地缓存+实时API结合，兼顾效率与信息准确性
- 缓存持久化存储，跨会话保持数据一致
- 强制流程规范，避免人工猜测open_id或邮箱
适用场景
飞书通讯录工具最适合在涉及人员定向操作的场景中发挥关键作用。例如，当用户需要给某位同事发送飞书私聊消息时，传统方式可能因记不住对方open_id而反复询问或误发他人。使用该工具，只需输入‘search 张三’即可快速获得其open_id，随后直接调用飞书接口完成消息推送。类似地，在组织会议通知或项目启动邮件群发时，若目标是某个部门全体成员，可先通过‘search-dept 产品部’获取部门ID，再用‘list-dept ’导出全部成员，最后逐一获取邮箱地址进行批量发送。这种标准化流程不仅避免了信息错漏，也减少了沟通成本。 尤其适用于高频次、多线程协作的团队环境。无论是技术团队内部的任务分派、HR部门的入职引导通知，还是市场活动的全员动员，只要涉及‘找人’这一前置动作，本工具都能显著提升执行精度与响应速度。同时，其严格的命令执行规范（如必须先搜索再操作）有效防止了因记忆偏差导致的错误指派，保障了企业通讯的安全性与可靠性。对于需要自动化脚本集成的工作流而言，该工具更是不可或缺的一环，可作为其他业务系统的‘人员解析模块’，统一处理所有与人相关的寻址需求。