OpenClaw 多 Agent 协作深度指南：架构设计、实操配置与进阶模式

~/.openclaw/agents/<agentId>/
├── agent/                    # 身份证件
│   ├── auth-profiles.json    # 认证配置（用哪个 API Key）
│   └── models.json           # 模型配置（用哪个模型）
└── sessions/                 # 私人日记
    ├── <session-id>.jsonl    # 独立的聊天记录
    └── sessions.json         # 会话索引

~/.openclaw/workspace-<agentId>/
├── SOUL.md                   # 灵魂/人格定义
├── AGENTS.md                 # Agent 行为规范
├── USER.md                   # 用户信息
├── PROMPT.md                 # 提示词模板
├── IDENTITY.md               # 身份定义
└── memory/                   # 记忆存储

优先级 1：精确 peer 匹配（DM/群组 ID）
优先级 2：父 peer 匹配（线程继承）
优先级 3：guildId + 角色（Discord 特有）
优先级 4：guildId 单独匹配
优先级 5：teamId（Slack 特有）
优先级 6：accountId 匹配
优先级 7：频道级别匹配
优先级 8：默认 Agent 回退

# 创建一个名为 writer 的写作 Agent，使用 deepseek 模型
openclaw agents add writer \
  --model deepseek/deepseek-chat \
  --workspace ~/.openclaw/workspace-writer

# 创建一个名为 brainstorm 的头脑风暴 Agent，使用 glm-4.7
openclaw agents add brainstorm \
  --model zai/glm-4.7 \
  --workspace ~/.openclaw/workspace-brainstorm

# 创建一个名为 coder 的编码 Agent，使用 claude
openclaw agents add coder \
  --model anthropic/claude-sonnet-4-6 \
  --workspace ~/.openclaw/workspace-coder

# Writer Agent

## 角色
你是一位资深的公众号写作专家，擅长用犀利、真实的视角剖析技术话题。

## 风格
- 开头必须用一个引人入胜的场景或反直觉的观点
- 段落短小精悍，移动端阅读友好
- 善用类比，让小学生也能听懂复杂概念
- 结尾必须有行动号召（CTA）

## 禁忌
- 不使用"众所周知""不言而喻"等空洞词汇
- 不堆砌术语，每个专业名词第一次出现时必须解释

# 工作规范

## 输出格式
- 所有文章使用 Markdown 格式
- 标题层级不超过三级（H2 > H3 > H4）
- 代码块必须标注语言类型

## 工作流程
1. 先列大纲，确认后再展开
2. 每个段落不超过 150 字
3. 完成后自检 SEO 要素

# 用户信息

## 身份
博主，技术自媒体作者，专注 AI 工具和效率提升。

## 偏好
- 语言风格：专业但不学术，有温度
- 目标读者：对 AI 感兴趣的技术人和产品经理
- 发布平台：微信公众号 + 个人博客

# 给 Agent 设置显示名和 emoji
openclaw agents set-identity --agent writer --name "写作助手" --emoji "✍️"
openclaw agents set-identity --agent brainstorm --name "脑暴搭子" --emoji "💡"
openclaw agents set-identity --agent coder --name "代码工匠" --emoji "⚡"

{
  "bindings": [
    {
      "agentId": "writer",
      "match": {
        "channel": "feishu",
        "peer": {
          "kind": "group",
          "id": "oc_abc123..."
        }
      }
    },
    {
      "agentId": "brainstorm",
      "match": {
        "channel": "feishu",
        "peer": {
          "kind": "group",
          "id": "oc_def456..."
        }
      }
    },
    {
      "agentId": "coder",
      "match": {
        "channel": "feishu",
        "peer": {
          "kind": "group",
          "id": "oc_ghi789..."
        }
      }
    }
  ]
}

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_a9f21xxxxx89bcd",
      "appSecret": "w6cPunaxxxxBl1HHtdF",
      "groups": {
        "oc_abc123...": { "requireMention": false },
        "oc_def456...": { "requireMention": false }
      }
    }
  }
}

用户发指令 → 主管 Agent (main) 接收
                ↓
         判断任务类型
        ↙    ↓     ↘
  brainstorm  writer  coder
   (脑暴)    (写作)   (编码)
        ↘    ↓     ↙
         汇总结果
                ↓
         主管 Agent 返回给用户

{
  "tools": {
    "agentToAgent": {
      "enabled": true,
      "allow": ["main", "brainstorm", "writer", "coder"]
    }
  }
}

# Main Agent - SOUL.md

