OpenClaw 4.5 升级指南:记忆不再断片

你有没有遇到过这种情况：和 OpenClaw 聊得好好的，突然它就"断片"了——上下文压缩后，刚才说的细节全没了。

你正聊得深入，OpenClaw 同时帮你追踪着好几件事，有些提议正在进行中，有些决定做到一半——然后上下文窗口满了，压缩触发。突然间它变得不一样了：大概记得话题，但细节没了。你不得不重复之前说的话，才能回到正轨。

4.5 版本终于解决了这个痛点。

一、三大核心新功能

Compaction Checkpoints 是这次更新最大的亮点。压缩触发前，系统会自动保存当前会话状态到 session-state.md，压缩后可以恢复。不再是"一压缩就失忆"，而是"压缩后还能找回"。

Dreaming 是新的记忆巩固机制，分三个阶段：

• Light：轻度整理，快速处理当天内容
• Deep：深度分析，提取关键信息
• REM：记忆巩固，写入长期记忆

Prompt Caching 增强后，重复的 prompt 不再重复计算 token，上下文压力明显降低。

二、破坏性变更（必须知道）

4.5 对配置路径做了调整，以下旧配置可能失效：

talk.voiceId / talk.apiKey → 新路径
agents.*.sandbox.perSession → 新路径
browser.ssrfPolicy.allowPrivateNetwork → 新路径
hooks.internal.handlers → 新路径

迁移方法：升级后运行 openclaw doctor --fix，会自动迁移旧配置到新路径。但建议升级前先检查配置文件，手动确认这些配置项的位置。

三、Dreaming 三阶段详解

Dreaming 是 OpenClaw 的新记忆系统，模仿人类睡眠的三阶段：

阶段一：Light（浅睡）

• 快速整理当天内容
• 不做深度分析，只归类
• 处理速度快，几秒完成

阶段二：Deep（深睡）

• 提取关键信息
• 识别重要对话、决定、任务
• 写入中期记忆

阶段三：REM（快速眼动）

• 记忆巩固，写入长期记忆
• 建立"线索"，方便后续检索
• 可能产生新的关联

关键配置：

recencyHalfLifeDays: 7    # 记忆衰减半衰期，7天后记忆权重减半
maxAgeDays: 30            # 最大记忆天数，超过30天的记忆会被清理

注意：如果你已经有自己的日记系统（比如 memory/YYYY-MM-DD.md），Dreaming 可能会产生重复内容。建议升级后第一周观察 dreams.md 和 memory/ 目录，如果出现冲突，可以关闭 Dreaming。

四、升级检查清单

升级前

☐ 备份配置文件：cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak
☐ 备份 skills 目录：cp -r ~/.openclaw/workspace/skills ~/.openclaw/skills.bak
☐ 记录当前版本：openclaw --version
☐ 检查配置文件是否有即将废弃的配置项

升级中

# 停止 Gateway
openclaw gateway stop

# 升级（根据你的安装方式选择）
brew upgrade openclaw        # macOS Homebrew
npm update -g openclaw       # npm 全局安装

# 验证版本
openclaw --version

升级后

☐ 重启 Gateway：openclaw gateway start
☐ 运行医生：openclaw doctor
☐ 测试基础功能：发送一条消息
☐ 检查 Compaction Checkpoints 是否生效
☐ 观察 Dreaming 是否干扰现有日记

五、风险与回滚方案

可能风险

• Dreaming 干扰现有记忆系统，产生重复内容
• 旧配置兼容性问题，部分功能失效
• 插件兼容性问题

如何关闭 Dreaming

{
  "agents": {
    "defaults": {
      "dreaming": {
        "enabled": false
      }
    }
  }
}

回滚方案

# 停止并卸载
openclaw gateway stop
brew uninstall openclaw

# 恢复备份
cp ~/.openclaw/openclaw.json.bak ~/.openclaw/openclaw.json

# 重新安装旧版本（需指定版本）
brew install openclaw@2026.3.13

# 重启
openclaw gateway start

总结

4.5 最大的价值，是让 OpenClaw 不再"健忘"。升级前备份，升级后观察，Dreaming 不合适就关掉——简单三步，平稳过渡。