OpenClaw 飞书多 Agent 配置教程(破局星球版)
一个 OpenClaw 实例 + 多个飞书机器人 = 你的 AI 团队
一个 OpenClaw 实例 + 多个飞书机器人 = 你的 AI 团队
我是俊哥 ，破局行动家，AI编程教练, OpenClaw 玩家，最近过年期间我是一天都没闲着，感谢洋哥，孟健天天倒逼我，否则估计我又懈怠了，我给大家分享下OpenClaw 多Agent玩法
前几天我在另一台机器上搞了个 Telegram 多 Agent 团队，当时就已经把我震到了。
6个 Telegram bot——大总管小俊、开发助理、运营增长、内容助理、法务助理、财务助理。
全部拉到一个 Telegram 群里。
对，你没看错。
一个群，6个 AI。美女忽略，俊哥主要为了防止疲劳
img
因为大家还是用国内的生态比较多，我又加了一套飞书的
img
很庆幸的是这套玩法我也分享到X上了，没想到再X上跑了53万浏览量，这里也是分享给破局小伙伴，X上真的是流量蓝海。
img
最终效果
在飞书里拥有多个独立的 AI 助手，每个都有自己的人设、记忆和工作区：
- 🌸 大总管小夏 — 统筹全局，调度其他助理
- 💻 开发助理 — 写代码、调试、部署
- ✍️ 内容助理 — 写文章、文案
- 📈 运营增长 — 用户增长、市场推广
- ⚖️ 法务助理 — 合同审查、合规咨询
-
💰 财务助理 — 成本核算、预算管理
它们互相独立，又能互相协作。大总管可以调度开发助理写代码，然后通知内容助理写文档。
前置条件
- 已经部署好 OpenClaw（Gateway 正常运行）本文以腾讯云OpenClaw举例
- 有飞书管理员权限（或有人帮你操作飞书开放平台）
- 飞书部分参考腾讯云官方
第一步：在飞书开放平台创建应用
有几个 Agent 就创建几个飞书应用。每个应用就是一个独立的飞书机器人。这个过程比较繁琐，大家按照教程跟着执行就行。
操作流程（每个应用都重复一遍）：
创建飞书企业自建应用
首先，您需要使用您的飞书账号登录开发者后台 - 飞书开放平台。登录成功后，点击创建企业自建应用。
img
填写应用名称（如 “OpenClaw助手”）、应用描述，选择应用图标，点击创建按钮，进入应用管理页面。
img
添加机器人
在前一步所创建应用的管理页面，左侧导航栏中找到并点击添加应用能力，在弹出的列表中选择机器人，点击添加。
img
提示：添加机器人之后，可以暂不发布，待其他配置完成后一并发布。
发布应用
- 左侧菜单 →「版本管理与发布」
- 点击「创建版本」→ 填写版本号（如 1.0.0）→ 提交
- 等管理员审批通过（如果你就是管理员，直接通过）
1.
查询AppID和AppSecret
在左侧导航栏找到 “凭据与基础信息” ，点击进入。在页面中找到 “App ID” 和 “App Secret” 两个参数，分别点击右侧 “复制” 按钮，将其保存到个人记事本或备忘录中（注意数据安全，勿泄露），后续步骤中需要使用。
img
为OpenClaw配置模型和通道
接下来需要为已经完成部署的OpenClaw配置模型和通道（即OpenClaw channel，如飞书）。
进入腾讯云控制台，选中对应的已部署OpenClaw的Lighthouse服务器实例，点击服务器卡片进入“管理实例”页面。
img
模型配置
为OpenClaw配置模型API Key可以在Lighthouse服务器的应用管理页面进行操作
img
通道配置（配置飞书机器人App ID和App Secret）
进入“应用管理”页签，在“通道配置”输入框，选择“飞书”，输入前面步骤中查询到的飞书机器人的App ID和App Secret，并点击应用并确定执行操作，等待几十秒后页面提示“保存成功”即完成配置，确保你的飞书通道显示“使用中”。
提示：OpenClaw支持同一台服务器配置多个通道，例如支持同时接入QQ机器人和飞书机器人。因此，如果当前正在配置的服务器之前已经接入了其他通道，也可以继续添加通道。
img
提示：点击“应用”按钮完成通道配置之后，应用管理页面中仅展示“使用中”状态，并不会展示已配置的APP ID和App Secret。
飞书机器人相关配置
事件配置
在飞书应用管理页，左侧导航栏找到 “事件与回调” ，点击进入页面。在“事件配置”页签中选择 “长连接接收事件”，点击保存。
img
⚠️注意：如果这一步报错提示“应用未建立长连接”，请检查前面步骤中的机器人App ID和App Secret是否已正确配置。
此时如果事件配置保存成功，可直接前往后续的“添加事件”步骤。
（可选）如果检查前面步骤中的机器人App ID和App Secret均已经正确配置，但点击保存后仍然报错“应用未建立长连接”，可以参考以下步骤来建立长连接：在轻量应用服务器应用管理页面，找到OpenClaw状态显示，点击“重启”按钮，重启网关服务，再返回飞书开放平台，点击保存事件配置，完成建立长连接。
img
添加事件
点击“事件配置”页面中的 “添加事件”，在弹出的列表中，搜索并添加 “接收消息”，点击 “确认添加”，按照指引确认开通权限。
img
（推荐）若您期望将飞书机器人添加进聊天群组中使用，可以参考前述步骤继续添加更多群组相关权限，主要包括“消息已读”、“机器人进群”、“机器人被移出群”。否则，请跳过本步骤。
img
完成添加后，可以在当前页面的列表中查看到已添加的事件。
img
回调配置
在“事件与回调-回调配置”页面中，订阅方式选择 “使用长连接接收回调”，点击保存，无需填写其他地址，配置自动生效。
img
权限配置
在飞书应用管理页，左侧导航栏找到 “权限管理” ，点击进入页面。点击页面中的 “批量导入权限” 按钮，弹出权限导入窗口。
img
img
复制以下代码，替换前面弹窗中原有的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", "cardkit:card:write", "contact:contact.base:readonly", "contact:user.employee_id:readonly", "corehr:file:download", "docs:document.content:read", "event:ip_list", "im:chat", "im:chat.access_event.bot_p2p_chat:read", "im:chat.members:bot_access", "im:chat:readonly", "im:message", "im:message.group_at_msg:readonly", "im:message.group_msg", "im:message.p2p_msg:readonly", "im:message:readonly", "im:message:send_as_bot", "im:resource", "sheets:spreadsheet", "wiki:wiki:readonly" ], "user": [ "aily:file:read", "aily:file:write", "contact:contact.base:readonly", "im:chat.access_event.bot_p2p_chat:read" ] } }
权限导入完成后，可以在权限列表中查看已成功导入的权限。
提示：后续使用飞书机器人过程中也可以按需调整权限设置。
img
img
创建版本并发布
在飞书应用管理页，左侧导航栏找到 “版本管理与发布” ，点击进入页面。点击右上角的创建版本。
img
填写应用版本号（此处以1.0.0为例，您可以自行定义版本号）和更新说明，点击保存并确认发布。
img
待飞书管理员通过发布审核。审核发布成功后，可以在“版本管理与发布”页面，查看到已经发布的版本号和状态。
img
与飞书机器人进行交互
完成前面的步骤之后，您可以与飞书机器人进行单独聊天，或者将飞书机器人添加进群聊。
单独聊天
以电脑版飞书软件为例（手机端飞书的操作类似），登录飞书后，点击搜索框。
img
在搜索框中输入前面步骤中创建并发布的飞书机器人的应用名称，输入回车进行搜索。
img
img
单击搜索到的机器人，进入私聊页面，即可开始与已经接入OpenClaw的飞书机器人进行对话。
（可选）首次对话会如果提示如下图所示的配对请求，可以复制机器人回复的最后一行命令行。
img
接下来返回轻量应用服务器控制台，选中前面步骤中完成OpenClaw配置的服务器，点击登录，使用OrcaTerm终端免密登录服务器。在终端中粘贴上一步中复制的命令行，点击回车执行命令。命令完成执行后会提示配对成功。
img
接下来继续尝试与该机器人进行对话，如果机器人以AI的方式进行回复，即说明配对成功。
img
群聊添加飞书机器人
对于群组聊天的场景，可以点击飞书搜索框上方的加号，选择创建群组，并完成创建。
img
img
进入新创建的群组，点击右上角的设置。
img
在设置中选择“群机器人”，点击添加机器人。
img
在上方搜索框搜索您创建的机器人的应用名称。
img
选择您之前创建的机器人后，点击添加即可将飞书机器人加入群聊，示例如下所示。
img
到这里就初步完成了配置，在手机版飞书和电脑版飞书上均可以开始与已经接入OpenClaw的飞书机器人进行聊天。
img
注意：机器人只能被添加进同一企业下的群聊，外部群无法添加机器人。
每个应用都要走一遍上面的流程。 6 个 Agent 就创建 6 个应用，拿到 6 组 App ID + App Secret。
第二步：配置 OpenClaw 这部分可以让OpenClaw来执行
OpenClaw 的配置文件在 ~/.openclaw/openclaw.json。
你可以手动编辑，也可以让 AI 帮你改（推荐让 AI 改，不容易出错）。
2.1 定义 Agent 列表
告诉 OpenClaw 你有哪些 Agent：
JSON{ "agents": { "list": [ { "id": "main", "default": true, "name": "大总管小夏", "workspace": "/root/.openclaw/workspace" }, { "id": "dev", "name": "开发助理", "workspace": "/root/.openclaw/workspace-dev" }, { "id": "content", "name": "内容助理", "workspace": "/root/.openclaw/workspace-content" }, { "id": "ops", "name": "运营增长", "workspace": "/root/.openclaw/workspace-ops" }, { "id": "law", "name": "法务助理", "workspace": "/root/.openclaw/workspace-law" }, { "id": "finance", "name": "财务助理", "workspace": "/root/.openclaw/workspace-finance" } ] } }
⚠️ 重点：每个 Agent 的 workspace 必须不同！
workspace 就是 Agent 的"工作桌面"，里面放着它的人设文件（SOUL.md）、记忆文件（memory/）、团队信息（AGENTS.md）等。分开才不会互相干扰。
2.2 配置飞书多账户通道
把第一步拿到的 App ID 和 App Secret 填进来：
JSON{ "channels": { "feishu": { "enabled": true, "dmPolicy": "open", "groupPolicy": "open", "accounts": { "main": { "appId": "cli_xxxx1（替换成你的）", "appSecret": "替换成你的 secret" }, "dev": { "appId": "cli_xxxx2", "appSecret": "替换成你的 secret" }, "content": { "appId": "cli_xxxx3", "appSecret": "替换成你的 secret" }, "ops": { "appId": "cli_xxxx4", "appSecret": "替换成你的 secret" }, "law": { "appId": "cli_xxxx5", "appSecret": "替换成你的 secret" }, "finance": { "appId": "cli_xxxx6", "appSecret": "替换成你的 secret" } } } } }
说明：
accounts里的 key（main、dev、content...）要跟 agents.list 里的 id 对应dmPolicy: "open"— 私聊不需要配对，直接能用-
groupPolicy: "open"— 群聊也直接能用
2.3 配置 bindings（路由规则）
告诉 OpenClaw：哪个飞书 bot 的消息交给哪个 Agent 处理。
JSON{ "bindings": [ { "agentId": "main", "match": { "channel": "feishu", "accountId": "main" } }, { "agentId": "dev", "match": { "channel": "feishu", "accountId": "dev" } }, { "agentId": "content", "match": { "channel": "feishu", "accountId": "content" } }, { "agentId": "ops", "match": { "channel": "feishu", "accountId": "ops" } }, { "agentId": "law", "match": { "channel": "feishu", "accountId": "law" } }, { "agentId": "finance", "match": { "channel": "feishu", "accountId": "finance" } } ] }
原理很简单： 给"开发助理"飞书 bot 发消息 → OpenClaw 通过 bindings 匹配到 accountId 是 "dev" → 交给 agentId 为 "dev" 的 Agent 处理。
2.4 开启 Agent 间通信（可选但推荐）
让 Agent 之间能互相发消息协作：
JSON{ "tools": { "agentToAgent": { "enabled": true, "allow": ["main", "dev", "content", "ops", "law", "finance"] } } }
开启后，大总管可以调度其他助理完成任务，然后把结果汇报给你。
第三步：给每个 Agent 写人设文件
每个 Agent 的 workspace 目录下需要创建几个关键文件：
SOUL.md — Agent 的灵魂
定义这个 Agent 是谁、怎么说话、怎么干活。
示例：开发助理的 SOUL.md（放在 /root/.openclaw/workspace-dev/SOUL.md）
Markdown# SOUL.md - 开发助理 你是俊哥的开发助理，专注于代码开发、技术架构和部署。 ## 核心职责 - 写代码、调试、代码审查 - 技术方案设计和架构建议 - 部署和运维（Cloudflare Workers, Pages, D1 等） - 阅读和分析开源项目源码 ## 工作风格 - 技术精准，回答简洁 - 直接给方案和代码，少说废话 - 遇到不确定的问题，先调研再回答 ## 禁止 - 不要编造不存在的 API 或函数 - 不确定的事情要说明，不要瞎猜
AGENTS.md — 团队通讯录
让每个 Agent 知道团队里有谁、怎么联系。
示例（每个 Agent 的 workspace 下都放一份）：
Markdown# AGENTS.md ## 🏢 OPC 团队成员 你是 OPC 团队的一员，以下是你的同事： - **main**（大总管小夏 🌸）— 统筹全局、调度团队、汇报结果 - **dev**（开发助理 💻）— 代码开发、技术架构、部署 - **content**（内容助理 ✍️）— 公众号文章、文案、内容创作 - **ops**（运营增长 📈）— 用户增长、社交媒体、市场推广 - **law**（法务助理 ⚖️）— 合同审查、合规咨询 - **finance**（财务助理 💰）— 成本核算、预算管理 需要跨部门协作时，用 sessions_send 工具联系对方，agentId 填对方的 id。
USER.md — 你是谁
让 Agent 知道它在给谁干活：
Markdown# USER.md - **Name:** 你的名字 - **时区:** UTC+8 - **备注:** 你的其他信息
IDENTITY.md — Agent 的身份卡片（可选）
Markdown# IDENTITY.md - **Name:** 开发助理 - **Emoji:** 💻 - **Vibe:** 技术宅，高效务实
第四步：重启 OpenClaw
配置改完后，重启 Gateway 让配置生效：
Bashopenclaw gateway restart
第五步：验证
检查所有通道状态
Bashopenclaw channels status --probe
你应该看到类似这样的输出：
PlainFeishu main: enabled, configured, running, works ✅ Feishu dev: enabled, configured, running, works ✅ Feishu content: enabled, configured, running, works ✅ Feishu ops: enabled, configured, running, works ✅ Feishu law: enabled, configured, running, works ✅ Feishu finance: enabled, configured, running, works ✅
6 个全是 running, works 就成功了！
测试
- 打开飞书，找到"开发助理"机器人，给它发一条消息："你是谁？"
- 它应该会按照 SOUL.md 里定义的人设回复
- 再找"内容助理"发一条，确认是不同的人设
1.
踩坑指南
坑一：飞书应用没开"长连接事件订阅"
表现： 机器人发消息没反应
解决： 去飞书开放平台 → 应用设置 → 事件与回调 → 确认是「长连接」模式，不是 HTTP 回调
坑二：权限没开够
表现： 收到消息但回复报错
解决： 确认开通了 im:message、im:message:send_as_bot 权限，并且应用已发布
坑三：应用没发布/没审批
表现： 找不到机器人
解决： 去「版本管理与发布」创建版本并提交审批
坑四：workspace 目录不存在
表现： Agent 启动报错
解决： 提前创建好目录：
Bashmkdir -p /root/.openclaw/workspace-dev mkdir -p /root/.openclaw/workspace-content mkdir -p /root/.openclaw/workspace-ops mkdir -p /root/.openclaw/workspace-law mkdir -p /root/.openclaw/workspace-finance
坑五：AGENTS.md 没写团队成员
表现： 大总管想调度其他助理，但不知道有谁
解决： 每个 Agent 的 workspace 下都放一份 AGENTS.md，写明团队成员列表
坑六：群里不回复 / 回复跑到私聊
表现： 在群里 @ 机器人，它私聊回你而不是在群里回
解决： 配置里加上 "dmPolicy": "open" 和 "groupPolicy": "open"
完整配置示例
把以上所有配置整合在一起，放在 ~/.openclaw/openclaw.json 里：
JSON{ "agents": { "list": [ { "id": "main", "default": true, "name": "大总管小夏", "workspace": "/root/.openclaw/workspace" }, { "id": "dev", "name": "开发助理", "workspace": "/root/.openclaw/workspace-dev" }, { "id": "content", "name": "内容助理", "workspace": "/root/.openclaw/workspace-content" }, { "id": "ops", "name": "运营增长", "workspace": "/root/.openclaw/workspace-ops" }, { "id": "law", "name": "法务助理", "workspace": "/root/.openclaw/workspace-law" }, { "id": "finance", "name": "财务助理", "workspace": "/root/.openclaw/workspace-finance" } ] }, "channels": { "feishu": { "enabled": true, "dmPolicy": "open", "groupPolicy": "open", "accounts": { "main": { "appId": "你的 App ID", "appSecret": "你的 App Secret" }, "dev": { "appId": "你的 App ID", "appSecret": "你的 App Secret" }, "content": { "appId": "你的 App ID", "appSecret": "你的 App Secret" }, "ops": { "appId": "你的 App ID", "appSecret": "你的 App Secret" }, "law": { "appId": "你的 App ID", "appSecret": "你的 App Secret" }, "finance": { "appId": "你的 App ID", "appSecret": "你的 App Secret" } } } }, "bindings": [ { "agentId": "main", "match": { "channel": "feishu", "accountId": "main" } }, { "agentId": "dev", "match": { "channel": "feishu", "accountId": "dev" } }, { "agentId": "content", "match": { "channel": "feishu", "accountId": "content" } }, { "agentId": "ops", "match": { "channel": "feishu", "accountId": "ops" } }, { "agentId": "law", "match": { "channel": "feishu", "accountId": "law" } }, { "agentId": "finance", "match": { "channel": "feishu", "accountId": "finance" } } ], "tools": { "agentToAgent": { "enabled": true, "allow": ["main", "dev", "content", "ops", "law", "finance"] } } }
⚠️ 注意：这只是多 Agent 相关的配置。你的实际配置文件里还有 models、auth、gateway 等其他内容，不要覆盖它们。建议用
openclaw config patch或让 AI 帮你合并。
目录结构一览
配置完成后，你的文件结构大概长这样：
Plain~/.openclaw/ ├── openclaw.json ← 主配置文件 ├── workspace/ ← 大总管的工作区 │ ├── SOUL.md │ ├── AGENTS.md │ ├── USER.md │ └── memory/ ├── workspace-dev/ ← 开发助理的工作区 │ ├── SOUL.md │ ├── AGENTS.md │ ├── USER.md │ └── memory/ ├── workspace-content/ ← 内容助理的工作区 │ ├── SOUL.md │ ├── AGENTS.md │ ├── USER.md │ └── memory/ ├── workspace-ops/ ← 运营增长的工作区 ├── workspace-law/ ← 法务助理的工作区 └── workspace-finance/ ← 财务助理的工作区
每个 workspace 是独立的世界。Agent 之间互不干扰，但可以通过 agentToAgent 通信协作。
总结
| 步骤 | 做什么 | 在哪做 |
|---|---|---|
| 1 | 创建 N 个飞书应用 | 飞书开放平台 |
| 2 | 每个应用开机器人+长连接+权限+发版 | 飞书开放平台 |
| 3 | 配 agents.list（定义 Agent） | openclaw.json |
| 4 | 配 channels.feishu.accounts（填凭证） | openclaw.json |
| 5 | 配 bindings（路由规则） | openclaw.json |
| 6 |
就这 9 步，你的飞书 AI 团队就上线了。 🦞