🤖 火一五多智能体协同 (huo15-multi-agent)

> 作者: 火一五信息科技有限公司

> 版本: v2.0.0

> 基于: OpenClaw sessions_spawn

一、核心概念

OpenClaw subagent 架构

主 Agent (depth 0)
    ↓ sessions_spawn
Worker A (depth 1) ─┐
Worker B (depth 1) ─┼─ 执行中...
Worker C (depth 1) ─┘
    ↓ announce 汇报
主 Agent ← 接收结果汇总

二、使用方式

2.1 协调者模式触发

当用户说"帮我同时处理..."时：

用户: "帮我同时分析这三个项目的代码"
  ↓
我: "好的，启动协调者模式，分3个并行任务"
  ↓
使用 sessions_spawn 启动 3 个 Worker
  ↓
Worker 们并行执行，完成后 announce 结果
  ↓
汇总结果，报告给用户

2.2 命令参考

2.3 编程接口

// 派生子 Agent
sessions_spawn({
  task: "分析代码仓库 A",
  label: "code-analyzer-a",
  runTimeoutSeconds: 300
})

// 发送消息给子 Agent
sessions_send(sessionKey, "状态如何？")

// 查看子 Agent 列表
subagents(action="list")

三、工作流程

3.1 启动并行任务

// 并行启动 3 个任务
const results = await Promise.all([
  sessions_spawn({ task: "分析模块 A", label: "module-a" }),
  sessions_spawn({ task: "分析模块 B", label: "module-b" }),
  sessions_spawn({ task: "分析模块 C", label: "module-c" })
])

3.2 等待结果

子 Agent 完成后自动 announce 结果到当前会话。

3.3 汇总报告

// 收集所有结果
const allResults = await Promise.all(
  workerSessions.map(key => sessions_history(key, { limit: 1 }))
)

// 汇总给用户
const summary = synthesizeResults(allResults)

四、配置

4.1 OpenClaw 配置

在 ~/.openclaw/config.json 中启用嵌套：

{
  "agents": {
    "defaults": {
      "subagents": {
        "maxSpawnDepth": 2,
        "maxConcurrent": 8,
        "runTimeoutSeconds": 900
      }
    }
  }
}

4.2 子 Agent 权限

{
  "tools": {
    "subagents": {
      "tools": {
        "allow": ["read", "exec", "process"],
        "deny": ["gateway", "cron"]
      }
    }
  }
}

五、最佳实践

5.1 任务拆分原则

• 每个 Worker 任务独立，不依赖其他 Worker
• 任务时长建议 5-30 分钟
• 避免深度嵌套（depth 2 足够）

5.2 成本控制

// 子 Agent 使用更便宜的模型
sessions_spawn({
  task: "简单分析",
  model: "MiniMax-M2.1"  // 比主 Agent 便宜
})

5.3 错误处理

try {
  const result = await sessions_spawn({
    task: "可能失败的任务"
  })
} catch (e) {
  // 处理超时或失败
  reportError(e)
}

六、与传统方式对比

七、版本历史