实践openclaw-concepts
Session management · OpenClaw — 会话管理是 agent 记忆的基石,本文教你如何隔离、重置和清理会话。
会话管理是 agent 记忆的基石,本文教你如何隔离、重置和清理会话。
2026-08-17原文
本文为要点摘要,完整细节以原文为准。
🧭 一图看懂
由原文自动提炼 · 以原文为准点击任一分支,查看这一点的一句话解读
OpenClaw 会话管理
按来源把入站消息分配到不同会话,状态由 gateway 统一持有
- DM 默认共享会话,群聊/房间按群隔离
- Cron 每次运行新建会话,Webhook 按 hook 隔离
- session.scope: global 不合并不同 agent 的…
⚙️ 流程拆解
STEP 1入站消息按来源路由
STEP 2分配或复用会话
STEP 3gateway 持有会话状态
STEP 4按策略重置或过期
STEP 5清理会话与记录
🔗 涉及的概念与玩家
- OpenClaw产品
- gateway概念
- Control UI产品
- session.dmScope概念
- session.groupScope概念
- Incognito sessions概念
- Codex产品
- MEMORY.md概念
- OpenClaw—状态由持有→gateway
- Control UI—查询会话数据→gateway
- session.dmScope—配置私聊隔离→OpenClaw
- session.groupScope—配置群组路由→OpenClaw
- Incognito sessions—仅限创建→Control UI
- Codex—以…→Incognito sessions
- DM 隔离:默认所有 DM 共享一个会话,多用户时必须启用
dmScope: "per-channel-peer"按频道和发送者隔离,防止隐私泄露。对 harness 设计:会话路由需考虑多租户安全。 - 会话重置策略:支持 daily 和 idle 两种自动重置,可全局配置并按聊天类型或频道覆盖。重置后旧会话的系统事件被丢弃,避免污染新会话。对 harness 设计:需区分用户交互和系统事件,避免后者延长会话生命周期。
- 会话维护:通过
session.maintenance设置pruneAfter和maxEntries自动清理旧会话,防止存储无限增长。对 harness 设计:应内置存储上限和清理机制,保证长期运行稳定。
🕸 顺着图谱继续读
- Agent workspace · OpenClaw — Agent 工作区是记忆中枢,文件即指令,结构决定行为。2026-06-29 · 共同涉及 OpenClaw、MEMORY.md、Control UI
- Enabling active memory · OpenClaw — 跨会话记忆怎么开、边界在哪,一页说清默认值与隐私红线2026-09-14 · 共同涉及 OpenClaw、session.dmScope、MEMORY.md
- User model · OpenClaw — USER.md 如何稳定跨会话记住你的偏好?一文讲清格式与身份验证。2026-08-31 · 共同涉及 OpenClaw、MEMORY.md、gateway
- Control UI and API keys · OpenClaw — OpenClaw 把密钥存储、模型目录刷新和用量统计拆成独立步骤,这个设计值得借2026-09-21 · 共同涉及 OpenClaw、Control UI、gateway