分类 飞书 下的文章

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

Moltbot 飞书集成技术分析

一、背景概述

1. 项目背景

A. Moltbot 简介

Moltbot(原名 Clawdbot)是一个开源的个人 AI 代理/智能体项目,在 GitHub 上获得超过 20,000 个 Star。该项目定位为"执行式 AI",强调通过 AI 代理完成实际任务,而不仅仅是对话交流。

B. 飞书平台

飞书(Lark)是字节跳动推出的企业协作平台,提供即时通讯、在线文档、日历、视频会议等功能,并开放了丰富的机器人 API,支持企业自建应用和第三方应用集成。

2. 集成需求

A. 为什么需要集成飞书

  • 企业用户日常办公主要使用飞书
  • 将 AI 能力带入工作流,提升协作效率
  • 实现 7×24 小时 AI 助理服务

B. 集成价值

  • 无需切换应用,在飞书中直接使用 AI 能力
  • 支持私聊和群聊场景
  • 降低 AI 代理的使用门槛

3. 改名事件

A. 事件概况

2026 年 1 月 27 日,Clawdbot 项目正式更名为 Moltbot。

B. 改名原因

Anthropic 公司(Claude AI 模型开发者)认为原名称与其商标存在冲突,要求项目改名。新名称 Moltbot 取自龙虾的蜕壳行为(molting),保留了原项目的龙虾元素。

C. 对飞书集成的影响

根据搜索结果,项目改名未影响飞书插件的兼容性,两个名称目前都在使用中。

二、技术架构

1. 飞书开放平台架构

A. 两种事件接收模式

模式一:Webhook 模式

  • 需要公网服务器接收回调
  • 飞书主动推送事件到开发者服务器
  • 需要配置域名和 HTTPS 证书

模式二:WebSocket 长连接模式

  • 开发者服务器主动连接飞书平台
  • 无需公网 IP 和域名
  • 通过全双工通道实时接收事件

Moltbot 飞书集成采用 WebSocket 长连接模式,降低了部署门槛。

B. 认证与授权机制

企业自建应用凭证

  • App ID:应用标识
  • App Secret:应用密钥

权限配置

  • 接收消息权限
  • 发送消息权限
  • 获取用户信息权限(如需要)

2. Moltbot 飞书集成架构

graph TB
    subgraph 飞书平台
        A[飞书服务器]
        B[WebSocket 网关]
    end

    subgraph Moltbot
        C[Gateway 网关]
        D[飞书插件/桥接器]
        E[AI 代理核心]
    end

    A <-->|WebSocket 长连接| B
    B <-->|事件消息| D
    D <-->|指令响应| C
    C <-->|AI 处理| E

    F[用户终端] -->|飞书客户端| A

Moltbot 飞书集成架构图

A. 组件说明

  • WebSocket 网关:飞书平台的长连接接入点
  • Gateway:Moltbot 的核心网关,负责渠道管理
  • 飞书插件/桥接器:适配飞书协议的中间层
  • AI 代理核心:处理用户请求的核心逻辑

B. 两种集成方案

方案一:内置插件

  • 插件集成在 Gateway 进程内
  • 一个进程搞定所有功能
  • 优点:部署简单
  • 缺点:插件崩溃可能影响主服务

方案二:桥接器

  • 桥接器作为独立进程运行
  • 与 Gateway 通过进程间通信
  • 优点:隔离性好,稳定性更高
  • 缺点:部署稍复杂

3. 消息处理流程

sequenceDiagram
    participant U as 用户
    participant F as 飞书
    participant B as 桥接器/插件
    participant G as Gateway
    participant A as AI 代理

    U->>F: 发送消息
    F->>B: WebSocket 推送事件
    B->>G: 转发用户消息
    G->>A: 调用 AI 处理
    A-->>G: 返回 AI 响应
    G->>B: 返回响应消息
    B->>F: 发送消息 API
    F-->>U: 显示 AI 回复

消息处理流程时序图

三、集成方案

1. m1heng-clawd-feishu 插件

A. 项目信息

B. 核心特性

  • 企业级安全集成
  • 功能完整的飞书/Lark 通道
  • 支持 24 小时 AI 助理
  • 部署时间约 10 分钟

C. 安装方式

clawdbot plugins install @m1heng-clawd/feishu

D. 配置要求

  • 飞书企业自建应用的 App ID 和 App Secret
  • 服务器能访问外网(无需公网 IP)
  • 配置事件订阅和权限

2. feishu-moltbot-bridge 桥接器

A. 项目信息

B. 核心特性

  • 零服务器接入方案
  • 无需公网 IP
  • 无需域名
  • 无需 ngrok 等内网穿透工具

C. 工作原理

桥接器作为独立进程运行,主动连接飞书 WebSocket 网关,接收事件后转发给 Moltbot Gateway。

D. 部署优势

  • 崩溃不影响主 Gateway 服务
  • 可独立重启和升级
  • 更好的故障隔离

四、部署指南

1. 飞书开放平台配置

A. 创建企业自建应用

  1. 登录飞书开放平台
  2. 创建"企业自建应用"
  3. 获取 App ID 和 App Secret

B. 配置应用权限

  • 开启"接收消息"权限
  • 开启"发送消息"权限
  • 配置事件订阅(如需要)

C. 启用 WebSocket 长连接

在开放平台配置 WebSocket 模式作为事件接收方式。

2. Moltbot 安装飞书插件

A. 使用 UCloud 镜像(推荐)

UCloud 提供了一键部署镜像,已集成飞书插件:

  • 部署时间:约 10 分钟
  • 无需手动配置
  • 支持飞书和企业微信双通道

