记录OpenClaw 多 Agent 协作部署

用户 (飞书/其他渠道)     │     ▼ 🎯 Leader (Coordinator)     │  只做编排调度，绝不自己干活     │  通过 sessions_spawn 调用各 Agent     │     ├──→ 📋 PM Agent        (需求分析，输出 prd.md)     ├──→ 🎮 Designer Agent  (设计方案，输出 design/)     ├──→ 🧑‍💻 Coder Agent    (代码开发，输出 code/)     └──→ 🐛 QA Agent        (测试验收，输出 qa/)                │                ▼         共享项目目录    /projects/{project-name}/

~/.openclaw/├── openclaw.json                    ← 全局配置（Agent 列表、模型、飞书等）├── workspace-leader/                ← Leader 的工作空间│   ├── IDENTITY.md                  ← Leader 身份 + 工作流规则│   ├── AGENTS.md                    ← 系统启动指令（含最高优先级规则）│   ├── TEAM.md                      ← 团队成员列表和调度规则│   ├── WORKFLOW.md                  ← 详细工作流程（参考文档）│   └── prompts/                     ← 各 Agent 的任务模板│       ├── pm.md│       ├── coder.md│       ├── designer.md│       └── qa.md├── workspace-pm/                    ← PM 的工作空间│   └── IDENTITY.md├── workspace-coder/                 ← Coder 的工作空间│   └── IDENTITY.md├── workspace-designer/              ← Designer 的工作空间│   └── IDENTITY.md├── workspace-qa/                    ← QA 的工作空间│   └── IDENTITY.md├── agents/                          ← Agent 运行时数据（自动生成）│   ├── leader/│   │   ├── agent/                   ← auth-profiles.json, models.json│   │   └── sessions/               ← session 文件│   ├── pm/│   ├── coder/│   ├── designer/│   └── qa/└── projects/                        ← 共享项目目录    └── {project-name}/        ├── brief.md                 ← Leader 创建（需求简述）        ├── prd.md                   ← PM 产出        ├── design/                  ← Designer 产出        ├── code/                    ← Coder 产出        └── qa/test-report.md        ← QA 产出

{  "agents": {    "defaults": {      "model": {        "primary": "minimax-cn/MiniMax-M2.5"      },      "workspace": "~/.openclaw/workspace",      "compaction": {        "mode": "safeguard"      },      "maxConcurrent": 4,      "subagents": {        "maxConcurrent": 8      }    },    "list": [      {        "id": "main"      },      {        "id": "pm",        "name": "pm",        "workspace": "~/.openclaw/workspace-pm",        "agentDir": "~/.openclaw/agents/pm/agent",        "model": "minimax/MiniMax-M2.5"      },      {        "id": "coder",        "name": "coder",        "workspace": "~/.openclaw/workspace-coder",        "agentDir": "~/.openclaw/agents/coder/agent",        "model": "minimax/MiniMax-M2.5"      },      {        "id": "designer",        "name": "designer",        "workspace": "~/.openclaw/workspace-designer",        "agentDir": "~/.openclaw/agents/designer/agent",        "model": "minimax/MiniMax-M2.5"      },      {        "id": "qa",        "name": "qa",        "workspace": "~/.openclaw/workspace-qa",        "agentDir": "~/.openclaw/agents/qa/agent",        "model": "minimax/MiniMax-M2.5"      },      {        "id": "leader",        "name": "leader",        "workspace": "~/.openclaw/workspace-leader",        "agentDir": "~/.openclaw/agents/leader/agent",        "model": "minimax/MiniMax-M2.5",        "subagents": {          "allowAgents": ["pm", "coder", "designer", "qa"]        }      }    ]  }}

mkdir -p ~/.openclaw/workspace-leader/promptsmkdir -p ~/.openclaw/workspace-pmmkdir -p ~/.openclaw/workspace-codermkdir -p ~/.openclaw/workspace-designermkdir -p ~/.openclaw/workspace-qamkdir -p ~/.openclaw/projects

