OpenClaw 飞书多 Agent 配置教程(破局星球版) | 彭涛·出海圈一个 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 列表
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 间通信(可选但推荐)
JSON
{
"tools": {
"agentToAgent": {
"enabled": true,
"allow": ["main", "dev", "content", "ops", "law", "finance"]
}
}
}
开启后,大总管可以调度其他助理完成任务,然后把结果汇报给你。
第三步:给每个 Agent 写人设文件
每个 Agent 的 workspace 目录下需要创建几个关键文件:
SOUL.md — Agent 的灵魂
示例:开发助理的 SOUL.md(放在 /root/.openclaw/workspace-dev/SOUL.md)
Markdown
# SOUL.md - 开发助理
你是俊哥的开发助理,专注于代码开发、技术架构和部署。
## 核心职责
- 写代码、调试、代码审查
- 技术方案设计和架构建议
- 部署和运维(Cloudflare Workers, Pages, D1 等)
- 阅读和分析开源项目源码
## 工作风格
- 技术精准,回答简洁
- 直接给方案和代码,少说废话
- 遇到不确定的问题,先调研再回答
## 禁止
- 不要编造不存在的 API 或函数
- 不确定的事情要说明,不要瞎猜
AGENTS.md — 团队通讯录
示例(每个 Agent 的 workspace 下都放一份):
Markdown
# AGENTS.md
## 🏢 OPC 团队成员
你是 OPC 团队的一员,以下是你的同事:
- **main**(大总管小夏 🌸)— 统筹全局、调度团队、汇报结果
- **dev**(开发助理 💻)— 代码开发、技术架构、部署
- **content**(内容助理 ✍️)— 公众号文章、文案、内容创作
- **ops**(运营增长 📈)— 用户增长、社交媒体、市场推广
- **law**(法务助理 ⚖️)— 合同审查、合规咨询
- **finance**(财务助理 💰)— 成本核算、预算管理
需要跨部门协作时,用 sessions_send 工具联系对方,agentId 填对方的 id。
USER.md — 你是谁
Markdown
# USER.md
- **Name:** 你的名字
- **时区:** UTC+8
- **备注:** 你的其他信息
IDENTITY.md — Agent 的身份卡片(可选)
Markdown
# IDENTITY.md
- **Name:** 开发助理
- **Emoji:** 💻
- **Vibe:** 技术宅,高效务实
第四步:重启 OpenClaw
Bash
openclaw gateway restart
第五步:验证
检查所有通道状态
Bash
openclaw channels status --probe
Plain
Feishu 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 目录不存在
Bash
mkdir -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 | 配 agentToAgent(可选,Agent 间通信) | openclaw.json |
| 7 | 创建 workspace 目录 + 写 SOUL.md 等文件 | 服务器 |
| 8 | 重启 Gateway | 命令行 |
| 9 | 验证 | 飞书里发消息测试 |