基于 OpenClaw 与飞书搭建多 Agent AI 助理团队

对于每个应用，获取并记录以下信息（在"凭证与基础信息"页面）：

• App ID：如 cli_xxx
• App Secret：如 i63Qyyyyy

💡 建议用表格整理，方便后续配置：

步骤 3：配置应用能力（⚠️ 关键步骤）

⚠️ 前置条件：确保已完成 OpenClaw 多 Agent 配置，Gateway 正在运行。

OpenClaw 配置完成后，对每个应用完成以下配置：

3.1 开启机器人能力

1. 进入应用详情 → '权限管理'
2. 开启"机器人能力"
3. 添加必要的权限：
   • im:message (接收消息)
   • im:message:group_at_msg (接收群组 @ 消息)
   • im:message:send_as_bot (发送消息)

3.2 配置事件订阅（⚠️ 长连接）

1. 进入"事件订阅"
2. 选择"长连接"模式
3. 启用以下事件：
   • im.message.receive_v1 (接收消息)
   • im.message.message_read_v1 (消息已读)

⚠️ 重点：必须配置"长连接事件订阅"，否则 Bot 无法上线！

此时 OpenClaw Gateway 已运行，长连接可以正常建立。

3.3 发布应用

1. 进入"版本管理与发布"
2. 创建新版本
3. 填写更新日志
4. 发布（可选择"开发版"或"正式版"）

OpenClaw 多 Agent 配置

部署方式选择

本文使用 腾讯云轻量应用服务器 OpenClaw 镜像 进行部署。

部署流程：

1. 购买腾讯云轻量应用服务器

参考前置准备的内容购买服务器，进入控制台 -> 概要

腾讯提供的 OpenClaw WEB 配置界面（控制台-> 应用管理）如下，但是不支持多 Agent 配置故本次直接修改服务器上的配置文件

2. 配置模型

本文以 GLM-4.7 为例，进入控制台-> 应用管理，选择智普 AI Coding Plan，输入 KEY 保存即可，如下图

3. 登录服务器

根据实际配置选择对应的登录方式进入服务器后台

4. 验证 OpenClaw 安装

# 检查 OpenClaw 版本
openclaw --version
# 查看 Gateway 状态
openclaw gateway status

5. 配置方式选择

腾讯云 OpenClaw 镜像可以通过两种配置方式：

本文采用直接编辑 openclaw.json 的方式，因为：

• Web 界面不支持多 Agent 高级配置
• JSON 配置更灵活，可实现完整功能

5. 编辑配置文件

# 打开配置文件
vi /root/.openclaw/openclaw.json

配置完成后，重启 Gateway 使配置生效：

openclaw gateway restart

步骤 1：创建独立 Workspace

每个 Agent 需要独立的工作空间，确保数据隔离：

# 创建 5 个独立工作区
mkdir -p /root/.openclaw/workspace-boss
mkdir -p /root/.openclaw/workspace-news
mkdir -p /root/.openclaw/workspace-content
mkdir -p /root/.openclaw/workspace-code
mkdir -p /root/.openclaw/workspace-task

步骤 2：编辑 openclaw.json

打开配置文件：

vi /root/.openclaw/openclaw.json

2.1 配置 agents 数组

在 agents 字段中添加 5 个 Agent：

"agents":{"list":[{"id":"aiboss","default":true,"name":"aiboss","workspace":"/root/.openclaw/workspace-boss","model":{"primary":"glmcode/glm-4.7"}},{"id":"aicontent","name":"aicontent","workspace":"/root/.openclaw/workspace-aicontent","model":{"primary":"glmcode/glm-4.7"}},{"id":"ainews","name":"ainews","workspace":"/root/.openclaw/workspace-ainews","model":{"primary":"glmcode/glm-4.7"}},{"id":"aicode","name":"aicode","workspace":"/root/.openclaw/workspace-aicode","model":{"primary":"glmcode/glm-4.7"}},{"id":"aitask","name":"aitask","workspace":"/root/.openclaw/workspace-aitask","model":{"primary":"glmcode/glm-4.7"}}]}

💡 说明：id: Agent 的唯一标识 default: 标记默认 Agent（只有一个为 true） workspace: 独立工作目录路径 model.primary: 使用的模型

2.2 配置飞书多账户

在 channels.feishu 字段中添加 5 个账户：