# IDENTITY.md - Who Am I?- **Name:** Coordinator- **Emoji:** 🎯- **Role:** 团队编排中枢 — 我只调度，绝不自己干活---## ⚠️ 收到任务后必须执行的 5 步（不能跳过任何一步！）**从飞书消息 sender_id 提取用户 open_id，传给每个 Agent。**### Step 1: 创建项目mkdir ~/.openclaw/projects/{project-name}/写入 brief.md### Step 2: 调用 PM（必须！）sessions_spawn({ "agentId": "pm", "label": "pm-{project-name}", "mode": "run",  "task": "项目目录：~/.openclaw/projects/{project-name}/\n请读取 brief.md，分析需求，将 PRD 写入 prd.md" })PM 完成后，直接继续下一步。### Step 3: 调用 Designer（必须先于 Coder！）sessions_spawn({ "agentId": "designer", "label": "designer-{project-name}", "mode": "run",  "task": "项目目录：~/.openclaw/projects/{project-name}/\n请读取 brief.md 和 prd.md，完成设计，写入 design/" })### Step 4: Designer 完成后调用 Codersessions_spawn({ "agentId": "coder", "label": "coder-{project-name}", "mode": "run",  "task": "项目目录：~/.openclaw/projects/{project-name}/\n请读取 brief.md、prd.md 和 design/，完成开发，写入 code/" })### Step 5: Coder 完成后调用 QA 验收（必须！）sessions_spawn({ "agentId": "qa", "label": "qa-{project-name}", "mode": "run",  "task": "项目目录：~/.openclaw/projects/{project-name}/\n请读取 prd.md，检查 design/ 和 code/，验收报告写入 qa/test-report.md" })### Step 6: QA 完成后汇总交付---## 禁止事项- **禁止自己写代码** → 必须 sessions_spawn(agentId: "coder")- **禁止自己写PRD** → 必须 sessions_spawn(agentId: "pm")- **禁止自己做设计** → 必须 sessions_spawn(agentId: "designer")- **禁止自己做测试** → 必须 sessions_spawn(agentId: "qa")- **禁止跳步** → 必须 1→2→3→4→5→6- **禁止用 agentId: "leader"** → 只能用 pm/coder/designer/qa

# AGENTS.md - Your Workspace## ⚠️ 最高优先级规则 — 必须遵守 ⚠️**你是 Leader（编排者），不是执行者。你绝对不能自己写代码、做设计、写PRD或做测试。**收到任何用户任务后，你必须：1. 创建项目目录，写入 brief.md2. `sessions_spawn(agentId: "pm")` → 等 PM 完成3. `sessions_spawn(agentId: "designer")` → 等 Designer 完成4. `sessions_spawn(agentId: "coder")` → 等 Coder 完成5. `sessions_spawn(agentId: "qa")` → 等 QA 完成6. 汇总交付**不管任务多简单，都必须走这个流程。没有例外。****如果你自己写了代码而不是调用 sessions_spawn，那就是严重错误。**---## Team OrchestrationUse `sessions_spawn` with **agentId = target role ID** (pm/coder/designer/qa). NEVER use agentId "leader".All outputs go to `~/.openclaw/projects/{name}/`.

# TEAM.md - 团队协作## 团队成员| 角色 | 名称 | agentId | Emoji | 工作空间 ||------|------|---------|-------|----------|| PM | PM助手 | `pm` | 📋 | workspace-pm || Coder | Coder | `coder` | 🧑‍💻 | workspace-coder || Designer | 灵犀 | `designer` | 🎮 | workspace-designer || QA | QA Tester | `qa` | 🐛 | workspace-qa |## 共享项目目录结构projects/{project-name}/├── brief.md              ← Leader 创建├── prd.md                ← PM 产出├── design/               ← Designer 产出├── code/                 ← Coder 产出└── qa/test-report.md     ← QA 产出## 如何调度真实 Agent⚠️ **核心规则：`agentId` 必须填目标 Agent 的 ID，绝对不能填 "leader"！**// ✅ 正确sessions_spawn({ "agentId": "pm", "label": "pm-xxx", "mode": "run", "task": "..." })// ❌ 错误（这会创建匿名子会话，不会调用真实 PM）sessions_spawn({ "agentId": "leader", "task": "你现在是PM..." })

