OpenClaw 入门实战第 3 期 - 多 Agent 实战:Subagent 协作系统

bash

sessions_spawn --task "任务描述" --label "标签名称" --mode "运行模式"

bash

sessions_send --sessionKey "会话 ID" --message "消息内容"

bash

sessions_yield --message "等待说明"

bash

sessions_list --limit 10 --activeMinutes 30

bash

sessions_history --sessionKey "会话 ID" --limit 50

bash

# 创建架构师 Agent，负责整体架构分析

sessions_spawn \

  --task "你是一个资深软件架构师，擅长分析项目结构和架构设计。请分析指定 GitHub 项目的整体架构，包括：1.项目目录结构 2.核心技术栈 3.模块划分 4.依赖关系 5.架构优缺点" \

  --label "architect-agent" \

  --mode "session" \

  --model "bailian/qwen3.5-plus"

json

{

  "status": "created",

  "sessionKey": "agent:main:subagent:xxx-arch",

  "label": "architect-agent"

}

bash

# 创建审查员 Agent，负责代码质量审查

sessions_spawn \

  --task "你是一个严格的代码审查员，擅长发现代码中的问题和隐患。请审查指定代码：1.代码规范 2.潜在 bug 3.性能问题 4.安全隐患 5.可维护性" \

  --label "reviewer-agent" \

  --mode "session" \

  --model "bailian/qwen3.5-plus"

bash

# 创建修复师 Agent，负责生成修复代码

sessions_spawn \

  --task "你是一个优秀的程序员，擅长编写高质量代码。请根据代码审查报告，生成修复代码：1.修复 bug 2.优化性能 3.改进规范 4.添加注释 5.编写测试" \

  --label "fixer-agent" \

  --mode "session" \

  --model "bailian/qwen3.5-plus"

bash

# 创建文档师 Agent，负责编写技术文档

sessions_spawn \

  --task "你是一个专业的技术文档工程师，擅长编写清晰易懂的技术文档。请根据项目分析和代码审查结果，编写：1.项目概述 2.架构说明 3.API 文档 4.使用指南 5.常见问题" \

  --label "writer-agent" \

  --mode "session" \

  --model "bailian/qwen3.5-plus"

bash

# 1. 发送项目信息给架构师

sessions_send \

  --label "architect-agent" \

  --message "请分析这个 GitHub 项目：https://github.com/xxx/xxx"

# 2. 等待架构师完成

sessions_yield --message "等待架构师分析完成"

# 3. 获取架构师的分析报告（通过 sessions_history 查看）

sessions_history --sessionKey "agent:main:subagent:xxx-arch" --limit 10

# 4. 将分析报告发送给审查员

sessions_send \

  --label "reviewer-agent" \

  --message "这是架构分析报告：[粘贴报告内容]。请基于此进行代码质量审查。"

# 5. 等待审查员完成

sessions_yield --message "等待审查员完成审查"

# 6. 将审查报告发送给修复师

sessions_send \

  --label "fixer-agent" \

  --message "这是审查报告：[粘贴报告内容]。请生成修复代码。"

# 7. 等待修复师完成

sessions_yield --message "等待修复师生成代码"

# 8. 将所有报告发送给文档师

sessions_send \

  --label "writer-agent" \

  --message "这是所有分析报告：[架构报告 + 审查报告 + 修复代码]。请编写完整的技术文档。"

# 9. 等待文档师完成

sessions_yield --message "等待文档师编写文档"

# 10. 汇总所有成果

sessions_history --sessionKey "agent:main:subagent:xxx-writer" --limit 20

bash

# 同时创建 3 个 Subagent 分析不同项目

sessions_spawn --task "分析项目 A" --label "agent-a" &

sessions_spawn --task "分析项目 B" --label "agent-b" &

sessions_spawn --task "分析项目 C" --label "agent-c" &

# 等待所有任务完成

wait

# 查看结果

sessions_list --limit 10

bash

# 审查员发现问题，需要询问架构师

sessions_send \

  --label "architect-agent" \

  --message "我在审查时发现模块 X 和模块 Y 的依赖关系不太清晰，这是设计意图吗？"

# 架构师回复

sessions_send \

  --label "reviewer-agent" \

  --message "是的，这是为了支持插件化扩展。请在审查报告中注明这一点。"

bash

# 架构分析使用强模型

sessions_spawn \

  --task "架构分析" \

  --label "architect" \

  --model "bailian/qwen3.5-plus"

# 文档编写使用性价比模型

sessions_spawn \

  --task "文档编写" \

  --label "writer" \

  --model "bailian/qwen3-plus"

# 代码生成使用专用模型

sessions_spawn \

  --task "代码生成" \

  --label "coder" \

  --model "codex"

bash

# 创建 ACP 会话（需要配置 acp.defaultAgent）

sessions_spawn \

  --task "重构这个项目的代码结构" \

  --runtime "acp" \

  --mode "session" \

  --thread true

bash

# 创建持久会话

sessions_spawn \

  --task "长期项目开发" \

  --label "project-alpha" \

  --mode "session" \

  --thread true

# 后续可以继续发送消息

sessions_send \

  --label "project-alpha" \

  --message "这是新的需求变更，请更新设计"

# 查看完整历史

sessions_history \

  --sessionKey "agent:main:subagent:xxx-alpha" \

  --limit 100

Code

"分析这个项目"

Code

"分析这个 GitHub 项目的代码结构，输出包括：1.目录树结构 2.核心技术栈及版本 3.主要模块及其职责 4.模块间依赖关系图 5.架构优缺点分析。请用 Markdown 格式输出。"

bash

# 使用有意义的标签

--label "frontend-react-agent"

--label "backend-spring-agent"

--label "test-junit-agent"

--label "doc-api-agent"

bash

# 简单任务：60 秒

--timeoutSeconds 60

# 复杂分析：300 秒

--timeoutSeconds 300

# 长期任务：1800 秒（30 分钟）

--timeoutSeconds 1800

bash

# 定期查看活跃会话

sessions_list --activeMinutes 60

# 手动结束不需要的会话（通过 subagents kill）

subagents --action kill --target "session-key"

bash

# 1. 设置合理的超时时间

sessions_spawn --task "..." --timeoutSeconds 300

# 2. 检查会话状态

sessions_list --limit 10

# 3. 查看错误信息

sessions_history --sessionKey "xxx" --limit 20

# 4. 重试或调整任务

sessions_send --label "agent" --message "请重新尝试，这次重点关注..."

bash

# 一次性发送完整任务，避免多次往返

sessions_send \

  --label "agent" \

  --message "请完成以下 5 个任务：1... 2... 3... 4... 5..."

bash

# 只发送必要的信息

# 不要粘贴整个代码库，只发送相关文件

# 使用摘要代替完整内容

bash

# 简单任务使用轻量模型

# 复杂分析使用强大模型

# 平衡效果和成本