OpenClaw 多 Agent 协作搭建与实战标准指南

1. 文档目标与设计原则

本文不讲抽象概念，重点给出可复现、可审计、可扩展的多 Agent 实操方案。

核心目标：

搭建 5 个角色 Agent：orchestrator、researcher、analyst、writer、reviewer
避免“对话混乱、Session 混乱、角色串台”
形成可追溯证据链（中间产物 + 角色边界 + 最终成稿）

设计原则：

单点收敛：只允许 orchestrator 汇总与推进流程。
角色固化：每个 Agent 在自己的 AGENTS.md 有明确职责边界。
结构化协议：上下游统一 TASK/RESULT 格式。
产物留痕：每一步必须写文件，不只在聊天里说“完成了”。
任务隔离：每个任务一个 jobId，目录隔离，避免互相覆盖。

2. 架构总览

2.1 角色职责

media-orchestrator：拆解任务、分发、汇总、判定是否进入下一步
media-researcher：检索资料、给证据、标注冲突
media-analyst：提炼观点、构建论证结构、标风险边界
media-writer：生成可发布初稿/修订稿
media-reviewer：质量门禁（pass/fail）

2.2 流程

orchestrator 生成任务拆解
researcher 产出 research.md
analyst 基于 research 产出 analysis.md
writer 生成 draft.md
reviewer 审核并产出 final.md（或返修）
orchestrator 输出最终结果

2.3 目录约定

Agent 工作区根：output/code/media-agents/workspaces/
文档与模板：output/docs/multi-agent-media/
任务产物：output/articles/<jobId>/

3. 环境准备

先确认 OpenClaw 可用：

openclaw --versionopenclaw agents --help

查看当前 agent 列表：

openclaw agents list --json

4. 创建 5 个 Agent（核心实操）

4.1 创建工作区目录

mkdir-p ~/.openclaw/workspace/output/code/media-agents/workspaces/{media-orchestrator,media-researcher,media-analyst,media-writer,media-reviewer}

4.2 创建 Agent

# 创建任务拆解agentopenclaw agents add media-orchestrator --non-interactive--workspace ~/.openclaw/workspace/output/code/media-agents/workspaces/media-orchestrator --json# 创建搜索资料agentopenclaw agents add media-researcher --non-interactive--workspace ~/.openclaw/workspace/output/code/media-agents/workspaces/media-researcher --json# 创建内容分析agentopenclaw agents add media-analyst --non-interactive--workspace ~/.openclaw/workspace/output/code/media-agents/workspaces/media-analyst --json# 创建编写agentopenclaw agents add media-writer --non-interactive--workspace ~/.openclaw/workspace/output/code/media-agents/workspaces/media-writer --json# 创建审核agentopenclaw agents add media-reviewer --non-interactive--workspace ~/.openclaw/workspace/output/code/media-agents/workspaces/media-reviewer --json

4.3 验证创建结果

openclaw agents list --json

期望结果：出现 5 个新 agentId，并且每个都有独立 workspace 和 agentDir。

5. 角色固化：写入各 Agent 的 AGENTS.md

这是防止角色串台的关键步骤。

每个 agent 的 AGENTS.md 末尾追加角色契约（Role Contract）。示例：

5.1 orchestrator（示例）

## Role Contract: media-orchestratorYou are the coordinator for multi-agent media writing.- Own task decomposition and final merge.- Assign work to `media-researcher`, `media-analyst`, `media-writer`, and `media-reviewer`.- Enforce `jobId` on every task and result.- Accept only structured output using `RESULT` format.- Do not publish final output unless reviewer status is `pass`.- If any subtask fails twice, stop and return blockers + fallback plan.

其余 4 个角色也应写入对应职责边界（检索/分析/写作/审校）。

6. 统一协议：TASK/RESULT 模板

6.1 TASK 输入模板

# TASKjobId: job-YYYYMMDD-001role: researcher|analyst|writer|reviewer## Goal...## Constraints- facts traceable- no fabricated citations- markdown output## Deliverable...## Done Definition- ...

6.2 RESULT 输出模板

# RESULTjobId: job-YYYYMMDD-001role: ...status: pass|fail## Conclusion...## Evidence- ...## Artifacts- path: ...## Risks- ...## Next Step...

7. 一键部署脚本（可直接复制）

创建 deploy.sh：

#!/usr/bin/env bashset-euo pipefailBASE="$HOME/.openclaw/workspace/output/code/media-agents/workspaces"mkdir-p"$BASE"/{media-orchestrator,media-researcher,media-analyst,media-writer,media-reviewer}openclaw agents add media-orchestrator --non-interactive--workspace"$BASE/media-orchestrator"--json || trueopenclaw agents add media-researcher --non-interactive--workspace"$BASE/media-researcher"--json || trueopenclaw agents add media-analyst --non-interactive--workspace"$BASE/media-analyst"--json || trueopenclaw agents add media-writer --non-interactive--workspace"$BASE/media-writer"--json || trueopenclaw agents add media-reviewer --non-interactive--workspace"$BASE/media-reviewer"--json || trueopenclaw agents list --json

执行：

chmod+x deploy.sh./deploy.sh

8. 首次实战：用自然语言触发完整多 Agent 流程

8.1 运行策略

自动生成 jobId（如 job-20260316-002）
自动分配角色任务：researcher -> analyst -> writer -> reviewer
所有中间产物写入：output/articles/<jobId>/

8.2 产物清单（验收依据）

research.md：资料与证据
analysis.md：观点结构与风险边界
draft.md：初稿
final.md：审校后定稿

如果只有 final.md 没有中间链路，通常说明并未真正走完整多 Agent 协作。

9. 如何判断“真多 Agent”而非“单 Agent 假装”

看以下四项即可：

是否存在多角色中间文件（research/analysis/draft/final）
是否每一步有明确 jobId
reviewer 是否给出 pass/fail
是否可回溯每步输入输出关系

满足这四项，基本可确认是实跑的协作流水线。

13. 结论

多 Agent 的价值不在“并行得有多炫”，而在“流程是否可控、结果是否可审计、失败是否可恢复”。

按照本文的目录规范、角色固化和协议约束，你可以在新环境中快速复现一个稳定的内容生产流水线，并持续扩展到更多任务类型（视频脚本、周报、技术白皮书、产品 PRD 等）。