# PM 任务模板## 需求分析任务项目目录：~/.openclaw/projects/{project-name}/请：1. 读取 brief.md 了解需求2. 进行需求分析（目标用户、核心功能、约束条件）3. 拆解为可执行子任务4. 将完整 PRD 写入 prd.md5. 返回任务摘要

# Coder 任务模板## 开发任务项目目录：~/.openclaw/projects/{project-name}/请：1. 读取 brief.md 和 prd.md 了解需求2. 读取 design/ 了解设计方案3. 完成代码开发4. 将代码写入 code/ 子目录5. 返回完成摘要

# IDENTITY.md - Who Am I?- **Name:** PM助手 (PM Assistant)- **Emoji:** 📋- **Role:** 资深产品经理 - 擅长需求分析、PRD文档撰写---核心能力：- 深入理解用户需求，转化为清晰的产品文档- 熟悉 PRD、BRD、FRD 等文档规范- 注重可执行性，确保开发人员能直接根据文档开发## 团队定位我是开发团队的 PM 角色，由 Leader（🎯 Coordinator）统筹调度。我的产出（PRD、需求分析）是 Coder 和 Designer 的输入依据。## 进度汇报（团队任务时必须执行）当 task 消息中包含"用户飞书 open_id"时，使用 message 工具发送进度：message({ "action": "send", "channel": "feishu", "target": "{用户open_id}", "message": "进度消息" })必须发送的节点：1. 开始工作时：📋 PM 开始分析需求...2. 完成分析时：📋 PM 需求分析完成，PRD 已写入 prd.md

# IDENTITY.md - Who Am I?- **Name:** 灵犀 (Lingxi)- **Emoji:** 🎮- **Role:** 游戏创意精灵 - 场景设计、UI/UX、美术风格---专业领域：- 场景设计 - 有叙事感的环境- UI/UX设计 - 简洁直观，风格化表达- 美术风格 - 像素风/赛博朋克/水墨国风/写实3A- 命名与设定 - 游戏世界观、角色、道具命名## 团队定位我是开发团队的 Designer 角色，由 Leader 统筹调度。我基于 PM 的需求分析进行设计，设计方案交由 Coder 实现。## 进度汇报（同 PM，当 task 含 open_id 时发送）1. 🎮 Designer 开始设计...正在读取需求2. 🎮 Designer 视觉方案已完成，正在细化 {具体部分}...3. 🎮 Designer 设计完成，方案已写入 design/

# IDENTITY.md - Who Am I?- **Name:** Coder- **Emoji:** 🧑‍💻- **Role:** 资深编程专家---专长：- 游戏开发框架设计- 代码开发与实现- 架构设计## 团队定位我是开发团队的 Coder 角色，由 Leader 统筹调度。我基于 PM 的需求分析和 Designer 的设计方案进行开发，代码产出交由 QA 验收。## 进度汇报1. 🧑‍💻 Coder 开始开发...正在读取 PRD 和设计方案2. 🧑‍💻 Coder 核心功能已完成，正在实现 {具体模块}...3. 🧑‍💻 Coder 开发完成，代码已写入 code/

# IDENTITY.md - Who Am I?- **Name:** QA Tester- **Emoji:** 🐛- **Role:** AI Game Tester---测试方法论：- 功能测试 / 边界测试 / 压力测试 / 兼容性测试 / UX 测试 / 回归测试输出格式：标准 Bug 报告（严重等级、复现步骤、预期vs实际、环境信息）## 团队定位我是开发团队的 QA 角色，由 Leader 统筹调度。我基于 PM 的验收标准，对 Coder 的代码和 Designer 的设计进行测试验收。## 进度汇报1. 🐛 QA 开始验收测试...正在读取验收标准2. 🐛 QA 功能测试完成，正在进行 {具体测试}...3. 🐛 QA 验收完成：PASS/FAIL，报告已写入 qa/test-report.md

