Subagent Spawning Patterns

子代理并发调度模式

适用场景

把复杂任务拆成多个子代理并行执行，提升夜间自动化吞吐。；| 内置 | cron | 定时触发并发任务 | OpenClaw Built-in |

功能说明

子代理并发调度模式

把复杂任务拆成多个子代理并行执行，提升夜间自动化吞吐。

这个案例能帮你做什么

• 在 Skill、Agent、Cron、Chat 四种场景下稳定拉起子代理。
• 对重任务做并发拆分，减少主会话阻塞。
• 用统一参数和调试方法，降低“拉起失败/结果丢失”的排障成本。

你需要的 Skills（按类型）

快速体验版（先跑一轮）

先跑 1 个 researcher 子代理，验证链路：

你是我的 OpenClaw 助手。
请帮我做“子代理并发调度”的预演版：
1. 使用 sessions_spawn 拉起一个 researcher 子代理。
2. 任务内容：Research OpenClaw documentation。
3. timeoutSeconds 设为 60。
4. 返回结果后输出一段摘要。
5. 如果超时或失败，给出重试建议。

稳定自动版（可长期运行）

1) 四种常见拉起方式

2) Chat 命令（OpenClaw 2026.2.17+）

/subagents spawn <agent-id> <task>

示例：

/subagents spawn researcher "Find recent papers on transformer architectures"

3) Skill 内并发示例

async function researchTopics(topics) {
  const promises = topics.map(topic =>
    sessions_spawn({
      agentId: "researcher",
      task: `Research: ${topic}. Find pricing, features, and reviews.`,
      label: `research-${topic.replace(/\s+/g, '-')}`,
      cleanup: "delete"
    })
  );

  const results = await Promise.all(promises);
  return results.map((result, i) => ({
    topic: topics[i],
    findings: result
  }));
}

4) OpenClaw 执行提示词（自动版）

你是我的 OpenClaw 助手，请执行“子代理并发调度模式”。
请使用 sessions_spawn。

执行规则：
1. 收到复杂任务后先拆分子任务。
2. 为每个子任务选择合适 agentId。
3. 使用 sessions_spawn 创建子代理，并设置 label 便于追踪。
4. 对所有子代理结果执行等待与汇总，不要 fire-and-forget。
5. 对超时任务给出重试或降级方案。

参数约定：
- agentId：必须存在于 agents.list
- task：明确、可执行
- label：可追踪（建议唯一）
- timeoutSeconds：按任务复杂度设置
- cleanup："delete" 或 "keep"

5) 调试命令

openclaw config get | jq '.agents.list[].id'
openclaw sessions list
tail -f ~/.openclaw/gateway.log | grep spawn

常见错误与修正

• 错误：spawn 后不等待结果。
  修正：使用 await sessions_spawn(...) 等待返回。
• 错误：agentId 拼错或未配置。
  修正：先用 openclaw config get | jq '.agents.list[].id' 校验。
• 错误：小任务也盲目 spawn。
  修正：仅在任务耗时较长、需要并行或隔离时使用。

使用建议

• 任务预计 >2-3 分钟、且可并行时再启用 spawn。
• 需要保留会话排错时把 cleanup 设为 keep。
• 多子代理共用上下文时，优先在配置中显式指定 workspace。

成功标准

• 完整执行workflow并达成预期结果

源文件

来源：awesome-openclaw-zh
原始文件：subagent-spawning-patterns.md