5 分钟将 Moltbot(原名 Clawdbot)接入飞书:把这篇文章发给它
5 分钟将 Moltbot(原名 Clawdbot)接入飞书:把这篇文章发给它
Moltbot 是什么?
Moltbot(原名 Clawdbot)是 2026 年最火的开源 AI 助手项目。
根据 TechCrunch 报道,Moltbot 在一个月内获得了 84,000+ GitHub stars,成为增长最快的 AI 项目。
核心特点:
- 支持多个聊天平台(Telegram、飞书、Discord、Slack 等)
- 可以主动发消息(不像传统 AI 只能被动回复)
- 开源免费,可以部署在自己的服务器上
- 配置简单,自动化程度高
我自己用 Moltbot 接入了 Telegram 和飞书,体验很好。今天就说说怎么配置飞书。
TL;DR(太长不看版)
如果你已经在用 Moltbot,想快速接入飞书:
- 安装飞书插件:
clawdbot plugins install @m1heng-clawd/feishu - 在飞书开放平台创建应用,获取 App ID 和 App Secret
- 把这篇文章直接发给 Moltbot
- Moltbot 会引导你完成配置
就这么简单。
如果你想了解详细步骤,继续往下看。
详细配置指南
第零步:安装飞书插件
在配置飞书之前,需要先安装飞书插件。
打开终端,运行:
clawdbot plugins install @m1heng-clawd/feishu安装完成后,你会看到:
✅ Plugin 'feishu' installed successfully验证安装:
clawdbot plugin list | grep feishu如果看到 feishu 在列表中,说明安装成功。
第一步:飞书后台配置
这是唯一需要你手动操作的部分。
1. 创建飞书应用
打开 飞书开放平台(国际版用 https://open.larksuite.com),用飞书账号登录。
点击「创建应用」→「自建应用」,填写:
- 应用名称:Moltbot(或你喜欢的名字)
- 应用描述:AI 助手
- 应用图标:可选
创建完成后,进入应用详情页。
2. 获取凭证
在「凭证与基础信息」部分,你会看到:
- App ID:
cli_xxxxxxxxxxxxx - App Secret:
xxxxxxxxxxxxx
重要:复制并保存这两个值,后面要用。App Secret 不要公开分享。
3. 配置权限
在「权限管理」中,搜索并启用这些权限:
必需权限:
im:message- 获取消息、发送消息im:chat- 获取群信息contact:user.base:readonly- 获取用户基本信息
可选权限(建议开启):
im:message:reaction- 消息表情反应
勾选后点击「保存」。
4. 配置事件订阅
重点来了。
进入「事件订阅」页面:
- 在「连接方式」中选择 WebSocket(不是 Webhook)
在「订阅事件」中勾选:
im.message.receive_v1- 接收消息im.chat.member.bot.added_v1- Bot 被添加到群im.chat.member.bot.deleted_v1- Bot 被移除出群
- 点击「保存」
为什么选 WebSocket?
WebSocket 模式下,Moltbot 会主动连接到飞书服务器。不需要公网 IP,也不需要配置回调 URL。
而且,WebSocket 连接是自动建立的。Moltbot 启动时会自动连接,你不需要做任何额外配置。
5. 发布应用
在应用详情页左上角,点击「发布」。
你可以选择:
- 发布到整个工作区(所有人可用)
- 发布到测试组(只有特定用户可用)
发布后,应用就可以使用了。
第二步:让 Moltbot 自动配置
现在你有了:
- App ID:
cli_xxxxxxxxxxxxx - App Secret:
xxxxxxxxxxxxx
方式 1:直接发送这篇文章
把这篇文章的链接或内容发给 Moltbot(通过 Telegram 或其他已配置的渠道),Moltbot 会自动识别并引导你完成配置。
方式 2:手动发送配置信息
如果你想手动配置,发送这段内容给 Moltbot:
帮我配置飞书集成:
App ID: cli_xxxxxxxxxxxxx
App Secret: xxxxxxxxxxxxx
Domain: feishu
Connection Mode: websocketMoltbot 会自动:
- 更新配置文件
- 重启 gateway 服务
- 建立 WebSocket 连接
- 验证连接状态
整个过程不到 1 分钟。
你会收到类似这样的回复:
✅ 飞书配置已完成
配置信息:
- App ID: cli_xxxxxxxxxxxxx
- Domain: feishu
- Connection Mode: websocket
Gateway 已重启,WebSocket 连接已建立。
你可以在飞书中测试机器人了。第三步:测试验证
1. 在飞书中找到机器人
打开飞书客户端,搜索你创建的应用名称(如「Moltbot」)。
2. 私聊测试
给机器人发送一条消息:
你好,请介绍一下自己如果配置正确,机器人会在几秒内回复。
3. 群聊测试
把机器人添加到一个测试群,然后 @ 它:
@Moltbot 你好注意:群聊中必须 @ 机器人,它才会回复。这是飞书的机制,避免机器人回复所有消息。
4. 查看日志
如果想确认连接状态,可以查看 Moltbot 的日志:
# 注:命令行工具目前还叫 clawdbot
clawdbot gateway logs正常情况下,你会看到:
[feishu] starting feishu provider (mode: websocket)
[feishu] bot open_id resolved: ou_xxxxx
[feishu] starting WebSocket connection...
[feishu] WebSocket client started
[feishu] received message event
[feishu] message sent successfully常见问题
1. 机器人没有回复
可能原因:
- 权限没配对
- 事件订阅没保存
- 应用没发布
解决方法:
- 回到飞书开放平台,检查权限和事件订阅
- 确认应用已发布
- 重新发送配置信息给 Moltbot
2. WebSocket 连接失败
可能原因:
- App ID 或 App Secret 错了
- 网络问题
解决方法:
- 检查 App ID 和 App Secret 是否正确
- 查看日志确认错误信息
- 重启 gateway:
clawdbot gateway restart
3. 群聊中 @ 了机器人但没反应
可能原因:
- 群组不在白名单中(如果配置了白名单)
- 机器人没被正确添加到群
解决方法:
- 确认机器人在群成员列表中
- 检查配置文件中的 groupPolicy 设置
- 如果用了 allowlist 策略,需要把群 ID 加到白名单
4. 如何获取群 ID
在群聊中发送消息后,查看 Moltbot 日志:
[feishu] received message from chat: oc_xxxxxoc_xxxxx 就是群 ID。
进阶配置
如果你想自定义更多设置,可以告诉 Moltbot:
1. 配置访问控制
更新飞书配置:
dmPolicy: pairing
groupPolicy: allowlist
groupAllowFrom: ["oc_xxxxx", "oc_yyyyy"]dmPolicy:私聊策略(open / pairing / allowlist)groupPolicy:群聊策略(open / allowlist / disabled)groupAllowFrom:群聊白名单
2. 配置历史消息数量
更新飞书配置:
historyLimit: 20
dmHistoryLimit: 5historyLimit:群聊历史消息数(默认 20)dmHistoryLimit:私聊历史消息数(默认 5)
3. 配置消息分块
更新飞书配置:
textChunkLimit: 1500单条消息最大字数,超过会自动分块发送。
总结
用 Moltbot 配置飞书,真的很简单:
- 安装飞书插件:
clawdbot plugin install feishu - 在飞书开放平台创建应用,获取 App ID 和 App Secret
- 把这篇文章发给 Moltbot(或手动发送配置信息)
- 测试验证
整个过程 5 分钟搞定。
核心优势:
- 不需要手动改配置文件
- 不需要懂技术细节
- WebSocket 自动连接,无需额外配置
- 出问题了,Moltbot 会告诉你怎么解决
如果你也在用 Moltbot,试试接入飞书吧。在企业内部用飞书沟通,配个 AI 助手还是挺方便的。
有问题欢迎留言,我看到会回复。
相关链接:
- Moltbot GitHub:https://github.com/Moltbot/Moltbot
- 飞书开放平台:https://open.feishu.cn
- Moltbot 文档:https://docs.clawd.bot
- 飞书插件:https://github.com/m1heng/clawdbot-feishu
我拉了一个 Moltbot 讨论群,已经满 200 人了,可加微信 littlebena,备注 Moltbot 进群。
如果这篇文章对你有帮助,请随手点赞、在看、转发三连,可以让更多小伙伴看到;如果你想第一时间收到推送,也可以给我一个星标⭐️,感谢你的支持。
关于作者 Ben,ALL in AI 出海
- 中文圈最大 AI 社群 WaytoAGI 从 1-10 策划人
- AI 编程实践者,上线了 30+ 产品
- 个人网站:https://benx.ai