会话管理

OpenClaw 将对话组织为 会话。每条消息都会根据来源路由到某个 会话，例如私信、群聊、cron 任务等。

# 消息如何路由

来源	行为
直接消息	默认使用共享会话
群聊	按群组隔离
房间/渠道	按房间隔离
Cron 任务	每次运行使用新会话
Webhook	按 hook 隔离

# 私信隔离

默认情况下，所有私信共享一个会话，以保持连续性。这适合 单用户设置。

修复方式：

{
  session: {
    dmScope: "per-channel-peer", // isolate by channel + sender
  },
}

其他选项：

• main（默认）-- 所有私信共享一个会话。
• per-peer -- 按发送者隔离（跨渠道）。
• per-channel-peer -- 按渠道 + 发送者隔离（推荐）。
• per-account-channel-peer -- 按账号 + 渠道 + 发送者隔离。

# 停靠已关联渠道

Dock 命令允许用户将当前直接聊天会话的回复路由移动到 另一个已关联渠道，而无需启动新会话。参见 渠道停靠 获取示例、配置和 故障排除。

使用 openclaw security audit 验证你的设置。

# 会话生命周期

会话会被复用，直到过期：

• 每日重置（默认）-- 在 Gateway 网关主机本地时间凌晨 4:00 创建新会话。 每日新鲜度基于当前 sessionId 的开始时间，而不是 后续元数据写入时间。
• 空闲重置（可选）-- 在一段时间无活动后创建新会话。设置 session.reset.idleMinutes。空闲新鲜度基于最后一次真实的 用户/渠道交互，因此 heartbeat、cron 和 exec 系统事件不会 让会话保持存活。
• 手动重置 -- 在聊天中输入 /new 或 /reset。/new <model> 还会 切换模型。

如果同时配置了每日重置和空闲重置，先过期的规则生效。 Heartbeat、cron、exec 和其他系统事件轮次可能会写入会话元数据， 但这些写入不会延长每日或空闲重置的新鲜度。当重置滚动到新会话时， 旧会话队列中的系统事件通知会被丢弃，这样过期的后台更新就不会被 前置到新会话的第一个提示中。

拥有活跃的提供商托管 CLI 会话的会话不会被隐式的 每日默认值切断。如果这些会话应按定时器过期，请使用 /reset 或显式配置 session.reset。

# 状态存储位置

所有会话状态都由 Gateway 网关 拥有。UI 客户端会向 Gateway 网关查询 会话数据。

• 存储： ~/.openclaw/agents/<agentId>/sessions/sessions.json
• 转录记录： ~/.openclaw/agents/<agentId>/sessions/<sessionId>.jsonl

sessions.json 保留独立的生命周期时间戳：

• sessionStartedAt：当前 sessionId 开始的时间；每日重置使用此值。
• lastInteractionAt：最后一次会延长空闲生命周期的用户/渠道交互。
• updatedAt：最后一次存储行变更；用于列表展示和清理很有用，但不是 每日/空闲重置新鲜度的权威依据。

没有 sessionStartedAt 的旧行会在可用时从转录记录 JSONL 会话头解析。如果旧行也缺少 lastInteractionAt， 空闲新鲜度会回退到该会话开始时间，而不是后续的簿记 写入时间。

# 会话维护

OpenClaw 会随着时间自动限制会话存储大小。默认情况下，它以 warn 模式运行（报告将会清理的内容）。将 session.maintenance.mode 设为 "enforce" 可启用自动清理：

{
  session: {
    maintenance: {
      mode: "enforce",
      pruneAfter: "30d",
      maxEntries: 500,
    },
  },
}

对于生产规模的 maxEntries 限制，Gateway 网关运行时写入会使用一个小的高水位缓冲区，并分批清理回配置的上限。会话存储读取不会在 Gateway 网关启动期间修剪或限制条目。这样可以避免每次启动或隔离的 cron 会话都运行完整存储清理。openclaw sessions cleanup --enforce 会立即应用上限。

维护会保留持久的外部对话指针，包括群组 会话和线程作用域的聊天会话，同时仍允许合成的 cron、 hook、heartbeat、ACP 和子智能体条目自然过期。

如果你之前使用过直接消息隔离，后来又将 session.dmScope 改回 main，可以使用 openclaw sessions cleanup --dry-run --fix-dm-scope 预览过期的按 peer 键控的私信行。应用同一标志会 停用这些旧的直接私信行，并将它们的转录记录保留为已删除 归档。

使用 openclaw sessions cleanup --dry-run 进行预览。

# 检查会话

• openclaw status -- 会话存储路径和最近活动。
• openclaw sessions --json -- 所有会话（用 --active <minutes> 过滤）。
• 聊天中的 /status -- 上下文使用量、模型和开关。
• /context list -- 系统提示中的内容。

# 延伸阅读

• 会话修剪 -- 修剪工具结果
• 压缩 -- 总结长对话
• 会话工具 -- 用于跨会话工作的智能体工具
• 会话管理深入解析 -- 存储架构、转录记录、发送策略、来源元数据和高级配置
• 多智能体 — 跨智能体的路由和会话隔离
• 后台任务 — 分离式工作如何创建带有会话引用的任务记录
• 渠道路由 — 入站消息如何路由到会话

# 相关

• 会话修剪
• 会话工具
• 命令队列