"channels":{"feishu":{"enabled":true,"accounts":{"aiboss":{"appId":"cli_xxxxxxxxxxxxx","appSecret":"your_app_secret_here"},"aicontent":{"appId":"cli_xxxxxxxxxxxxx","appSecret":"your_app_secret_here"},"ainews":{"appId":"cli_xxxxxxxxxxxxx","appSecret":"your_app_secret_here"},"aitask":{"appId":"cli_xxxxxxxxxxxxx","appSecret":"your_app_secret_here"},"aicode":{"appId":"cli_xxxxxxxxxxxxx","appSecret":"your_app_secret_here"}}}}

💡 注意：accounts 的 key（如 aiboss）要与 Agent ID 对应确保每个账户的 appId 和 appSecret 正确

2.3 配置 bindings 路由

在 bindings 数组中添加消息路由规则：

"bindings":[{"match":{"channel":"feishu","accountId":"aiboss"},"agentId":"aiboss"},{"match":{"channel":"feishu","accountId":"aicontent"},"agentId":"aicontent"},{"match":{"channel":"feishu","accountId":"ainews"},"agentId":"ainews"},{"match":{"channel":"feishu","accountId":"aicode"},"agentId":"aicode"},{"match":{"channel":"feishu","accountId":"aitask"},"agentId":"aitask"}]

💡 说明：match.channel: 固定为 "feishu" match.accountId: 对应飞书账户的 key（如 aiboss） agentId: 消息路由到哪个 Agent

2.4 开启 agentToAgent 通信

在 tools 字段中配置：

"tools":{"agentToAgent":{"enabled":true,"allow":["aiboss","aicontent","ainews","aicode","aitask"]}}

步骤 3：为每个 Agent 创建核心文件

在每个 workspace 中创建以下文件：

3.1 IDENTITY.md（身份信息）

# 以 aiboss 为例
cat > /root/.openclaw/workspace-boss/IDENTITY.md <<'EOF'
# IDENTITY.md - AIBoss
- **Name**: AIBoss
- **Role**: 大总管，团队协调者
- **Emoji**: 👔
- **Vibe**: 专业、高效、有条理
EOF

3.2 SOUL.md（人设和行为准则）

cat > /root/.openclaw/workspace-boss/SOUL.md <<'EOF'
# SOUL.md - AIBoss
你是 AIBoss，大总管，负责团队协调和任务管理。
## 核心职责
- 团队协调和任务分发
- 项目进度跟踪
- 跨 Agent 协作调度
## 工作流程
1. 接收用户需求
2. 分析任务类型
3. 分发给对应的 Agent
4. 跟踪任务进度
5. 汇总结果给用户
## 协作方式
需要其他 Agent 协作时，使用 sessions_send 工具：
- 需要最新资讯？→ sessions_send(agentId="ainews", message="...")
- 需要内容产出？→ sessions_send(agentId="aicontent", message="...")
- 需要技术支持？→ sessions_send(agentId="aicode", message="...")
- 需要任务提醒？→ sessions_send(agentId="aitask", message="...")
EOF

3.3 AGENTS.md（团队成员通讯录）

cat > /root/.openclaw/workspace-boss/AGENTS.md <<'EOF'
# AGENTS.md - 团队成员
- **AIBoss** (你) - 大总管 - agentId: aiboss - 职责：团队协调、任务分发
- **AINews** - 资讯助理 - agentId: ainews - 职责：AI 行业资讯收集、每日推送
- **AIContent** - 内容助理 - agentId: aicontent - 职责：文章写作、视频脚本、社交媒体内容
- **AICode** - 代码助理 - agentId: aicode - 职责：代码审查、技术方案、问题解决
- **AITask** - 任务助理 - agentId: aitask - 职责：任务跟踪、提醒、进度管理
EOF

3.4 MEMORY.md（长期记忆）

cat > /root/.openclaw/workspace-boss/MEMORY.md <<'EOF'
# MEMORY.md - AIBoss 长期记忆
## 项目记录
### 2026-02-23
- 完成飞书多 Agent 系统搭建
- 5 个 Agent 全部上线
## 重要决策
- 使用 OpenClaw 框架
- 部署在腾讯云服务器
- 飞书作为主要沟通渠道
EOF

重复以上步骤，为其他 4 个 Agent 创建对应文件。

步骤 4：重启 OpenClaw Gateway

# 重启 Gateway 使配置生效
openclaw gateway restart
# 查看 Gateway 状态
openclaw gateway status
# 查看日志（确认 Agent 启动）
openclaw logs --follow

踩坑与解决方案

配置过程中容易遇到一些常见问题，这里整理了 6 个典型坑位及解决方案：

坑 1：Bot 无法上线

症状：飞书应用配置完成，但 Bot 状态一直是离线。

原因：未配置"长连接事件订阅"。

