英文 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 — 跨代理的路由和会话隔离
- 后台任务 — 独立工作如何使用会话引用创建任务记录
- 通道路由 — 入站消息如何路由到会话
⌘我