昨天 Clawdbot 2026.2.2 更新官方支持了飞书的集成插件。
这代表着国内用 Clawdbot 完全可以使用国产的整个流程去替代了。
你可以用国产的模型，然后连接到飞书，完全不用担心网络问题。
如何配置国产模型：https://x.com/op7418/status/2017647987854610930?s=20
然后飞书还能用群聊跟很多人聊天，非常好玩，Clawdbot 的应用性拉满了。
第一步：在飞书开发者后台创建机器人
去飞书开发者后台，创建一个新的机器人应用。这一步很简单，填写应用名称、应用描述，选个背景色和图标就行。
创建完成后，你需要记下两个关键信息：App ID 和 App Secret，这两个 ID 在后面配置 Clawdbot 的时候要用到，都在「凭证与基础信息 - 应用凭证」这里能找到。
配置飞书机器人权限
进入权限管理，找到「批量导入导出权限」，权限配置 JSON，直接复制过来，点击导入。在 Clawdbot 官方文档的飞书配置页面有现成的，全选导入就可以了。
导入完成后，点击「确认新增权限」就完成了权限配置。这一步是为了让机器人有接收消息、发送消息等必要的权限。
开启机器人能力
在「机器人」配置页面，点击「如何开始使用」，随便输入一句欢迎语（比如"你好，我是 AI 助手"），然后点击保存，机器人能力就开启了。
这一步是飞书机器人平台的必要配置，不开启的话后面无法接收消息。
第二步：在 Clawdbot 里配置飞书 Channel
这部分在 Clawdbot 本地完成，坑比较多，要注意几个关键点。
运行安装向导命令
在终端运行 openclaw channels add 命令，会启动一个交互式向导。选择飞书（Feishu/Lark）选项，因为飞书支持是通过 plugin 实现的，所以它会自动下载插件。
这里第一个坑来了：如果提示"插件已存在"，然后又跳回上一层选项菜单，说明之前安装过但没安装成功。你需要手动去对应的文件夹删除这个插件文件夹，删除后重新运行 openclaw channels add 命令。
系统会告诉你插件在哪个目录，按照提示去那个目录删掉整个插件文件夹就行。
解决 zod 依赖缺失问题
删除插件重新安装后，它会问你是否用 npm 安装这个插件，选择确定。这时候第二个坑来了：会提示缺少 zod 依赖。
正常情况下应该在当前文件夹安装 zod 依赖就行，但问题是如果你已经有了插件文件夹，它不让你安装；如果你删了插件文件夹，zod 依赖也被删了。这是个已知的 bug，很多人在报。
解决方案是全局安装 zod 依赖，运行这个命令：npm install -g zod
安装完成后，再重新运行 openclaw channels add 命令，选择飞书，这次就能顺利进行了。
填写配置信息
安装成功后，会让你填写几个配置项：
▸ Feishu account id：这个是用来区分多个飞书机器人的，随便填一个名字就行，比如"my-bot"
▸ 选择飞书版本：中国版飞书还是海外版 Lark，根据你的实际情况选择，国内用户选中国版
▸ 填写 App ID 和 App Secret：把之前在飞书开发者后台获取的两个 ID 填进去
填写完成后，注意一定要选择「Finished」才算添加成功。我刚开始就是没点这个，结果一直没添加上，这是个容易忽略的细节。
配置私信访问策略
接下来会问你几个配置问题：
▸ Configure DM access policies now? 选择 Yes
▸ Feishu DM policy：选择 Pairing（推荐，需要配对码才能使用）
▸ Add display names for these accounts?：选择 No（可选）
这几个配置按推荐选项走就行，主要是控制谁能跟机器人私聊。
重启网关
所有配置完成后，运行 openclaw gateway restart 命令重启网关。这一步是让新的 channel 配置生效，必须重启才能建立连接。
第三步：回到飞书平台完成最后配置
现在需要回到飞书开发者后台做最后的设置。
配置事件订阅方式
进入「事件与回调」页面，在「事件配置」里找到「订阅方式」，选择「使用长连接接收事件」，然后点击保存。
这里可能会提示"没有建立长连接"，不要慌，等一两分钟再点保存就行。如果等了几分钟还是不行，可能需要检查一下 Clawdbot 的日志，看看是不是网关没正常启动。
如果你按照我前面的步骤操作，一般不会有问题。
添加接收消息事件
在「事件配置」页面，点击「添加事件」，搜索 im.message.receive_v1 这个事件，点击添加。这个事件是用来接收用户发送的私信消息的，不添加的话机器人收不到消息。
发布版本
进入「版本管理与发布」页面，点击「创建版本」，然后点击「发布」。如果你没有发布版本，系统会有提示引导你去创建，跟着提示走就行。
只有发布了版本，机器人的配置才会真正生效。
第四步：配对机器人
现在机器人已经可以用了，最后一步是完成配对。
在飞书里找到你刚创建的机器人，发送一条消息，它会自动回复一个配对码，类似这样的格式：pair:XXXXXX。
复制这个配对码，打开 Clawdbot 的 Web UI（就是你平时跟 Clawdbot 对话的网页），把配对码发给它，Clawdbot 会自动完成绑定。
绑定成功后，你就可以在飞书里跟 Clawdbot 愉快交流了，也可以把机器人拉到公司群里，让所有小伙伴都能用。
配置完成后，你的飞书机器人就能正常工作了。
如果你用的是国产模型（比如通过 API 接入的minimax、kimi、GLM等），整套方案就完全是国产化的了。
要注意的几个关键点：
▸ zod 依赖缺失的问题，记得全局安装
▸ 添加 channel 后一定要点 Finished
▸ 配置长连接后等一两分钟再保存
▸ 记得发布版本，否则配置不生效
整个配置流程虽然有几个坑，但都有明确的解决方案，按照步骤来基本不会卡住。
好了，这就是今天的 Clawdbot 飞书配置流程。
如果你觉得对你有帮助的话，可以帮我点个赞👍，也可以转发给其他你觉得需要的朋友们。
官方文档：https://docs.openclaw.ai/zh-CN/channels/feishu
