英文 Session
约 3 分钟
- 原始链接：https://docs.openclaw.ai/concepts/session
- 来源章节：4. 官方文档：核心概念、模型与安全
- 来源小节：无
- 抓取方式：jina:https://r.jina.ai/http://docs.openclaw.ai/concepts/session
- 抓取时间：2026-04-05 13:47:10
- 状态：ok
中文内容
会话管理 - OpenClaw
[OpenClaw主页！图片1：深色徽标！图片2：深色徽标](http://docs.openclaw.ai/)
英语
搜索...
⌘K
搜索...
导航
会话和内存
会话管理
基础知识
会话和内存
多代理
消息和传递
在此页面上
会话和内存
会话管理
会话管理
OpenClaw 将对话组织成会话。每条消息都会根据其来源（DM、群聊、cron 作业等）路由到一个会话。
消息如何路由
| 来源 | 行为 |
|---|---|
| 直接留言 | 默认共享会话 |
| 群聊 | 每组隔离 |
| 房间/频道 | 每个房间隔离 |
| 计划任务 | 每次运行新的会话 |
| 网络钩子 | 每个钩子隔离 |
DM隔离
默认情况下，所有 DM 共享一个会话以保证连续性。这对于单用户设置来说很好。
如果多人可以向您的客服人员发送消息，请启用 DM 隔离。如果没有它，所有用户都共享相同的对话上下文——鲍勃可以看到爱丽丝的私人消息。
修复：
{
会话：{
dmScope: "per-channel-peer", // 按通道 + 发送者隔离
},
}其他选项：
main（默认）——所有 DM 共享一个会话。per-peer— 按发送者隔离（跨渠道）。per-channel-peer— 按通道 + 发送者隔离（推荐）。per-account-channel-peer— 按帐户 + 频道 + 发送者隔离。
如果同一个人通过多个渠道与您联系，请使用“session.identityLinks”链接他们的身份，以便他们共享一个会话。
使用“openclaw 安全审核”验证您的设置。
会话生命周期
会话将被重复使用，直到过期：
- 每日重置（默认）— 网关主机上当地时间凌晨 4:00 的新会话。
- 空闲重置（可选）— 一段时间不活动后的新会话。设置“session.reset.idleMinutes”。
- 手动重置 — 在聊天中输入“/new”或“/reset”。
/new <model>也会切换模型。
当每日重置和空闲重置均已配置时，以先到期者为准。
国家居住的地方
所有会话状态均由网关拥有。 UI 客户端向网关查询会话数据。
- 存储：
~/.openclaw/agents/<agentId>/sessions/sessions.json - 成绩单：
~/.openclaw/agents/<agentId>/sessions/<sessionId>.jsonl
会话维护
OpenClaw 会随着时间的推移自动限制会话存储。默认情况下，它以“警告”模式运行（报告将清理的内容）。将 session.maintenance.mode 设置为 "enforce" 以进行自动清理：
{
会话：{
维护：{
模式：“强制”，
修剪后：“30d”，
最大条目数：500，
},
},
}使用“openclaw 会话清理 --dry-run”进行预览。
检查会议
openclaw status— 会话存储路径和最近的活动。openclaw 会话 --json— 所有会话（使用--active <分钟>进行过滤）。- 聊天中的“/status”——上下文使用、模型和切换。
/context list— 系统提示符中的内容。
进一步阅读
- Session Pruning — 修剪工具结果
- Compaction — 总结长对话
- Session Tools — 用于跨会话工作的代理工具
- 会话管理深入探讨 — 存储架构、记录、发送策略、原始元数据和高级配置
- Multi-Agent — 跨代理的路由和会话隔离
- 后台任务 — 独立工作如何使用会话引用创建任务记录
- 通道路由 — 入站消息如何路由到会话
⌘我