分类 Chatbot 下的文章

5 分钟将 Moltbot（原名 Clawdbot）接入飞书：把这篇文章发给它

Moltbot 是什么？

Moltbot（原名 Clawdbot）是 2026 年最火的开源 AI 助手项目。

根据 TechCrunch 报道，Moltbot 在一个月内获得了 84,000+ GitHub stars，成为增长最快的 AI 项目。

核心特点：

  • 支持多个聊天平台（Telegram、飞书、Discord、Slack 等）
  • 可以主动发消息（不像传统 AI 只能被动回复）
  • 开源免费，可以部署在自己的服务器上
  • 配置简单，自动化程度高

我自己用 Moltbot 接入了 Telegram 和飞书，体验很好。今天就说说怎么配置飞书。

TL;DR（太长不看版）

如果你已经在用 Moltbot，想快速接入飞书：

  1. 安装飞书插件：clawdbot plugins install @m1heng-clawd/feishu
  2. 在飞书开放平台创建应用，获取 App ID 和 App Secret
  3. 把这篇文章直接发给 Moltbot
  4. 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. 配置事件订阅

重点来了。

进入「事件订阅」页面：

  1. 在「连接方式」中选择 WebSocket（不是 Webhook）

  2. 在「订阅事件」中勾选：

    • im.message.receive_v1 - 接收消息
    • im.chat.member.bot.added_v1 - Bot 被添加到群
    • im.chat.member.bot.deleted_v1 - Bot 被移除出群
  3. 点击「保存」

为什么选 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: websocket

Moltbot 会自动：

  1. 更新配置文件
  2. 重启 gateway 服务
  3. 建立 WebSocket 连接
  4. 验证连接状态

整个过程不到 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. 机器人没有回复

可能原因：

  • 权限没配对
  • 事件订阅没保存
  • 应用没发布

解决方法：

  1. 回到飞书开放平台，检查权限和事件订阅
  2. 确认应用已发布
  3. 重新发送配置信息给 Moltbot

2. WebSocket 连接失败

可能原因：

  • App ID 或 App Secret 错了
  • 网络问题

解决方法：

  1. 检查 App ID 和 App Secret 是否正确
  2. 查看日志确认错误信息
  3. 重启 gateway：clawdbot gateway restart

3. 群聊中 @ 了机器人但没反应

可能原因：

  • 群组不在白名单中（如果配置了白名单）
  • 机器人没被正确添加到群

解决方法：

  1. 确认机器人在群成员列表中
  2. 检查配置文件中的 groupPolicy 设置
  3. 如果用了 allowlist 策略，需要把群 ID 加到白名单

4. 如何获取群 ID

在群聊中发送消息后，查看 Moltbot 日志：

[feishu] received message from chat: oc_xxxxx

oc_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: 5
  • historyLimit：群聊历史消息数（默认 20）
  • dmHistoryLimit：私聊历史消息数（默认 5）

3. 配置消息分块

更新飞书配置：

textChunkLimit: 1500

单条消息最大字数，超过会自动分块发送。

总结

用 Moltbot 配置飞书，真的很简单：

  1. 安装飞书插件：clawdbot plugin install feishu
  2. 在飞书开放平台创建应用，获取 App ID 和 App Secret
  3. 把这篇文章发给 Moltbot（或手动发送配置信息）
  4. 测试验证

整个过程 5 分钟搞定。

核心优势：

  • 不需要手动改配置文件
  • 不需要懂技术细节
  • WebSocket 自动连接，无需额外配置
  • 出问题了，Moltbot 会告诉你怎么解决

如果你也在用 Moltbot，试试接入飞书吧。在企业内部用飞书沟通，配个 AI 助手还是挺方便的。

有问题欢迎留言，我看到会回复。

相关链接：

我拉了一个 Moltbot 讨论群，已经满 200 人了，可加微信 littlebena，备注 Moltbot 进群。

如果这篇文章对你有帮助，请随手点赞、在看、转发三连，可以让更多小伙伴看到；如果你想第一时间收到推送，也可以给我一个星标⭐️，感谢你的支持。

关于作者 Ben，ALL in AI 出海

  • 中文圈最大 AI 社群 WaytoAGI 从 1-10 策划人
  • AI 编程实践者，上线了 30+ 产品
  • 个人网站：https://benx.ai