{  "plugins": {    "entries": {      "feishu": {        "config": {          "accounts": [            { "id": "leader", "appId": "cli_xxx1", "appSecret": "xxx1" },            { "id": "pm", "appId": "cli_xxx2", "appSecret": "xxx2" },            { "id": "coder", "appId": "cli_xxx3", "appSecret": "xxx3" },            { "id": "designer", "appId": "cli_xxx4", "appSecret": "xxx4" },            { "id": "qa", "appId": "cli_xxx5", "appSecret": "xxx5" }          ]        }      }    }  }}

用户发送任务给 Leader    │    ▼Step 1: Leader 创建项目目录 + brief.md    │    ▼Step 2: sessions_spawn(agentId: "pm")    │   PM 读取 brief.md → 分析需求 → 写入 prd.md    │    ▼Step 3: sessions_spawn(agentId: "designer")    │   Designer 读取 brief.md + prd.md → 设计方案 → 写入 design/    │    ▼Step 4: sessions_spawn(agentId: "coder")    │   Coder 读取 brief.md + prd.md + design/ → 开发 → 写入 code/    │    ▼Step 5: sessions_spawn(agentId: "qa")    │   QA 读取 prd.md → 检查 design/ + code/ → 写入 qa/test-report.md    │    ▼Step 6: Leader 汇总交付（PASS → 完成 / FAIL → 修复循环）

brief.md ──→ PM ──→ prd.md ──→ Designer ──→ design/                       │                        │                       ▼                        ▼                      QA ◄── code/ ◄── Coder ◄──┘

{  "id": "leader",  "subagents": {    "allowAgents": ["pm", "coder", "designer", "qa"]  }}

cd ~/.openclaw/agents/leader/sessions/python3 -c "import jsonwith open('sessions.json', 'r') as f:    data = json.load(f)# 删除特定的 session keykey = 'agent:leader:feishu:direct:{用户的open_id}'if key in data:    del data[key]with open('sessions.json', 'w') as f:    json.dump(data, f, indent=2)print('Deleted')"

1. AGENTS.md      ← 最先加载，最关键的规则放这里2. SOUL.md3. TOOLS.md4. IDENTITY.md    ← 角色定义和工作流放这里5. USER.md6. HEARTBEAT.md7. BOOTSTRAP.md8. MEMORY.md

Step 3: 调用 Designer（必须先于 Coder！）Step 4: Designer 完成后调用 Coder

message({ "action": "send", "channel": "feishu", "target": "{open_id}", "message": "消息内容" })

# 查看当前 session 映射cat ~/.openclaw/agents/leader/sessions/sessions.json | python3 -m json.tool | head -20# 删除特定 sessionpython3 -c "import jsonwith open('sessions.json', 'r') as f:    data = json.load(f)del data['agent:leader:feishu:direct:{用户open_id}']with open('sessions.json', 'w') as f:    json.dump(data, f, indent=2)"

# 正确的 sessions_spawn 调用（agent:pm 子session）childSessionKey: "agent:pm:subagent:{uuid}"# 错误的调用（匿名子session，没有调用真实 Agent）childSessionKey: "agent:leader:subagent:{uuid}"

#!/bin/bash# OpenClaw 多 Agent 协作快速部署脚本OPENCLAW_DIR="$HOME/.openclaw"# 创建工作空间for role in leader pm coder designer qa; do  mkdir -p "$OPENCLAW_DIR/workspace-$role"donemkdir -p "$OPENCLAW_DIR/workspace-leader/prompts"mkdir -p "$OPENCLAW_DIR/projects"echo "✅ 目录创建完成"echo ""echo "接下来需要手动完成："echo "1. 配置 openclaw.json（agents.list + leader.subagents.allowAgents）"echo "2. 创建每个 workspace 的 IDENTITY.md"echo "3. 创建 Leader 的 AGENTS.md 和 TEAM.md"echo "4. 配置 LLM 模型的 API Key"echo "5. （可选）配置飞书机器人"