Clawdbot 飞书机器人集成配置实战指南

常见问题排查

在配置过程中，可能会遇到启动失败的情况。例如直接给出 App ID 和 App Secret 后无法启动，或者 clawdbot doctor --fix 无效。这通常是因为飞书插件未被正确安装或配置文件残留导致的。

解决方案： 找到 clawdbot.json 配置文件，删除其中 plugins 和 channels 下关于飞书的旧配置项，然后重启服务即可恢复正常。

修复后重新安装并配置成功：

三、权限与回调配置

按照项目说明设置权限管理，确保机器人拥有必要的操作范围：

以下是建议配置的权限列表，需逐一筛选勾选：

事件与回调设置

事件配置与回调 URL 建议统一改为长连接模式，以便实时接收消息推送：

保存时若提示'应用未建立长连接'，这是因为需要先完成 Clawdbot 的连接初始化（即上述插件安装步骤）。待服务正常启动后再进行保存。

同样按照筛选方式添加以下权限：

最后点击发布使应用生效：

四、测试验证

配置完成后，即可在飞书客户端发送指令进行测试。大功告成！

网页端界面也会同步显示对应的消息记录：

整个流程虽然涉及多个环节，但只要理清了插件安装与权限配置的逻辑，就能顺利打通 AI 助理与飞书的连接链路。