Clawdbot 飞书集成教程：完全国产化方案

本文转载自 歸藏 (@op7418) 的 Twitter。

Clawdbot 2026.2.2 更新官方支持了飞书集成插件。这意味着国内用户可以用国产模型 + 飞书，完全不用担心网络问题，实现完全国产化的 AI 助手方案。

飞书还支持群聊，可以让多人一起使用，应用性拉满。

国产模型配置教程参考：如何配置国产模型

第一步：在飞书开发者后台创建机器人

去飞书开发者后台，创建一个新的机器人应用。填写应用名称、描述，选个背景色和图标即可。

创建完成后，记下两个关键信息：

• App ID
• App Secret

都在「凭证与基础信息 - 应用凭证」里能找到。

配置权限

进入权限管理，找到「批量导入导出权限」，使用权限配置 JSON 导入。在 Clawdbot 官方文档的飞书配置页面 有现成的 JSON，全选导入即可。

导入后点击「确认新增权限」完成配置。

开启机器人能力

在「机器人」配置页面，点击「如何开始使用」，输入一句欢迎语（比如"你好，我是 AI 助手"），保存。不开启的话后面无法接收消息。

第二步：在 Clawdbot 里配置飞书 Channel

这部分坑比较多，注意以下关键点。

运行安装向导

openclaw channels add

选择飞书（Feishu/Lark），系统会自动下载插件。

⚠️ 坑 1：如果提示"插件已存在"又跳回选项菜单，说明之前安装过但没成功。需要手动去对应目录删除插件文件夹，再重新运行命令。

解决 zod 依赖缺失

重新安装时会提示缺少 zod 依赖。这是个已知 bug。

解决方案：全局安装 zod

npm install -g zod

安装后重新运行 openclaw channels add，选择飞书，即可顺利进行。

填写配置信息

⚠️ 坑 2：填完一定要选择「Finished」才算添加成功！

配置私信访问策略

• Configure DM access policies now? → Yes
• Feishu DM policy → Pairing（推荐，需配对码）
• Add display names? → No

重启网关

openclaw gateway restart

第三步：飞书平台最后配置

配置事件订阅

进入「事件与回调」→「事件配置」→「订阅方式」，选择「使用长连接接收事件」，保存。

💡 如果提示"没有建立长连接"，等 1-2 分钟再点保存。

添加接收消息事件

在「事件配置」页面，点击「添加事件」，搜索并添加：

im.message.receive_v1

不添加这个事件，机器人收不到消息。

发布版本

进入「版本管理与发布」，创建版本并发布。不发布的话配置不生效。

第四步：配对机器人

1. 在飞书里找到你的机器人，发送一条消息
2. 机器人回复配对码，格式：pair:XXXXXX
3. 复制配对码，在 Clawdbot Web UI 中发送
4. 绑定成功！

绑定后可以把机器人拉到群里，让所有人都能用。

踩坑总结

配合国产模型（minimax、kimi、GLM 等），整套方案就完全国产化了。

官方文档：Clawdbot 飞书配置

原文作者：歸藏 (@op7418)