---
read_when:
    - 你想了解会话路由和隔离
    - 你想为多用户设置配置私信范围
    - 你正在调试每日或空闲会话重置
summary: OpenClaw 如何管理对话会话
title: 会话管理
x-i18n:
    generated_at: "2026-05-07T13:15:18Z"
    model: gpt-5.5
    provider: openai
    source_hash: 4e5ec741a33262ce5c42caf021ad81892e89b3315db31ac7b141d5a13e8b22a2
    source_path: concepts/session.md
    workflow: 16
---

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

## 消息如何路由

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

## 私信隔离

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

<Warning>
如果有多个人可以给你的智能体发消息，请启用私信隔离。否则，所有
用户都会共享同一个对话上下文 -- Alice 的私密消息会被
Bob 看到。
</Warning>

**修复方式：**

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

其他选项：

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

<Tip>
如果同一个人通过多个渠道联系你，请使用
`session.identityLinks` 关联他们的身份，让他们共享一个会话。
</Tip>

### 停靠已关联渠道

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

使用 `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"` 可启用自动清理：

```json5
{
  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` -- 系统提示中的内容。

## 延伸阅读

- [会话修剪](/zh-CN/concepts/session-pruning) -- 修剪工具结果
- [压缩](/zh-CN/concepts/compaction) -- 总结长对话
- [会话工具](/zh-CN/concepts/session-tool) -- 用于跨会话工作的智能体工具
- [会话管理深入解析](/zh-CN/reference/session-management-compaction) --
  存储架构、转录记录、发送策略、来源元数据和高级配置
- [多智能体](/zh-CN/concepts/multi-agent) — 跨智能体的路由和会话隔离
- [后台任务](/zh-CN/automation/tasks) — 分离式工作如何创建带有会话引用的任务记录
- [渠道路由](/zh-CN/channels/channel-routing) — 入站消息如何路由到会话

## 相关

- [会话修剪](/zh-CN/concepts/session-pruning)
- [会话工具](/zh-CN/concepts/session-tool)
- [命令队列](/zh-CN/concepts/queue)