B. 手动安装插件

# 安装插件
clawdbot plugins install @m1heng-clawd/feishu

# 配置环境变量
export FEISHU_APP_ID="your_app_id"
export FEISHU_APP_SECRET="your_app_secret"

# 重启服务
clawdbot restart

C. 使用桥接器

# 克隆项目
git clone https://github.com/AlexAnys/feishu-moltbot-bridge.git

# 配置连接参数
cp config.example.yaml config.yaml
# 编辑 config.yaml 填入 App ID 和 App Secret

# 启动桥接器
python bridge.py

3. 云服务商一键部署

A. 阿里云无影云电脑

提供 Moltbot(原 Clawdbot)一键部署方案,包含飞书集成配置。

B. 腾讯云 Lighthouse

提供保姆级飞书接入教程,支持一键部署镜像。

C. 优刻得(UCloud)

提供 Clawdbot 镜像,可快速打造飞书私人助理。

五、技术细节

1. WebSocket 长连接实现

A. 连接建立

  1. 使用飞书 SDK 或自行实现 WebSocket 客户端
  2. 使用 App ID 和 App Secret 进行身份验证
  3. 建立到飞书 WebSocket 网关的长连接
  4. 保持连接活跃,处理断线重连

B. 事件处理

飞书通过 WebSocket 推送各类事件,包括:

  • 收到消息事件
  • 用户加入/退出群聊事件
  • 菜单点击事件(如配置了菜单)

C. 消息发送

接收到用户消息后,通过飞书 Open API 发送回复:

POST https://open.feishu.cn/open-apis/bot/v2/homes/{template_id}/send_messages

2. 安全考虑

A. 凭证管理

  • App Secret 必须妥善保管,不能泄露
  • 建议使用环境变量或密钥管理服务
  • 定期轮换 App Secret

B. 消息验证

  • 验证消息来源是否为飞书官方服务器
  • 检查消息签名(如飞书提供)
  • 防止重放攻击

C. 权限控制

  • 仅开启必要的权限
  • 在应用内实现额外的权限验证
  • 记录所有操作日志

3. 性能优化

A. 连接池管理

  • 复用 WebSocket 连接
  • 实现心跳机制保持连接活跃
  • 异常断线自动重连

B. 消息队列

  • 使用消息队列缓冲高并发消息
  • 异步处理 AI 响应
  • 防止消息堆积

C. 响应速度

  • 简单消息快速回复
  • 复杂任务异步处理并反馈进度
  • 设置合理的超时时间

六、使用场景

1. 私聊场景

  • 个人 AI 助理
  • 问答咨询
  • 任务自动化

2. 群聊场景

  • 群内 AI 助手
  • 信息汇总
  • 协作辅助

3. 企业应用

  • 客户服务自动回复
  • 内部知识库问答
  • 流程自动化

七、常见问题

1. 部署问题

Q: 飞书插件安装失败?

A: 检查网络连接,确保能访问 GitHub 和 npm 仓库。可尝试使用国内镜像源。

Q: WebSocket 连接无法建立?

A: 确认服务器能访问外网,检查防火墙规则是否允许出站连接。

Q: 消息发送失败?

A: 检查 App ID 和 App Secret 是否正确,确认应用权限已开启。

2. 运行问题

Q: 消息响应延迟高?

A: 可能是 AI 处理慢,可考虑优化提示词或使用更快的模型。

Q: 连接频繁断开?

A: 检查心跳机制是否正常,网络是否稳定。

Q: 改名后插件是否需要更新?

A: 根据搜索结果,改名未影响插件兼容性,现有安装无需更改。

3. 兼容性问题

Q: 飞书海外版(Lark)是否支持?

A: 是的,插件同时支持飞书国内版和海外版(Lark)。

Q: 能否同时接入多个飞书应用?

A: 理论上可以,但需要配置多个实例或使用不同的配置文件。

八、最佳实践

1. 部署建议

  • 优先使用云服务商提供的一键部署镜像
  • 生产环境建议使用桥接器方案以提高稳定性
  • 定期备份配置和数据

2. 安全建议

  • 使用独立的飞书应用,避免使用生产环境凭证
  • 限制应用可访问的范围和操作
  • 启用操作日志审计

3. 运维建议

  • 监控 WebSocket 连接状态
  • 设置消息处理延迟告警
  • 定期检查插件更新

4. 用户体验优化

  • 设置友好的欢迎消息
  • 提供使用帮助和示例
  • 及时响应用户反馈

九、发展趋势

1. 技术演进

  • WebSocket 长连接模式成为主流
  • 零服务器部署方案日益成熟
  • AI 代理能力持续增强

2. 生态发展

  • 多平台集成支持扩展
  • 企业级功能持续完善
  • 社区贡献的插件增多

3. 应用场景拓展

  • 从个人助理向企业服务延伸
  • 与业务系统深度集成
  • 支持更复杂的自动化流程

十、参考资料

  1. Moltbot 项目改名分析 - 新浪财经
  2. 3 步接入飞书教程 - 高效码农
  3. 飞书 WebSocket 长连接文档 - 飞书开放平台
  4. m1heng/Clawdbot-feishu 插件 - GitHub
  5. AlexAnys/feishu-moltbot-bridge - GitHub
  6. 使用优刻得 Clawdbot 镜像打造飞书私人助理 - 知乎
  7. Moltbot 小白部署指南 - itho.cn
  8. Clawdbot Lark Integration Guide - YouTube - 视频教程
  9. 阿里云 Moltbot 部署 - 阿里云文档
  10. 飞书机器人开发指南 - 飞书官网