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

三、子代理（Sub-agents）详解

3.1 什么是子代理？

子代理是主会话创建的"下属"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 案例一：并行代码审查

假设你有 3 个 PR 需要 review，可以创建 3 个子代理并行处理：

// 创建 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: 可以访问工作区文件，但会话上下文是隔离的。