深度文章

飞书 Feishu/Lark 桥接 Moltbot/Clawdbot (无需公网)

飞书 Feishu/Lark 桥接 Moltbot/Clawdbot (无需公网)

发布日期: 2026.01.31
文档总结:

这份文档总结了将 Moltbot(原 Clawdbot)智能体接入飞书 (Feishu/Lark) 的解决方案。核心优势是利用飞书的 WebSocket 长连接,实现了无需公网服务器、无需域名、无需内网穿透的部署,极大地简化了 setup 流程。

核心价值与接入方式

项目提供了两种接入方式:

  1. moltbot-feishu 插件: 推荐用于一体化管理,内置于 Clawdbot Gateway。
  2. 独立桥接器(本项目): 适合需要隔离部署的场景,作为独立进程运行。

工作原理

通过在本地运行一个桥接脚本,主动连接飞书云端。脚本负责接收消息,通过本地 WebSocket 转发给 Clawdbot Gateway 进行处理,再将回复发回飞书。

部署关键点

  • **飞书配置:** 需在飞书开放平台创建“自建应用”(机器人),并确保在事件与回调中选择“使用长连接接收事件”
  • **权限要求:** 需开通 im:messageim:message.group_at_msgim:message.p2p_msg 权限。
  • **部署环境:** 桥接脚本需与 Clawdbot Gateway 在同一台机器上运行 (默认连接 127.0.0.1)。
  • **高可靠性:** 推荐使用 macOS 的 launchd 设置开机自启和崩溃自动重启。

进阶配置

在群聊中,桥接器采用“低打扰”模式,仅回复被 @、疑问句或包含请求类动词的消息。若 AI 回复耗时超过 2.5 秒,会发送“正在思考…”提示,随后自动替换为完整内容。