Clawdbot 教程 02：飞书集成（完全国产化）

导语

想把 Clawdbot 接到飞书，整套只用国产模型、断网也能跑？可以的。本文把从飞书开发者后台，到本地 openclaw 配置，再到最后配对的完整流程写清楚。遇到坑的地方我都会标注，并给出命令和示例，跟着做就行。🚀

1）在飞书开发者后台创建机器人

场景：你要在企业/组织里把机器人当成同事用。先在飞书里建个应用。

操作要点：

• 打开飞书开发者后台，创建新应用，随意填名字、描述、图标。记得记下 App ID 和 App Secret（在「凭证与基础信息 - 应用凭证」里）。
• 进入「权限管理」，把下面的权限 JSON 全量导入。导入完成后点「确认新增权限」。这是让机器人能收发消息的关键步骤。

权限 JSON（直接复制导入）：

{
  "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 助手"），保存后机器人能力会被激活。必须做这步，不然后面收不到消息。

2）在 Clawdbot 本地添加飞书 Channel（最容易卡的地方）

场景：本地的 Clawdbot 要安装飞书插件，和飞书打通。

关键命令（在你的 Clawdbot 环境里执行）：

openclaw channels add
# 选择 Feishu/Lark

会触发一个交互式向导。注意下面这些坑。

常见坑与解决：

• 插件提示"已存在"但回到菜单：说明安装过但未成功。解决方法：找到插件目录，手动删除对应插件文件夹，然后重跑命令。系统会提示插件目录在哪里。
• zod 依赖缺失：重装插件时常见报错。最稳的办法是全局安装 zod：

npm install -g zod

安装成功后，再跑 openclaw channels add，选择飞书，继续。

交互输入项说明：

• Feishu account id：随意的标识名，比如 my-bot。
• 飞书版本：选中国版（国内用户）或 Lark（海外）。
• App ID / App Secret：填飞书开发者后台拿到的两个值。

千万别忘了在向导的最后点「Finished」。我自己就因为没点这个浪费了好几分钟。

随后会问私信访问策略：

• Configure DM access policies now? 选 Yes
• Feishu DM policy：推荐选 Pairing（需要配对码）
• Add display names for these accounts?：选 No（可选）

最后，重启网关让配置生效：

openclaw gateway restart

必须重启，否则不会建立长连接。

3）回到飞书完成事件与发布配置

场景：让飞书把用户发来的消息推给你的 Clawdbot。

步骤要点：

• 在「事件与回调」页面，把订阅方式设为“使用长连接接收事件”，然后保存。遇到提示"没有建立长连接"，等 1-2 分钟再试。若还是不行，看 Clawdbot 日志确认网关是否启动。
• 添加事件：在事件配置里添加 im.message.receive_v1，这个事件能让机器人接收私信消息。
• 发布版本：进入「版本管理与发布」，创建并发布一个版本。没有发布的话，配置不会生效。

4）给机器人配对（完成绑定）

场景：把飞书里的账号跟 Clawdbot 绑定起来。

流程：

1. 在飞书里找到刚创建的机器人，直接给它发一条消息。机器人会自动回一个配对码，格式类似：

pair:XXXXXX

2. 打开 Clawdbot 的 Web UI，把配对码发进去。Clawdbot 会自动完成绑定。

绑定成功后，你就能在飞书私聊或拉进群聊里跟 Clawdbot 互动了。

如果你把国产模型接入（例如通过 API 接入的 minimax、kimi、GLM 等），整套方案就是国产化的：模型、消息通道、管理都在国内可控环境里运行。

示例：从头到尾的命令清单

• 在飞书后台拿 App ID / Secret
• 在 Clawdbot 目录运行：

openclaw channels add
# 遇到 zod 报错：
npm install -g zod
# 配置完后：
openclaw gateway restart

• 在飞书后台完成事件订阅和发布版本
• 发消息拿配对码 -> 在 Clawdbot Web UI 粘贴配对码

避坑清单（必须牢记）

• 如果提示插件“已存在”但没安装成功：手动删除插件目录后再安装。路径会在提示里显示。
• zod 依赖问题：先全局装 zod（npm install -g zod）。多半能解决。
• 添加 channel 后，一定要在向导最后点「Finished」。不点就白做了。
• 配置长连接后，点保存可能需要等 1-2 分钟，别急着重试多次。
• 发布版本是必须的，没发布就看不到效果。

小结与建议

• 想要完全国产化，就把你模型换成国内的 API，然后按上面流程接入飞书。能避开外网依赖，稳定又安全。
• 如果公司里多人要用，建议把机器人拉进群聊并开启 Pairing 策略控制私聊权限。
• 日志是朋友：如果哪里不对，先看 Clawdbot 的网关日志，很多错误都能从日志里发现原因。

用这套方法，我把 Clawdbot 挂到飞书，团队内部测试就用了起来。遇到具体错误可以把日志贴上来，我帮你看。🙂

官方文档： https://docs.openclaw.ai/zh-CN/channels/feishu

如果这篇对你有用，别忘了点个赞或转给需要的人～