压缩

每个模型都有一个上下文窗口——即其可以处理的最大 token 数。当对话接近该限制时，OpenClaw 会将较早的消息压缩为摘要，以便聊天能够继续。

工作原理

完整的对话历史保留在磁盘上。压缩仅改变模型在下一轮看到的内容。

默认情况下启用自动压缩。当会话接近上下文限制，或模型返回上下文溢出错误时（此时 OpenClaw 会压缩并重试），它会运行。

在任何聊天中输入 /compact 以强制进行压缩。添加指令来指导摘要：

/compact Focus on the API design decisions

默认情况下，压缩使用您代理的主模型。您可以使用一个能力更强的模型来获得更好的摘要：

{
  agents: {
    defaults: {
      compaction: {
        model: "openrouter/anthropic/claude-sonnet-4-6",
      },
    },
  },
}

会话修剪是一个更轻量级的补充功能，它在不进行总结的情况下修剪工具输出。

压缩太频繁？ 模型的上下文窗口可能太小，或者工具输出可能太大。尝试启用会话修剪。

压缩后上下文感觉过时？ 使用 /compact Focus on <topic> 来指导摘要，或启用内存刷新以便笔记能够保留。

需要全新的开始？ /new 将在不压缩的情况下开始一个新的会话。

有关高级配置（预留令牌、保留标识符、自定义上下文引擎、OpenAI 服务器端压缩），请参阅 Session Management Deep Dive。