本页内容
本页内容
技术参考
会话管理深度解析
单个 网关进程 拥有端到端的会话状态。 UI(macOS 应用程序、Web Control UI、TUI)查询网关以获取会话列表和令牌计数。在远程模式下,每个代理 SQLite 数据库位于远程主机上,因此检查本地 Mac 的状态不会反映网关正在使用的内容。
先看概述文档:会话管理、压缩、内存概览、内存搜索、会话清理、转录卫生,完整配置参考见 Agent 配置。
此页是一个索引。深入探讨记录在六页纸上,每个读者作业一页。打开与您的任务匹配的页面并停留在那里。
| 页面 | 读它的时候 |
|---|---|
| 磁盘上的会话状态 | 网关主机上的两个持久层和每个代理路径。 |
| 存储维护和保留 | session.maintenance 密钥、磁盘预算清理、cron 保留和 SQLite 降级路径。 |
| 会话密钥、ID 和转录事件 | sessionKey 模式、sessionId 生命周期、SessionEntry 字段和转录本条目类型。 |
| 压实行为和设置 | 压缩的作用、运行时间、设置和提供程序以及出现的位置。 |
| 静音转动和内存刷新 | NO_REPLY 合约和 agents.defaults.compaction.memoryFlush。 |
| 会话记录工作集 | 拟议的工人拥有的收购、居民预算和历史读者迁移。 |
各部分移动的地方
先前单页版本的每个部分标题都保留其锚点,因此现有链接(例如 /reference/session-management-compaction#when-auto-compaction-happens)仍然可以解析。每个条目都指向现在保存内容的页面。
- 两个持久层
- 磁盘上位置
- 存储维护和磁盘控制
- SQLite Flip 后降级
- Cron 会话和运行日志
- 会话密钥 (
sessionKey) - 会话 ID (
sessionId) - 会话存储架构
- 成绩单事件结构
- 上下文窗口与跟踪令牌
- 压缩:它是什么
- 汇总输入和工具配对
- 自动压缩发生时
- 压实设置
- 可插拔压实供应器
- 用户可见表面
- 静音看家(
NO_REPLY) - 预压缩内存刷新
故障排查清单
- 会话密钥错误? 从/concepts/session开始,确认
/status中的sessionKey。 - 存储与转录不匹配? 使用
openclaw status确认 Gateway 主机和存储路径。 - 压缩刷屏? 检查模型的上下文窗口(太小会导致频繁压缩)以及工具结果膨胀(调整会话修剪)。
- 在小型本地模型上,似乎每个提示词都会溢出? 确认提供商报告了正确的模型上下文窗口。只有在该窗口已知时,OpenClaw 才能限制有效保留量。
- 无声转泄漏? 确认整个完成的最终修剪为大写
NO_REPLY。小写字母、标点符号、引号、JSON 和尾随标记是可见文本。文字前导NO_REPLY\n仅删除该控制行并传递剩余文本;请参阅 静音管家 。
相关内容
本页有帮助吗?