# 从单兵作战到集团军：OpenClaw 多 Agent 协同实战指南

> **摘要**：当单个 Agent 无法应对复杂任务时，如何组建一支分工明确的 AI 特种部队？本文基于真实对话记录，详解 OpenClaw 多 Agent 协同的核心配置、常见陷阱和实战测试方法。

---

## 一、为什么需要多 Agent 协同？

单个 Agent 再强大，也有能力边界。就像一个人无法同时扮演好"需求分析 + 资料搜集 + 内容创作 + 质量审核"所有角色一样，AI 也需要团队协作。

**核心痛点**：

- 任务太复杂，单个 Agent 上下文容易超限

- 角色混淆，导致输出质量不稳定

- 无法实现"专业的人做专业的事"

**解决方案**：搭建"物理隔离 + 精准协作"的 AI 团队，让每个 Agent 专注自己的核心能力。

---

## 二、团队组建：从 0 到 1 搭建 AI 特种部队

### 2.1 团队角色规划

基于实战经验，一个完整的协作团队至少需要三个核心角色：

| 角色 | 代号 | 职责 | 能力要求 |

|------|------|------|----------|

| **主管** | Director (阿强) | 任务调度、进度跟踪、结果汇总 | 强协调性、清晰的流程控制 |

| **军师** | Mxx (孔明) | 深度分析、策略制定、逻辑推演 | 强推理能力、大上下文窗口 |

| **特工** | Magic (包打听) | 信息搜集、快速响应、执行操作 | 快速搜索、工具调用、文件操作 |

### 2.2 创建 Agent 团队

```bash

# 1. 创建主管 Agent

openclaw agents add director --model zai/glm-4.7 --workspace ~/.openclaw/workspace-director

openclaw agents set-identity --agent director --name "阿强" --emoji "👔"

# 2. 创建军师 Agent

openclaw agents add militarystrategist --model deepseek-chat --workspace ~/.openclaw/workspace-strategist

openclaw agents set-identity --agent militarystrategist --name "孔明" --emoji "🎯"

# 3. 创建特工 Agent

openclaw agents add kxx --model qwen/qwen3.5-397b-a17b --workspace ~/.openclaw/workspace-magic

openclaw agents set-identity --agent kxx --name "包打听" --emoji "🕵️"

# 验证创建

openclaw agents list

```

> **关键**：每个 Agent 必须有独立的 **Workspace**，包含其个性定义（SOUL.md）、身份卡（IDENTITY.md）、职责说明（AGENTS.md），实现物理隔离。

---

## 三、核心配置：打通 Agent 间的"任督二脉"

### 3.1 开启会话可见性（最关键的一步）

修改 `~/.openclaw/openclaw.json`，在 `tools` 部分添加：

```json

{

  "tools": {

    "sessions": {

      "visibility": "all"  // 让 Agent 们能看到彼此的会话

    }

  }

}

```

> ⚠️ **这是最容易遗漏的配置**，没有这个开关，Agent 之间无法互相"看到"，协作无从谈起。

### 3.2 配置 Agent 列表与权限

```json

{

  "agents": {

    "list": [

      {

        "id": "director",

        "name": "阿强",

        "workspace": "~/.openclaw/agents/director/workspace",

        "agentDir": "~/.openclaw/agents/director/agent",

        "tools": {

          "allow": ["sessions_list", "sessions_send", "sessions_history", "read"],

          "deny": ["write", "edit", "exec"]  // 限制主管的写入权限

        }

      },

      {

        "id": "militarystrategist",

        "name": "孔明",

        "workspace": "~/.openclaw/agents/militarystrategist/workspace"

      },

      {

        "id": "kxx",

        "name": "包打听",

        "workspace": "~/.openclaw/agents/kxx/workspace"

      }

    ]

  }

}

```

### 3.3 绑定通信渠道（独立团模式）

如果使用 Telegram，为每个 Agent 绑定独立的 Bot：

```json

{

  "bindings": [

    {

      "agentId": "director",

      "match": { "channel": "telegram", "accountId": "director_bot" }

    },

    {

      "agentId": "militarystrategist",

      "match": { "channel": "telegram", "accountId": "strategist_bot" }

    },

    {

      "agentId": "kxx",

      "match": { "channel": "telegram", "accountId": "kxx_bot" }

    }

  ]

}

```

---

## 四、工作流定义：让 Agent 知道如何协作

### 4.1 主管的 SOUL.md 示例

在 `~/.openclaw/workspace-director/SOUL.md` 中定义：

```markdown

# SOUL.md：阿强 (主管)

## 核心职责

你是一个 AI 团队的部门主管。你的核心职责是：

接单 → 拆解任务 → 调用军师 (孔明) 深度分析 → 调用特工 (包打听) 搜集数据 → 汇总结果并反馈给用户。

## 工作流程

1. 当用户提出复杂需求，首先使用 `sessions_send` 指令，将分析任务分配给军师（孔明）。

2. 收到孔明的分析框架后，将数据搜集任务分配给特工（包打听）。

3. 汇总双方输出，整理成结构化报告回复给用户。

4. 遇到阻塞或异常，立即在群内同步状态。

```

