静默轮次与内存刷新
静默维护(NO_REPLY)¶
OpenClaw 支持用于后台任务的“静默”轮次,用户不应看到中间输出。
- 助手以精确的静默令牌
NO_REPLY/no_reply开头,表示“不要向用户投递回复”。OpenClaw 会在投递层剥离/抑制它。 - 精确静默令牌抑制不区分大小写:当整个负载仅为静默令牌时,
NO_REPLY和no_reply均有效。 - 自
2026.1.10起,当部分块以NO_REPLY开头时,OpenClaw 还会抑制草稿/正在输入流式输出,因此静默操作不会在轮次中途泄露部分输出。 - 这仅用于真正的后台/不投递轮次——它不是普通可操作用户请求的快捷方式。
压缩前记忆刷新¶
在自动压缩发生之前,OpenClaw 可以运行一个静默代理轮次,通过所选记忆提供方持久化持久状态,使压缩不会擦除关键上下文。Memory Core 会在代理工作区写入 memory/YYYY-MM-DD.md;其他提供方可以公开它们自己的持久化工具。OpenClaw 监控会话上下文使用情况,一旦它越过低于压缩阈值的软阈值,就会使用精确静默令牌 NO_REPLY / no_reply 发送静默的“立即写入记忆”指令,使用户看不到任何内容。
记忆刷新针对对话的私有、分离视图运行。其内部提示和回复永远不会进入原始转录,包括当新的用户消息中断它时。记忆文件写入保持持久。必需的预检会排除已接纳的等待用户;回复后刷新包括已完成的轮次。刷新内部的任何压缩仅影响其私有视图;原始对话有单独的压缩步骤。
配置(agents.defaults.compaction.memoryFlush),完整参考见 /gateway/config-agents:
| 键 | 默认值 | 说明 |
|---|---|---|
enabled |
true |
|
model |
未设置 | 仅用于刷新轮次的精确提供方/模型覆盖,例如 ollama/qwen3:8b |
softThresholdTokens |
4000 |
低于压缩阈值并触发刷新的间隙 |
forceFlushTranscriptBytes |
"2mb" |
当活动转录历史达到此估算字节大小(或字符串如 "2mb")时强制刷新,即使令牌计数器已过期;0 禁用 |
主机在请求所选记忆提供方刷新内容和持久化之前,会根据此配置和当前上下文窗口解析保留量、软边距、转录字节守卫和可选模型。除非提供方在其计划中故意覆盖可选时序字段,否则它们继承这些值。当 enabled 为 false 时,主机跳过提供方解析器。没有刷新计划时,维护仍使用有效压缩保留量。
默认 20,000 令牌保留量上限为上下文窗口的四分之一。默认 4,000 令牌软边距上限为该保留量之后剩余窗口的一半。对于 32,768 令牌窗口,主机因此使用 8,192 令牌保留量和 4,000 令牌软边距。早期刷新从 20,576 预测令牌开始。阻塞令牌压缩从 24,576 开始,或者如果适用的服务器阈值更高则更晚。在这些阈值之间,记忆刷新可以运行而不要求压缩。转录字节守卫默认为 2 MiB,并保持独立。非正阈值会抑制其触发。
当记忆刷新更新过期用量时,它包括在保存总计作为新值之前,追加到最新有效提供方用量报告之后的预测消息。因此,随后的压缩检查会考虑该后续转录增长。
说明:
- 内置提示和系统提示包含
NO_REPLY提示以抑制投递。 - 当设置
model时,刷新轮次使用该模型,而不继承活动会话的回退链,因此仅本地维护不会在失败时静默回退到付费对话模型。 - 刷新每个压缩周期运行一次(在会话行中跟踪)。
- 刷新仅针对嵌入式 OpenClaw 会话运行;CLI 后端和心跳轮次会跳过它。
- 当会话工作区为只读(
workspaceAccess: "ro"或"none")时,Memory Core 的文件刷新会被跳过。tools-arm 提供方不需要可写工作区访问。 - 有关工作区文件布局和写入模式,请参阅 记忆。
OpenClaw 在扩展 API 中公开了 session_before_compact 钩子,但上述刷新逻辑位于 Gateway 侧(src/auto-reply/reply/memory-flush-plan.ts、src/auto-reply/reply/memory-flush.ts 和 src/auto-reply/reply/agent-runner-memory.ts),而不是该钩子上。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw