绑定失败时应依次检查：一、启用飞书机器人并记录App ID与App Secret；二、批量导入四项必要权限；三、核对WebHook地址、Verification Token和Encrypt Key；四、升级WorkBuddy至1.0.0+并开启Claw开关；五、确保飞书账号与应用同属一企业且网络可达。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在将 WorkBuddy 绑定飞书时收到失败提示，则可能是由于应用配置缺失、权限未授予、机器人未启用或 WebHook 地址不匹配所致。以下是解决此问题的步骤：
一、检查飞书应用创建与机器人启用状态
飞书机器人能力必须显式启用，否则 WorkBuddy 无法通过飞书开放平台接收和响应消息。仅创建应用而不添加机器人，将导致绑定流程中断。
1、登录飞书开放平台，进入「企业自建应用」列表。
2、点击目标应用名称，进入应用详情页。
3、在「添加应用能力」区域，查找「机器人」卡片；若显示「已添加」则跳过，若显示「添加」按钮，请点击并完成启用。
4、启用后，在「机器人设置」中确认「启用机器人」开关为开启状态，并记录下「App ID」与「App Secret」——这两项是 WorkBuddy 后台对接必需参数。
二、验证并导入必要权限清单
WorkBuddy 需通过飞书机器人向用户发送消息、读取群聊上下文及接收指令，缺少任一关键权限均会导致绑定失败或功能异常。飞书当前要求权限必须批量导入，不可手动逐条勾选。
1、在应用详情页左侧菜单中，点击「权限管理」→「批量导入 / 导出权限」。
2、清空弹窗中已有内容，完整粘贴以下权限标识（截至2026年3月12日有效）：
im:message:read, im:message:send, contact:user:readonly, chat:chat:readonly
3、点击「确定新增权限」，等待页面刷新并显示权限已成功添加。
4、返回「权限管理」主页面，确认上述四项权限状态均为「已授权」且无黄色警告图标。
三、核对 WebHook 地址与签名密钥配置
WorkBuddy 依赖飞书推送事件至指定 WebHook 接口，若地址错误、协议不匹配或签名密钥未同步，飞书将拒绝投递事件，导致绑定判定为失败。
1、在飞书应用详情页的「机器人设置」中，找到「Webhook 地址」字段。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、确认该地址以 https:// 开头，且末尾不含多余斜杠或路径参数（如不应为 https://xxx.com/webhook/ ）。
3、复制「Verification Token」与「Encrypt Key」两项值，进入 WorkBuddy 桌面客户端设置界面 → 「飞书集成」→ 「高级配置」。
4、将 Verification Token 粘贴至「校验令牌」栏，Encrypt Key 粘贴至「加密密钥」栏，确保大小写与特殊字符完全一致。
四、确认 WorkBuddy 客户端版本与 Claw 远程控制开关
旧版 WorkBuddy 不支持飞书 WebHook 模式接入，仅兼容早期企业微信直连协议；且 Claw 功能未启用时，远程消息通道处于关闭状态，即使飞书配置正确也无法建立通信链路。
1、打开 WorkBuddy 客户端，点击右上角头像 → 「关于 WorkBuddy」，确认版本号不低于 1.0.0（参考2026年3月12日发布版本）。
2、若版本过低，请访问官网 https://www.php.cn/link/34a167480f1ee9328cf6f555ef1b7940 下载最新安装包并覆盖安装。
3、在客户端主界面左下角，找到「Claw 远程控制」开关，确保其状态为 开启。
4、开启后，点击右侧「配置渠道」→ 选择「飞书」→ 手动输入飞书应用的 App ID 与 App Secret，并点击「测试连接」验证连通性。
五、排查网络与飞书账号归属一致性
WorkBuddy 绑定飞书需同时满足「技术通道可达」与「组织身份可信」两个条件。若飞书应用所属企业与当前登录的飞书账号不在同一租户下，或客户端所在网络屏蔽了飞书开放平台域名，将直接触发绑定失败。
1、确认当前用于登录飞书开放平台的企业账号，与您在 WorkBuddy 中尝试绑定的飞书账号属于同一飞书「企业」（即同一 domain，如 xxx.feishu.cn）。
2、在 WorkBuddy 设置中，点击「飞书账号绑定」旁的「检测网络」按钮，查看是否能成功访问 https://www.php.cn/link/127f75906618c4a0d33d9188ac6df110/open-apis/auth/v3/tenant_access_token/internal/。
3、若检测失败，请临时关闭本地防火墙或代理工具，或切换至企业内网环境重试。
4、若使用公司统一分发的飞书客户端，请勿改用个人手机号注册的飞书账号进行绑定，否则将因租户隔离策略被拒绝。
