🔄 OpenClaw子Agent创建指南

🎯 什么是子Agent？

子Agent（Subagent）是通过sessions_spawn工具创建的独立Agent实例。它们：

• 在独立的会话中运行，互不干扰
• 可以并行执行任务，提高效率
• 支持不同的运行时环境（subagent/acp）
• 完成后自动清理或保持会话

🛠️ sessions_spawn 详解

核心参数

1. 创建一次性子Agent（run模式）

sessions_spawn({
  task: "分析这份销售数据，找出增长最快的产品类别",
  runtime: "subagent",
  mode: "run",
  model: "claude-3-5-sonnet",
  cleanup: "delete"
})

2. 创建持久会话（session模式）

sessions_spawn({
  task: "你将作为数据分析专家，帮助我处理周报数据",
  runtime: "subagent",
  mode: "session",
  label: "data-analyst",
  cleanup: "keep"
})

3. 创建ACP编程会话

sessions_spawn({
  task: "创建一个Python脚本，实现数据抓取功能",
  runtime: "acp",
  mode: "session",
  agentId: "github-copilot",
  thread: true
})

💡 实战模式

模式1：MapReduce并行处理

// 主任务：分析100篇文档
async function parallelAnalysis(documents) {
  // 1. 将文档分片
  const chunks = chunk(documents, 10);
  
  // 2. 并行创建子Agent处理
  const promises = chunks.map((chunk, index) => 
    sessions_spawn({
      task: `分析文档批次${index+1}，提取关键信息`,
      runtime: "subagent",
      mode: "run",
      attachments: [{
        name: `batch-${index}.txt`,
        content: chunk.join("\n")
      }]
    })
  );
  
  // 3. 收集结果
  const results = await Promise.all(promises);
  
  // 4. 汇总（再创建一个子Agent）
  return sessions_spawn({
    task: `汇总以下分析结果：${JSON.stringify(results)}`,
    runtime: "subagent",
    mode: "run"
  });
}

模式2：流水线处理

// 内容生成流水线
async function contentPipeline(topic) {
  // 第一步：研究
  const research = await sessions_spawn({
    task: `研究主题：${topic}，收集关键信息`,
    runtime: "subagent",
    mode: "run"
  });
  
  // 第二步：写作（使用研究结果）
  const article = await sessions_spawn({
    task: `基于以下研究撰写文章：${research}`,
    runtime: "subagent",
    mode: "run"
  });
  
  // 第三步：校对
  const polished = await sessions_spawn({
    task: `校对以下文章，修正语法和优化表达：${article}`,
    runtime: "subagent",
    mode: "run"
  });
  
  return polished;
}

模式3：专业Agent团队

// 创建专业团队
async function createExpertTeam() {
  // 架构师Agent
  const architect = sessions_spawn({
    task: "你是一位资深架构师，负责系统设计",
    runtime: "subagent",
    mode: "session",
    label: "architect"
  });
  
  // 开发Agent
  const developer = sessions_spawn({
    task: "你是一位全栈开发者，负责代码实现",
    runtime: "acp",
    mode: "session",
    label: "developer"
  });
  
  // 测试Agent
  const tester = sessions_spawn({
    task: "你是一位QA工程师，负责测试和验收",
    runtime: "subagent",
    mode: "session",
    label: "tester"
  });
  
  return { architect, developer, tester };
}

⚙️ 管理子Agent

查看运行中的子Agent

// 列出所有子Agent
subagents({
  action: "list"
})

// 查看最近运行的
subagents({
  action: "list",
  recentMinutes: 60
})

向子Agent发送指令

// 向特定子Agent发送消息
subagents({
  action: "steer",
  target: "session-abc123",
  message: "请加快进度，重点关注性能部分"
})

终止子Agent

// 强制结束子Agent
subagents({
  action: "kill",
  target: "session-abc123"
})

📚 相关链接