什么是子代理
子代理是从当前代理会话中派生出的后台代理任务。它们在独立会话中运行，完成后将结果报告给主代理，非常适合需要并行处理的场景。
核心优势
- 并行处理：主代理不被阻塞，子代理在后台独立执行
- 会话隔离：每个子代理拥有独立的上下文，互不干扰
- 成本优化：可以为子代理分配更便宜的模型处理重复性任务
- 安全限制：子代理默认不继承会话工具，减少越权风险
配置参数
在 openclaw.json5 中配置子代理行为：
{
agents: {
defaults: {
subagents: {
maxSpawnDepth: 2, // 嵌套深度（1-5），默认 1
maxChildrenPerAgent: 5, // 每个代理最多派生子代理数
maxConcurrent: 8, // 全局并发上限
runTimeoutSeconds: 900, // 子任务超时（秒）
model: "minimax/minimax-m2.5", // 子代理使用的模型（可用低成本模型）
archiveAfterMinutes: 60 // 完成后自动归档时间
}
}
}
}
使用方式
通过 /subagents spawn 命令或 sessions_spawn 工具派生子代理：
# 派生一个研究型子代理
openclaw subagents spawn --task "调研 2026 年 AI 代理框架的最新进展" --model "kimi/kimi-k2.5"
实用技巧
- 将耗时的研究任务交给子代理，主代理继续处理即时对话
- 设置
model为低成本模型（如 MiniMax M2.5）处理批量任务，节省开支 - 利用编排模式：一个子代理作为调度员，协调多个工作子代理
- 注意
maxSpawnDepth不要设太大，防止无限递归