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

OpenClaw 多会话管理与子代理功能详解 | 极客日志

一、什么是多会话？

1.1 会话的概念

会话（Session），简单说就是 AI 和你的一次"对话上下文"。每次你跟 AI 聊天，都会创建一个会话，它会记住你们聊过的内容。

默认情况下，你只有一个主会话（main session），就是你直接跟 AI 聊天的那个。

1.2 为什么需要多会话？

想象这些场景：

你在跟 AI 讨论项目 A，突然想问项目 B 的事
你想让 AI 帮你查资料，但不想打断当前的对话
你需要 AI 同时执行多个独立任务

这时候，多会话就派上用场了！每个会话有独立的上下文，互不干扰。

1.3 会话类型

OpenClaw 中的会话主要分为：

主会话（main）：你直接对话的会话
子会话（sub-agent）：由主会话创建的独立会话
临时会话：执行特定任务后自动销毁

二、会话管理基础

2.1 查看会话列表

# 查看所有会话
openclaw sessions list

输出示例：

Session ID Type Status Last Active
─────────────────────────────────────────────────
main:001 main active 2 minutes ago
sub:code-001 sub running 5 minutes ago
sub:research-001 sub idle 1 hour ago

2.2 创建新会话

# 创建新会话
openclaw session new --label=my-task

--label 参数给会话起个名字，方便后续识别。

2.3 切换到指定会话

# 切换到某个会话
openclaw session switch sub:code-001

2.4 查看会话状态

# 查看会话详情
openclaw session status sub:code-001

输出包括：

运行时长
Token 使用量
模型信息
最后活跃时间

2.5 结束会话

# 结束指定会话
openclaw session end sub:code-001
# 结束所有子会话
openclaw sessions end --all

三、子代理（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: 可以访问工作区文件，但会话上下文是隔离的。