### 4.2 特工的协作协议

在 `H:\openclawWk\workspace-magic\AGENTS.md` 中明确：

```markdown

## 协作协议

**与 Director (阿强) 协作:**

- 接收指令：从 Director 处接收拆解后的子任务

- 主动汇报：任务开始、进行中、完成/阻塞时主动同步状态

- 异常上报：遇到无法独立解决的困难，立即上报 Director

**与 Mxx (孔明) 协作:**

- 提供数据：响应军师的数据请求，提供原始素材

- 执行验证：根据军师的分析结论，执行验证性测试或补充数据

```

---

## 五、实战测试：验证协同是否生效

### 5.1 激活协同模式

在群内发送：

```

/activation always|mention

```

> 此命令让 Agent 响应群里的每一条消息，而不再需要每次都特意 @提及。

### 5.2 报数测试（协调性验证）

在群里发送：

```

【报数测试重启】 @Dxx_bot 启动"后台报数测试"任务：

1. 请在后台依次调用 Kxx_bot 和 Mxx_bot。

2. 让 Kxx 在群里报奇数 (1, 3, 5)，Mxx 在群里报偶数 (2, 4, 6)。

3. 由你（Director）在后台串联，直到报满 10。

4. 最后在群里汇报完整过程和结果。

(注意：请在后台通过 sessions_send 完成协作，不要在群里互相 @ 接龙)

```

**预期行为**：

- 你不会看到三个 Bot 在群里互相@

- 你只会看到 Director 的最终汇总报告

- 后台通过 `sessions_send` 完成所有协调

### 5.3 真实任务测试

在群里发送：

```

请分析 "OpenClaw 的 acpx 插件为什么安装失败"，需要深度调查原因并给出解决方案。@all

```

**预期流程**：

1. Director 接收任务，拆解为"错误日志分析"和"环境检查"

2. 调用 Mxx 分析可能原因

3. 调用 Magic 搜集系统日志、版本信息

4. 汇总形成解决方案报告

---

## 六、避坑指南（亲测有效）

### 6.1 路径问题

- ✅ **使用绝对路径**：在 SOUL.md 中指示 Agent 保存或读取共享文件时，务必使用绝对路径（如 `H:\openclawWk\workspace-magic\...`）

- ❌ **避免相对路径**：不同 Agent 工作区不同，相对路径会导致文件找不到

### 6.2 权限控制

- ✅ **精细化权限**：在 `agent` 配置项里单独设置 `allow`/`deny`

- ❌ **避免全局 deny**：不要在根配置里用全局的 `tools.deny`，这会一棒子打死所有人

### 6.3 会话名与机器人名字

- ✅ **保持一致**：会话名字与机器人名字要相同（如 `agent:kxx:telegram:group...` 对应 `kxx_bot`）

- ❌ **避免混淆**：名字不一致会导致 `sessions_send` 找不到目标

### 6.4 后台通信的错觉

- ✅ **理解机制**：Agent 之间的对话在后台进行，你最终只会看到主管的汇总结果

- ❌ **不要误判**：这不是配置错误，而是设计如此

---

@all 添加提及

  "id": "dxxr",

  "name": "dxxr",

 "groupChat": {

  "mentionPatterns": [

        "@?Dxxx_bot",

        "@all"

      ]

  },

  "workspace": .....

## 七、初始化完成标志

完成以下操作后，表示多 Agent 协同环境搭建完成：

1. ✅ 为每个 Agent 定义 `IDENTITY.md`（身份卡）

2. ✅ 删除 `BOOTSTRAP.md`（表示初始化完成）

3. ✅ 在群内测试 `/activation@all mention` 生效

4. ✅ 报数测试通过，Director 能正确调度其他 Agent

5. ✅ 真实任务测试通过，能产出完整分析报告

---

## 八、总结：从"全能 Bot"到"AI 军团"

让 OpenClaw 的多个智能体联合工作，本质上是**从一个人格分裂的"全能战士"，转型为一支分工明确的"特种部队"**。

**核心要点回顾**：

1. **物理隔离**：每个 Agent 独立工作区，避免任务干扰

2. **权限控制**：精细化配置 `allow`/`deny`，不要过度授权

3. **通信经络**：`sessions.visibility = "all"` 是协作基础

4. **流程定义**：在 SOUL.md 中明确工作流，让 Agent 知道何时调用谁

5. **测试验证**：用报数测试和真实任务验证协同是否生效

通过这种方式，你可以组建一支 7x24 小时在线的、可以自主协作完成复杂任务的 AI 团队。

---

**参考资料**：

- 对话记录：`H:\openclawWk\workspace-magic\workspace\2026\03\02\multiEntity\dialog.md`

- 原始分析：`H:\openclawWk\workspace-magic\workspace\2026\03\02\multiEntity.md`

- OpenClaw 文档：`C:\Users\fly\AppData\Roaming\npm\node_modules\openclaw\docs`

---

_整理时间：2026-03-02 22:08_

_整理者：包打听 (Magic)_