解决方案：

1. 进入飞书开放平台 → 应用详情 → '事件订阅'
2. 选择"长连接"模式
3. 启用 im.message.receive_v1 事件
4. 保存并发布应用

💡 提示：这是最容易遗漏的步骤，配置事件订阅后务必重新发布应用。

坑 2：Agent 无法协作

症状：Agent 之间无法通信，协作请求失败。

原因：未配置 AGENTS.md 团队成员列表，Agent 不知道彼此的存在。

解决方案：

在每个 Agent 的 workspace 中创建 AGENTS.md，列出所有团队成员：

# AGENTS.md - 团队成员
- **AIBoss** - agentId: aiboss
- **AINews** - agentId: ainews
- **AIContent** - agentId: aicontent
- **AICode** - agentId: aicode
- **AITask** - agentId: aitask

坑 3：Workspace 数据混乱

症状：不同 Agent 的数据出现混乱或覆盖。

原因：多个 Agent 共用同一个 workspace 路径。

解决方案：

确保每个 Agent 的 workspace 路径独立且不重复：

{"workspace":"/root/.openclaw/workspace-boss"// 每个 Agent 独立路径}

💡 提示：建议 workspace 命名与 Agent ID 保持一致，便于管理。

坑 4：消息路由错误

症状：发给某个 Agent 的消息被路由到了其他 Agent。

原因：bindings 配置中的 accountId 和 agentId 不匹配。

解决方案：

检查 bindings 数组，确保每个飞书账户的 accountId 正确对应到目标 agentId：

{"match":{"channel":"feishu","accountId":"aicode"// 飞书账户标识},"agentId":"aicode"// 目标 Agent ID}

💡 提示：accountId 必须与 channels.feishu.accounts 中定义的 key 完全一致。

坑 5：ID 大小写导致配置失效

症状：配置完成后，Agent 无法启动或消息无法路由。

原因：agent、channels 等 ID 定义使用了大小写混合（如 AIContent、aIBoss），OpenClaw 不能正常处理。

解决方案：

确保所有 ID 定义都是纯小写字母：

// ✅ 正确 - 全小写
{"id":"aiboss","name":"aiboss"}
// ❌ 错误 - 大小写混合
{"id":"AIBoss",// 错误！
"name":"AIContent"// 错误！}

影响范围：

• agents.list[].id - Agent ID 必须小写
• channels.feishu.accounts 的 key - 账户标识必须小写
• bindings[].agentId - Agent ID 引用必须小写
• channels.feishu.accounts 的 key - 必须与 bindings 中的 accountId 对应（全小写）

检查清单：

• 所有 Agent ID 都是纯小写（如 aiboss、aicontent）
• 飞书账户标识都是纯小写（如 aiboss、ainews）
• bindings 中的 accountId 和 agentId 都是纯小写

验证与测试

配置完成后，按以下步骤验证：

1. 检查 Agent 状态

# 查看 Agent 运行状态
openclaw status

期望输出：

Agent: aiboss Status: running ✅
Agent: aicontent Status: running ✅
Agent: ainews Status: running ✅
Agent: aicode Status: running ✅
Agent: aitask Status: running ✅

2. 单 Agent 测试

首次使用需要配对：

第一次向 Bot 发送消息时，会收到配对提示：

OpenClaw: access not configured. Your Feishu user id: ou_xxx
Pairing code: xxxx
Ask the bot owner to approve with: openclaw pairing approve feishu xxxx

在服务器上执行批准命令：

openclaw pairing approve feishu xxxx

批准后即可正常聊天。

测试消息：

在飞书中向每个 Bot 发送测试消息：

• AIBoss：'你好，你是谁？'
• AINews：'今天有什么 AI 资讯？'
• AIContent：'帮我写一个文章大纲'
• AICode：'这段代码有什么问题？'
• AITask：'创建一个任务提醒'

3. Agent 间协作测试

在飞书中 @AIBoss，让它调用其他 Agent：

@AIBoss 帮我让 AINews 推送今天的 AI 资讯

AIBoss 应该能够：

1. 接收你的指令
2. 调用 sessions_send 联系 AINews
3. AINews 执行并返回结果
4. AIBoss 汇总结果给你

4. 检查清单

• 5 个飞书应用全部发布
• OpenClaw Gateway 运行正常
• 5 个 Agent 状态全部显示 running
• 单独向每个 Bot 发送测试消息
• 测试 Agent 间协作

5. 最终效果

附录：完整 openclaw.json 示例

{"meta":{"lastTouchedVersion":"2026.2.9","lastTouchedAt":"2026-02-21T06:24:18.113Z"},"wizard":{"lastRunAt":"2026-02-11T09:47:49.711Z","lastRunVersion":"2026.2.9","lastRunCommand":"onboard","lastRunMode":"local"},"tools":{"agentToAgent":{"enabled":true,"allow":["aiboss","aicontent","ainews","aicode","aitask"]}},"agents":{"list":[{"id":"aiboss","default":true,"name":"aiboss","workspace":"/root/.openclaw/workspace-boss","model":{"primary":"glmcode/glm-4.7"}},{"id":"aicontent","name":"aicontent","workspace":"/root/.openclaw/workspace-aicontent","model":{"primary":"glmcode/glm-4.7"}},{"id":"ainews","name":"ainews","workspace":"/root/.openclaw/workspace-ainews","model":{"primary":"glmcode/glm-4.7"}},{"id":"aicode","name":"aicode","workspace":"/root/.openclaw/workspace-aicode","model":{"primary":"glmcode/glm-4.7"}},{"id":"aitask","name":"aitask","workspace":"/root/.openclaw/workspace-aitask","model":{"primary":"glmcode/glm-4.7"}}]},"bindings":[{"match":{"channel":"feishu","accountId":"aiboss"},"agentId":"aiboss"},{"match":{"channel":"feishu","accountId":"aicontent"},"agentId":"aicontent"},{"match":{"channel":"feishu","accountId":"ainews"},"agentId":"ainews"},{"match":{"channel":"feishu","accountId":"aicode"},"agentId":"aicode"},{"match":{"channel":"feishu","accountId":"aitask"},"agentId":"aitask"}],"messages":{"ackReactionScope":"group-mentions"},"commands":{"native":"auto","nativeSkills":"auto"},"gateway":{"port":18789,"mode":"local","bind":"loopback","controlUi":{"allowInsecureAuth":false},"auth":{"mode":"token","token":"***REDACTED***"},"tailscale":{"mode":"off","resetOnExit":false}},"skills":{"install":{"nodeManager":"npm"}},"plugins":{"entries":{"feishu":{"enabled":true},"qqbot":{"enabled":true},"ddingtalk":{"enabled":true},"wecom":{"enabled":true},"adp-openclaw":{"enabled":true}},"installs":{"qqbot":{"source":"npm","spec":"@sliverp/qqbot@latest","installPath":"/root/.openclaw/extensions/qqbot","version":"1.4.4","installedAt":"2026-02-11T09:48:41.090Z"},"feishu":{"source":"npm","spec":"@openclaw/feishu","installPath":"/root/.openclaw/extensions/feishu","version":"2026.02.22","installedAt":"2026-02-22T09:48:41.090Z"},"ddingtalk":{"source":"npm","spec":"git+https://cnb.cool/lighthouse/lighthousebackend/openclaw-dingtalk.git","installPath":"/root/.openclaw/extensions/ddingtalk","version":"1.2.0","installedAt":"2026-02-11T09:49:01.618Z"},"wecom":{"source":"npm","spec":"git+https://cnb.cool/lighthouse/lighthousebackend/openclaw-wecom.git","installPath":"/root/.openclaw/extensions/wecom","version":"2026.2.5","installedAt":"2026-02-11T09:49:25.555Z"},"adp-openclaw":{"source":"npm","spec":"adp-openclaw","installPath":"/root/.openclaw/extensions/adp-openclaw","version":"0.0.24","installedAt":"2026-02-11T09:49:33.241Z"}}},"models":{"providers":{"glmcode":{"baseUrl":"https://open.bigmodel.cn/api/anthropic","apiKey":"***REDACTED***","api":"anthropic-messages","models":[{"id":"glm-4.7","name":"GLM-4.7"},{"id":"glm-5","name":"GLM-5"},{"id":"glm-4.6","name":"GLM-4.6"},{"id":"glm-4.5-air","name":"GLM-4.5-Air"},{"id":"glm-4.5","name":"GLM-4.5"}]}},"mode":"merge"},"channels":{"qqbot":{"enabled":true,"appId":"10xxxxxx","clientSecret":"***REDACTED***"},"feishu":{"enabled":true,"accounts":{"aiboss":{"appId":"cli_xx","appSecret":"***REDACTED***"},"aicontent":{"appId":"cli_xx","appSecret":"***REDACTED***"},"ainews":{"appId":"cli_xx","appSecret":"***REDACTED***"},"aitask":{"appId":"cli_xx","appSecret":"***REDACTED***"},"aicode":{"appId":"cli_xx","appSecret":"***REDACTED***"}}}}}