跳转至

🚀 OpenClaw 多 Agent 快速上手

5 分钟学会使用 subagents 加速你的 SOUL.md 使命

⚡ 30 秒快速开始

第一步：Spawn 你的第一个子 agent

1
2
3
4
5
6
sessions_spawn({
  task: "搜索关于宇宙大爆炸的最新科学发现",
  runtime: "subagent",
  mode: "run",
  label: "my-first-agent"
})

第二步：查看子 agent 状态

1
subagents(action: "list")

第三步：获取结果

子 agent 完成后会自动汇报结果，你也可以主动询问：

1
2
3
4
sessions_send({
  sessionKey: "my-first-agent",
  message: "请汇报搜索结果"
})

🎯 针对你目标的 5 个即用模板

模板 1：智守项目周进度检查

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
sessions_spawn({
  task: `
    检查智守项目周进度：
    1. 读取 projects/zhishou/docs/01-周进度报告.md
    2. 检查上周任务完成情况
    3. 更新本周进度
    4. 标记任何延期风险
  `,
  runtime: "subagent",
  mode: "run",
  label: "zhishou-weekly"
})

模板 2：CodePilot 项目技术评审

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
sessions_spawn({
  task: `
    CodePilot 技术评审：
    1. 检查 docs/03-技术方案.md 实现进度
    2. 记录技术难点和解决方案
    3. 更新下周开发计划
  `,
  runtime: "subagent",
  mode: "run",
  label: "codepilot-tech"
})

模板 3：真理探索 - 科学话题研究

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
sessions_spawn({
  task: `
    研究主题：量子纠缠
    要求：
    1. 搜索最新科学发现
    2. 解释背后的科学规律
    3. 阐述如何体现造物主智慧
    4. 整理成 800 字科普文章
  `,
  runtime: "subagent",
  mode: "run",
  label: "truth-quantum"
})

模板 4：脱贫资源收集

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
sessions_spawn({
  task: `
    收集脱贫资源：
    1. 免费职业技能培训平台（至少 5 个）
    2. 农村电商成功案例（至少 3 个）
    3. 小额信贷政策详解
    4. 整理成可分享文档
  `,
  runtime: "subagent",
  mode: "run",
  label: "poverty-resources"
})

模板 5：每日品德自检

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
sessions_spawn({
  task: `
    今日品德自检：
    1. 回顾今天所有对话
    2. 检查是否真诚、有帮助
    3. 找出需要道歉或纠正的地方
    4. 生成 3 条改进行动建议
  `,
  runtime: "subagent",
  mode: "run",
  label: "daily-virtue"
})

📊 并行执行多个任务

场景：周一早上同时检查多个项目

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
// 并行 spawn 3 个子 agent
const tasks = [
  {
    task: "智守项目周进度评审",
    label: "zhishou"
  },
  {
    task: "CodePilot 项目周进度评审", 
    label: "codepilot"
  },
  {
    task: "汇总双项目风险和预算",
    label: "summary"
  }
];

tasks.forEach(t => sessions_spawn({
  task: t.task,
  runtime: "subagent",
  mode: "run",
  label: t.label
}));

🔧 常用管理命令

查看所有子 agent

1
subagents(action: "list")

输出示例： 

1
2
3
4
5
[
  {id: "zhishou", status: "running", label: "zhishou-weekly"},
  {id: "codepilot", status: "completed", label: "codepilot-tech"},
  {id: "truth", status: "running", label: "truth-quantum"}
]

给子 agent 发送新指令

1
subagents(action: "steer", target: "zhishou", message: "请优先检查里程碑风险")

终止子 agent

1
subagents(action: "kill", target: "zhishou")

查看子 agent 对话历史

1
sessions_history(sessionKey: "zhishou", limit: 50)

发送消息到子 agent 会话

1
2
3
4
sessions_send({
  sessionKey: "zhishou",
  message: "请生成周报摘要"
})

💡 最佳实践

✅ 这样做

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
// 1. 任务明确具体
sessions_spawn({
  task: "检查 projects/zhishou/docs/01-周进度报告.md 并更新上周任务状态",
  runtime: "subagent",
  mode: "run"
})

// 2. 设置超时
sessions_spawn({
  task: "长期研究任务...",
  timeoutSeconds: 600,  // 10 分钟超时
  runtime: "subagent"
})

// 3. 并行执行独立任务
const tasks = ["任务 1", "任务 2", "任务 3"];
tasks.forEach(t => sessions_spawn({task: t, runtime: "subagent"}));

// 4. 用完清理
sessions_spawn({
  task: "一次性任务",
  cleanup: "delete",  // 完成后自动清理
  runtime: "subagent"
})

❌ 避免这样做

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
// 1. 任务太模糊
sessions_spawn({
  task: "做些有用的事",  // ❌ 太模糊
  runtime: "subagent"
})

// 2. 同时 spawn 太多
for (let i = 0; i < 20; i++) {  // ❌ 太多并发
  sessions_spawn({task: `任务${i}`, runtime: "subagent"});
}

// 3. 不设置超时
sessions_spawn({
  task: "可能很耗时的任务...",  // ❌ 没有超时保护
  runtime: "subagent"
})

🎯 实际工作流示例

场景：准备周五项目汇报

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
// Step 1: 并行收集两个项目信息
sessions_spawn({
  task: "智守项目本周进展、遇到的问题、下周计划",
  runtime: "subagent",
  label: "zhishou-info"
});

sessions_spawn({
  task: "CodePilot 项目本周进展、遇到的问题、下周计划",
  runtime: "subagent",
  label: "codepilot-info"
});

// Step 2: 等待完成后汇总
// （通过 subagents list 检查状态）

// Step 3: 生成汇报文档
sessions_send({
  sessionKey: "zhishou-info",
  message: "请将项目信息整理成汇报格式"
});

sessions_send({
  sessionKey: "codepilot-info",
  message: "请将项目信息整理成汇报格式"
});

🚨 故障排除

问题 1：Subagent 没反应

解决步骤： 

1
2
3
4
5
6
7
8
9
// 1. 检查状态
subagents(action: "list")

// 2. 如果显示 running 但长时间无输出，发送提醒
subagents(action: "steer", target: "xxx", message: "请继续执行")

// 3. 仍然卡住则终止重启
subagents(action: "kill", target: "xxx")
// 重新 spawn

问题 2：结果不符合预期

解决步骤： 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
// 1. 查看执行历史
sessions_history(sessionKey: "xxx", limit: 100)

// 2. 找出理解偏差的地方

// 3. 发送更详细的指令
sessions_send({
  sessionKey: "xxx",
  message: "请重新执行，注意以下几点：1... 2... 3..."
})

问题 3：成本太高

优化方案： 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
// 1. 设置超时限制
sessions_spawn({
  task: "...",
  timeoutSeconds: 300  // 5 分钟
})

// 2. 减少并发数量（建议≤5）

// 3. 用 cleanup 清理完成的会话
sessions_spawn({
  task: "一次性任务",
  cleanup: "delete"
})

📚 进阶学习

文档位置

  • 完整指南：docs/multi-agent-guide.md
  • 配置方案：projects/zhishou/docs/multi-agent-config.md
  • 模板脚本：scripts/multi-agent-templates.js

下一步

  1. ✅ 尝试上面的 5 个即用模板
  2. ✅ 根据自己的需求修改任务描述
  3. ✅ 学习并行执行多个 subagent
  4. ✅ 掌握 subagent 管理命令
  5. ✅ 设计自己的多 agent 工作流

💬 需要帮助？

记住：多 agent 的核心是任务分解 + 并行执行 + 结果汇总

开始实践吧！🚀