本页内容

本页内容

技术参考

会话管理深度解析

单个 网关进程 拥有端到端的会话状态。 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)仍然可以解析。每个条目都指向现在保存内容的页面。

故障排查清单

  • 会话密钥错误? 从/concepts/session开始,确认/status中的sessionKey。
  • 存储与转录不匹配? 使用 openclaw status 确认 Gateway 主机和存储路径。
  • 压缩刷屏? 检查模型的上下文窗口(太小会导致频繁压缩)以及工具结果膨胀(调整会话修剪)。
  • 在小型本地模型上,似乎每个提示词都会溢出? 确认提供商报告了正确的模型上下文窗口。只有在该窗口已知时,OpenClaw 才能限制有效保留量。
  • 无声转泄漏? 确认整个完成的最终修剪为大写NO_REPLY。小写字母、标点符号、引号、JSON 和尾随标记是可见文本。文字前导 NO_REPLY\n 仅删除该控制行并传递剩余文本;请参阅 静音管家 。

相关内容

本页有帮助吗?