什么是Feishu Contacts Sync
飞书联系人同步工具（Feishu Contacts Sync）是一个专为 OpenClaw 框架设计的自动化脚本，旨在解决飞书（Lark）私信消息中缺乏发送者姓名的核心问题。由于飞书在私信场景下仅提供 `open_id` 而不暴露用户真实姓名，导致 AI 代理无法准确识别消息来源，从而可能错误地将所有私聊默认为当前用户或完全无法处理。该工具通过在本地生成并维护一个包含姓名与 `open_id` 映射关系的联系人表格，并将其嵌入到系统提示文件 USER.md 中，使代理能够在无需调用额外 API 的情况下，直接通过 inbound metadata 中的 `chat_id`（格式为 `user:ou_xxx`）快速匹配出实际发送者身份。这一机制确保了即使在多用户协作环境中，AI 也能精准区分不同用户的私聊请求，避免身份误判带来的沟通混乱。
核心功能特点
- 自动从飞书应用拉取完整通讯录，生成包含姓名与 open_id 的本地映射表
- 将联系人数据直接写入 USER.md 文件，实现零工具调用的实时身份识别
- 支持按应用维度管理多个飞书账号的联系人，适应多租户环境需求
- 提供定时同步功能，确保联系人信息随组织架构变动保持最新状态
- 严格遵循最小权限原则，仅采集必要字段且不泄露任何敏感个人信息
适用场景
该工具主要适用于需要建立稳定飞书身份识别体系的 AI 代理部署场景。例如，当你在 OpenClaw 框架中配置了飞书作为主要通讯渠道，并希望让 AI 助手能够智能响应来自团队成员的私聊请求时，此工具将成为关键支撑组件。它特别适合那些存在多人共用同一工作空间、且需明确区分主次用户角色的组织结构——比如企业客服系统中，AI 必须能判断是来自客户还是内部同事的消息；或者在团队协作平台里，避免因混淆发信人而引发操作失误。此外，对于定期更新组织架构的企业而言，结合 cron 任务设置每周自动同步，可显著降低人工维护成本，保证通讯录始终反映当前真实成员构成。值得注意的是，由于 open_id 具有应用隔离特性，若同时使用飞书桌面端与企业微信等不同客户端，则需分别为各应用单独执行同步流程以确保覆盖全部通信入口。