Clawdbot 教程 02：如何集成飞书，完全国产化！

昨天 Clawdbot 2026.2.2 更新官方支持了飞书的集成插件。

这代表着国内用 Clawdbot 完全可以使用国产的整个流程去替代了。

你可以用国产的模型，然后连接到飞书，完全不用担心网络问题。

然后飞书还能用群聊跟很多人聊天，非常好玩，Clawdbot 的应用性拉满了。

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

去飞书开发者后台，创建一个新的机器人应用。这一步很简单，填写应用名称、应用描述，选个背景色和图标就行。

创建完成后，你需要记下两个关键信息：App ID 和 App Secret。

这两个 ID 在后面配置 Clawdbot 的时候要用到，都在「凭证与基础信息 - 应用凭证」这里能找到。

配置飞书机器人权限

进入权限管理，找到「批量导入导出权限」，权限配置 JSON，直接复制过来，点击导入。在 Clawdbot 官方文档的飞书配置页面有现成的，全选导入就可以了。

{
  "scopes":{
    "tenant":[
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user":["aily:file:read","aily:file:write","im:chat.access_event.bot_p2p_chat:read"]
}
}

导入完成后，点击「确认新增权限」就完成了权限配置。这一步是为了让机器人有接收消息、发送消息等必要的权限。

开启机器人能力

在「机器人」配置页面，点击「如何开始使用」，随便输入一句欢迎语（比如"你好，我是 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 飞书配置流程。

如果你觉得对你有帮助的话，可以帮我点个赞，也可以转发给其他你觉得需要的朋友们。