OpenClaw 多会话管理与子代理功能详解

子代理是主会话创建的下属 AI，特点如下：

• 拥有独立的会话上下文
• 可执行特定任务
• 完成后向主会话汇报
• 不会干扰主会话的对话

3.2 子代理的工作流程

主会话 → 创建子代理 → 分配任务 → 子代理执行 → 返回结果 → 主会话处理

3.3 什么时候用子代理？

3.4 创建子代理

在对话中，AI 可自动创建子代理。也可手动创建：

// 在技能或配置中
const subAgent = await sessions_spawn({ 
  label: 'code-reviewer', 
  model: 'qwen-portal/coder-model', 
  task: 'Review this PR and provide feedback' 
});

3.5 给子代理分配任务

await sessions_send({ 
  sessionKey: subAgent.sessionKey, 
  message: '请帮我 review 这个 Pull Request，关注代码质量和潜在 bug' 
});

3.6 获取子代理结果

子代理完成任务后会自动通知主会话。也可主动查询：

const history = await sessions_history({ 
  sessionKey: subAgent.sessionKey, 
  limit: 50 
});

四、实战：多会话协作案例

4.1 案例一：并行代码审查

假设需 Review 3 个 PR，可创建 3 个子代理并行处理：

const agents = await Promise.all([
  sessions_spawn({ label: 'reviewer-1', task: 'Review PR #101' }),
  sessions_spawn({ label: 'reviewer-2', task: 'Review PR #102' }),
  sessions_spawn({ label: 'reviewer-3', task: 'Review PR #103' })
]);

agents.forEach((agent, i) => {
  sessions_send({ 
    sessionKey: agent.sessionKey, 
    message: `请 review PR #${101+i}，关注代码风格和潜在 bug` 
  });
});

4.2 案例二：资料搜集 + 内容创作

分工流程：

• 主会话：负责整体构思和写作
• 子代理 A：搜集相关资料
• 子代理 B：整理数据成表格
• 主会话：整合内容完成文章

4.3 案例三：定时任务监控

创建子代理定期执行检查任务：

const monitor = await sessions_spawn({ 
  label: 'heartbeat-monitor', 
  task: '每 30 分钟检查一次邮件和日历' 
});

子代理会定期向主会话汇报。

五、会话通信机制

5.1 主会话 → 子会话

使用 sessions_send 发送消息：

await sessions_send({ 
  sessionKey: 'sub:code-001', 
  message: '任务更新：请优先处理这个 bug' 
});

5.2 子会话 → 主会话

子会话完成任务后，自动推送结果：

// 子会话中
await sessions_send({ 
  label: 'main', 
  message: '任务完成！发现 3 个潜在问题，详情如下...' 
});

5.3 会话间数据共享

会话之间默认不共享上下文，以保护独立性。如需共享数据：

• 通过消息传递
• 写入共享文件
• 使用外部存储

六、最佳实践

6.1 合理划分会话

• 主会话：处理核心对话和决策
• 子会话：执行具体任务、长时间运行、独立上下文

6.2 控制子代理数量

子代理虽好，但别滥用：

• 每个子代理消耗资源
• 太多子代理难以管理
• 建议同时运行的子代理不超过 5 个

6.3 及时清理会话

任务完成后及时结束子会话：

openclaw session end sub:completed-task

6.4 会话命名规范

有意义的名字便于管理：

• ✅ 好：code-reviewer-001, research-agent, email-monitor
• ❌ 差：sub-1, agent-abc, temp-session

6.5 错误处理

子代理可能会失败，主会话要能处理：

try {
  const result = await sessions_send({ ... });
  if (result.status === 'error') {
    // 处理错误
  }
} catch (error) {
  // 异常处理
}

七、高级技巧

7.1 会话链

可以让子代理再创建子代理，形成层级：

主会话 └── 子代理 A（协调者）
        ├── 子代理 A-1（执行者）
        └── 子代理 A-2（执行者）

7.2 会话持久化

默认会话结束后会销毁，如需持久化：

await sessions_spawn({ 
  label: 'persistent-agent', 
  persist: true 
});

7.3 模型差异化

不同会话可用不同模型以平衡效果和成本：

// 主会话用高级模型
main: model='claude-sonnet'
// 子代理用经济模型
sub: model='qwen-portal/coder-model'

八、常见问题

Q1: 子代理和主会话会互相干扰吗？

A: 不会！每个会话有独立的上下文和记忆，互不影响。

Q2: 子代理创建后有数量限制吗？

A: 理论上没有限制，但建议同时运行的不超过 5 个，避免资源浪费。

Q3: 子代理完成后会自动销毁吗？

A: 默认会保留一段时间，建议手动结束不需要的会话。

Q4: 如何查看子代理的历史记录？

A: 使用 sessions_history 命令或 API。

Q5: 子代理能访问主会话的文件吗？

A: 可以访问工作区文件，但会话上下文是隔离的。

总结

1. 多会话让 AI 可以并行工作
2. 子代理适合长时间、独立的任务
3. 会话之间上下文隔离，互不干扰
4. 合理管理会话，及时清理资源