## 角色
你是团队的首席协调官。你的核心职责：

1. **接住需求**：理解用户的原始指令
2. **精准调度**：判断任务类型，分配给对应的专家 Agent
3. **质量把控**：审查专家 Agent 的输出，必要时要求修改
4. **串联全场**：确保多步骤任务不掉链子

## 调度规则
- 头脑风暴、创意发散 → @brainstorm
- 文章撰写、文案优化 → @writer
- 代码编写、技术实现 → @coder
- 简单问答、日常闲聊 → 自己回答

         ┌─────────┐
         │ 用户指令 │
         └────┬────┘
              ↓
      ┌───────────────┐
      │ Supervisor     │
      │ (主管 Agent)   │
      └──┬─────┬───┬──┘
         ↓     ↓   ↓
      ┌───┐ ┌───┐ ┌───┐
      │ A │ │ B │ │ C │
      └───┘ └───┘ └───┘
         ↓     ↓   ↓
      ┌───────────────┐
      │  汇总 & 输出   │
      └───────────────┘

{
  "agents": {
    "list": [
      { "id": "main", "workspace": "~/.openclaw/workspace-main" },
      { "id": "writer", "workspace": "~/.openclaw/workspace-writer" },
      { "id": "coder", "workspace": "~/.openclaw/workspace-coder" }
    ]
  },
  "tools": {
    "agentToAgent": {
      "enabled": true,
      "allow": ["main", "writer", "coder"]
    }
  }
}

         ┌─────────┐
         │ 用户指令 │
         └────┬────┘
              ↓
      ┌───────────────┐
      │   Router       │
      │ (路由分发)     │
      └──┬─────┬───┬──┘
         ↓     ↓   ↓      ← 并行执行
      ┌───┐ ┌───┐ ┌───┐
      │ A │ │ B │ │ C │
      └───┘ └───┘ └───┘
         ↓     ↓   ↓
      ┌───────────────┐
      │  综合 & 输出   │
      └───────────────┘

      ┌─────────┐
      │ 用户指令 │
      └────┬────┘
           ↓
      ┌─────────┐     ┌─────────┐     ┌─────────┐
      │ 调研员  │ ──→ │  写手   │ ──→ │ 校审官  │
      └─────────┘     └─────────┘     └─────────┘
                                           ↓
                                     ┌──────────┐
                                     │ 最终输出  │
                                     └──────────┘

Step 1: @brainstorm "围绕 AI 编程效率展开头脑风暴，给出 5 个选题方向"
Step 2: 用户选定方向后 → @writer "基于以下素材撰写文章：{brainstorm 输出}"
Step 3: 写作完成后 → @coder "检查文章中的代码示例是否正确可运行"
Step 4: main Agent 汇总所有反馈，输出最终版本

            ┌─────────┐
            │ 用户指令 │
            └────┬────┘
                 ↓
         ┌──────────────┐
         │  任务拆解器   │
         └──┬────┬────┬─┘
            ↓    ↓    ↓      ← 同时执行
         ┌───┐ ┌───┐ ┌───┐
         │ A │ │ B │ │ C │
         └─┬─┘ └─┬─┘ └─┬─┘
           ↓     ↓     ↓
         ┌──────────────┐
         │ 结果聚合器    │
         └──────────────┘

单 Agent + 工具
    ↓ （上下文开始污染）
单 Agent + Skills
    ↓ （记忆膨胀、成本失控）
Supervisor + 2-3 专家 Agent
    ↓ （需要更复杂的协作）
Pipeline / Parallel 混合模式

{
  "agents": {
    "list": [
      {
        "id": "writer",
        "sandbox": { "mode": "all", "scope": "agent" },
        "tools": {
          "allow": ["read", "browser"],
          "deny": ["exec", "write"]
        }
      },
      {
        "id": "coder",
        "tools": {
          "allow": ["exec", "read", "write"],
          "deny": ["browser"]
        }
      }
    ]
  }
}

~/.openclaw/skills/           # 全局共享技能
├── web-search/               # 搜索能力（所有 Agent 共用）
├── file-tools/               # 文件操作（所有 Agent 共用）
└── image-gen/                # 图片生成（所有 Agent 共用）

~/.openclaw/workspace-writer/skills/   # Writer 专属技能
├── seo-checker/              # SEO 检查
└── article-template/         # 文章模板

~/.openclaw/workspace-coder/skills/    # Coder 专属技能
├── code-review/              # 代码审查
└── test-runner/              # 测试运行