压缩与镜像
在 Codex 回合中,压缩归谁所有,以及 OpenClaw 转录镜像保留了什么。本文是 Codex harness runtime 指南的一部分;各章节移往何处 列出了每个章节。
压缩与转录镜像¶
当所选模型使用 Codex harness 时,Codex 应用服务器拥有原生 Token 压力压缩和手动对话线程压缩。OpenClaw 另行拥有其转录镜像。当 agents.defaults.compaction.maxActiveTranscriptBytes 设置为正值时,OpenClaw 会在普通回合和心跳回合之前检查该镜像。当字节护栏触发时,OpenClaw 会在放行该回合前,尝试通过所选宿主上下文引擎执行语义压缩。这种宿主压缩本身不会替换或重写 Codex 的规范原生对话线程。
如果上下文引擎拒绝宿主压缩,或遗留的历史记录仍然过大,OpenClaw 会继续使用近期完整回合的有界投影。原生对话线程遵循该投影,因此被省略的历史不会残留在其上下文中。可见的通知会要求你重新发送任何必要的前期细节;已保存的历史保持不变。失败原因会以警告级别记录。失败的尝试不计为成功的压缩,被抑制的重试仍会获得有界上下文。系统指令和当前请求保持完整。
宿主镜像压缩提交后,OpenClaw 可能会请求 thread/compact/start 以同步符合条件的原生对话线程。该请求是次要的:对于宿主隔离操作或具有受限原生权限的绑定,OpenClaw 不会发送该请求;不可用或失败的原生同步不会回滚已提交的宿主压缩。
显式压缩请求,例如 /compact 或插件请求的手动压缩操作,会通过 thread/compact/start 启动原生 Codex 压缩。OpenClaw 会保持该请求和共享客户端租约开启,直到 Codex 发出匹配的 contextCompaction 完成项,然后将压缩回合报告为已完成。如果该终止回合超过配置的压缩超时,OpenClaw 会请求中断原生回合。租约和每个对话线程的压缩屏障会一直保持,直到 Codex 报告终止状态或确认中断 RPC。如果 Codex 在中断宽限期内未确认,OpenClaw 会在释放屏障之前停用该连接。远程连接还会分离匹配的对话线程绑定,使后续工作无法与未确认的远程回合重叠。在已停用连接上的其他回合会失败,并可在新客户端上重试。客户端关闭、请求取消或失败的压缩回合会返回失败操作。自动的原生 Token 压力压缩仍然是 Codex 的职责。除上述次要同步之外,OpenClaw 仅为显式手动请求启动原生压缩。
独立的冷压缩操作不会运行 prompt-build 钩子,也不会建立普通回合配置。操作结束后,它会释放订阅;下一个普通回合会通过正常恢复路径验证配置并刷新通用策略。热压缩仅返回其实际获取的配置所有权。
如果上下文引擎压缩使 OpenClaw 会话世代发生轮转,那么下一个 Codex 回合、压缩操作或附带问题会继续使用同一原生对话线程,即使 Gateway 在提交新世代后立即停止也是如此。只有该会话键下已记录的前驱才能被采用。在恢复的对话线程执行之前,原生工具目录、连接所有权和监督检查仍然适用。
成功的本地回退或分支切换属于上下文变更。作为转录变更的一部分,它会使旧的原生绑定失效,并在返回前释放其订阅。下一个 Codex 回合会使用所选的 OpenClaw 历史启动新的原生对话线程;被擦除的回合无法通过原生恢复返回。无效截断和已回滚的转录变更会保留绑定。
当 OpenClaw 将现有会话的连续性投影到新的 Codex 对话线程中时,它会包含已保存的压缩摘要和分支摘要,即使没有较早的用户消息残留。上下文引擎投影也会保留这些摘要条目。摘要会作为先前上下文被引用,与当前请求分开,并仍受投影大小限制的约束;过大的摘要或较早的上下文可能被截断。这种交接不会改变原生 Codex 压缩所有权。
当上下文引擎请求 Codex 对话线程引导投影时,OpenClaw 会将工具调用名称和 ID、输入形状以及脱敏后的工具结果内容投影到新的 Codex 对话线程中。它不会将原始工具调用参数值复制到该投影中。
镜像包括用户提示、最终助手文本,以及应用服务器发出这些内容时的轻量级 Codex 推理记录。推理保留类型为 thinking 的内容,而不是普通的最终答案文本,因此 OpenClaw 现有的推理可见性和历史控制适用。OpenClaw 会记录原生压缩的启动和终止状态,但不会公开人类可读的压缩摘要,也不会公开可审计的列表,说明 Codex 在压缩后保留了哪些条目。
同一压缩项的重复完成通知只计一次,并且不会重复执行完成钩子或活动计划恢复。
由于 Codex 拥有规范原生对话线程,tool_result_persist 不会重写 Codex 原生的工具结果记录。它仅在 OpenClaw 写入 OpenClaw 拥有的会话转录工具结果时适用。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw