🌿 OpenClaw v2026.10.3 升级科普指南

📅 文档日期：2026-10-15 ｜ 🏷️ 撰写环境本地版本：v2026.10.3

✿ 📑 目录

1. 一句话总结
2. 版本事实表
3. 这个版本修了什么
4. 特性地图
5. 逐类说人话
6. 先泼一盆冷水：这版修的是"升级器"本身
7. 升级操作
8. 升级后验证
9. 出问题了怎么办
10. 行动清单（抄作业版）
11. 参考链接

✿ 1. 一句话总结

OpenClaw v2026.10.3 是 2026 年 10 月 13 日发布的最新稳定版，一句话概括：把挡住升级的坑填平，并且在填坑过程中不误伤你的登录态和记忆文件。

官方发布页自己的开篇是：修复多个升级阻塞项、在受影响的 Doctor 修复期间保留已保存的登录态和记忆文件、帮助 Mac 应用在本地设置时连上，并让对话在压缩或提供商回复中断后能继续（引自官方发布页导语）。

✿ 2. 版本事实表

⚠️ 三个规模数字（79 / 8 / 97）全部引自官方发布页原文，不是笔者统计。版本迭代快，你执行时请以 openclaw --version 与 openclaw update status 的实际输出为准。

顺带说清一个容易混淆的事：就在本文撰写当天（2026-10-15），官方还发布了 v2026.9.33——那不是「比 2026.10.3 更新的版本」，而是 extended-stable 频道（官方原话：我们目前 equivalent to LTS 的频道）的网关专用版本，基于 2026 年 9 月底的代码加上关键安全与可靠性修复（引自 v2026.9.33 GitHub Release 说明）。普通用户跟 latest（当前即 2026.10.3）即可；求稳的服务器场景可以研究 openclaw update --channel extended-stable（引自官方 CLI 文档）。

✿ 3. 这个版本修了什么

v2026.10.3 是一个以「升级与维护」为绝对主角的修复版——官方发布页 10 个类别里，「Updates and Maintenance」一个类别就占了 22 条（笔者清点），其余九类合计约 30 条。没有大的新功能，主题就是：让升级走得通、让修复不伤数据、让对话不断线。

❀ 六大修复主题

① 升级与维护修复（22 条，官方发布页该类别全量）

被卡住的升级能解锁：残留的恢复工作可清除、已完成的升级记录可归档，不再挡住下一次升级；2026.9.8 时代被中断的升级也能被新版 CLI「善后」。Windows 安装路径的短名/大小写识别、pnpm 服务命令与启动器、FreeBSD 包恢复、聊天里发起的升级被误回滚——都有修复。

② 数据保全（安全与隐私 + 记忆类）

Doctor 修复时不再因一个不可读的旧认证文件就丢弃已保存的 OAuth 登录态；MEMORY.md 合并遇到坏编码时保留原始字节，不硬来。

③ 对话连续性（消息 + 模型类中的续接修复）

原生压缩后下一条消息等待历史可读而不是报错；被正常断连打断的 ChatGPT 回复可续传；被纠正过、且原始授权来源还在的人工对话，网关重启后能恢复。

④ Mac 应用

"On this Mac" 设置时此前报 "Gateway rejected auth" 的场景能连上了；受信证书换新后自动重连；修了一个「网关健康但恢复界面卡住」的根因。

⑤ 模型与提供商

Meta Muse Wonder 可选（文本 + 图像 + max thinking）；MiniMax M3.1 Flash 预览版（五档思考力度）；Copilot 改用账户报告的真实提示容量；IPv4 不通时可试 IPv6。

⑥ 插件与杂项

被路径安全检查拦住的本地插件，修复时保留启用状态与设置；升级期间保留官方 webhook 回调（含 Teams 路径）；插件目录不再反复加载未变插件、修掉内存越用越多的问题。

✿ 4. 特性地图

✿ 5. 逐类说人话

❀ 升级与维护：把挡路的石头搬走

之前的问题：运行 openclaw update，有时会被「上一场升级留下的东西」挡住——残留的恢复工作、已完成但没归档的升级记录、被中断的 2026.9.8 时代升级、Windows 安装目录的短名/大小写差异、pnpm 换版本目录后失效的服务命令。任何一样都可能让下一次升级直接卡死。

现在：

• ●
  卡住的升级可解锁：残留恢复工作可清除、已完成记录可归档；2026.9.8 时代被中断的升级，新版 CLI 也能善后（#168388、#169038、#169027）。
• ●
  Windows：升级器识别安装目录的短名/大小写变体，恢复快照不再拒绝自己的临时目录；服务账户名不同也能正确重启网关（#169292、#169397、#169481）。
• ●
  pnpm：服务命令改用持久安装链接，换版本目录不弄坏命令；pnpm 12 启动器修复后 openclaw 命令在清理后仍可用（#170003、#170131）。
• ●
  聊天里发起的升级不再被 Doctor 误拒权限而回滚，插件升级不会半途而废（#170218）。
• ●
  数据库短暂繁忙不再中止升级；你配置的 Node 内存限制也会保留（#168210、#168889）。

❀ 数据保全：修东西的时候别把好的也扔了

这是本版最「有温度」的一类修复。

登录态：以前 Doctor 遇到一个不可读的旧版认证文件，相关清理可能把已保存的 OAuth 登录态一起丢弃。现在会保留档案，并明确告诉你该检查或恢复哪个文件再重试。已删除的档案不会复活（#170256，引自官方发布页）。

记忆文件：MEMORY.md 和旧 memory.md 合并时，如果文件里有坏 UTF-8 编码，Doctor 现在保留原始字节，让你先修好或转码一份副本再重试，而不是硬合并（#169029）。

修复副本：新的恢复副本把旧 Canvas 文档和 Memory Core 文件也收进来；后台数据库维护碰巧改文件，不再让副本被拒（#169436、#170022）。

❀ 对话连续性：断了能接上

• ●压缩后
  ：长对话压缩（compaction）完成后，下一条消息会等已保存的对话历史可读，而不是在历史重建期间直接失败（#169583）。
• ●ChatGPT 断线
  ：正常连接关闭打断了未完成的回复时，可在既有重试限额内从已保存的对话继续（#167512）。
• ●重启后
  ：被你纠正过、且原始授权来源还活着的人工对话，网关重启后能恢复继续；已失败的会话不会重开，缺失的发送权限也不会被凭空重建（#170252）。
• ●后续轮次
  ：Codex 的兼容后续消息可在会话准备失败后继续（#169431）；Claude CLI 的会话/历史/管理工具在发起共享连接的那一轮结束后，后续轮次继续保留授权（#165432）。

❀ Mac 应用：三处连接与恢复修复

• ●"On this Mac" 设置
  ：此前报 "Gateway rejected auth" 的场景现在能连上，准备和等待也减少了；需要的新令牌存不下来时，以可重试的错误停止（#169403）。
• ●证书换新
  ：受信网关证书换新后 Mac 应用自动重连；「学到的指纹」可随正常信任检查换新，显式配置的指纹保持不变（#168151）。
• ●恢复界面卡死
  ：应用能识别受保护的 Bun 网关命令，修掉一个「网关明明健康、恢复界面却卡住」的根因；保护性启动选项与所有权检查保留（#170006）。

❀ 模型与提供商：新面孔与诚实提醒

• ●Muse Wonder（Meta）
  ：可选文本 + 图像输入，支持 max thinking；Spark 1.3 Standard 也支持 max thinking 且仍是设置默认。注意官方说明：API 支持 Wonder Standard，max effort 并不会选中 Wonder Full（#170232）。
• ●MiniMax M3.1 Flash 预览版
  ：符合条件的 Token Plan 或 MiniMax Code 用户可选，思考力度分 low / medium / high / xhigh / max 五档，预览默认 max；M3 仍是默认模型。官方特别提醒：目录里没发布费率不等于免费用（#160089）。
• ●MiniMax 登录续期
  ：Global 和 CN 的 OAuth 过期令牌在签发区域端点续期；旧的已存登录态或换过区域，需要用 openclaw models auth login --provider minimax-portal 重新登录一次（#160459）。
• ●Copilot 容量
  ：缺原生限制的模型改用账户报告的提示容量，而不是 128K 估计值；刷新发现可替换旧缓存估计（#156636）。
• ●其他
  ：DeepSeek 的内部工具标记不再漏进回复（#169728）；IPv4 不通且启用地址族自动选择时可试 IPv6，已配置的网络安全检查照常生效（#168973）。

❀ 插件与杂项：修复也要有始有终

✿ 6. 先泼一盆冷水：这版修的是"升级器"本身

读官方发布说明时，有一个句式反复出现："requires the fixed updater to be installed before it starts the upgrade"（该修复生效的前提是：开始这次升级之前，机器上已经装着带此修复的升级器）。出现在 Windows 路径修复、数据库忙修复、依赖复制修复、内存限制保留、pnpm 12 启动器、Git 清理等多处条目里（引自官方发布页）。

翻译成人话：

1. 这个版本修的大部分是升级器（update 工具自己）的 bug。
2. 你从 v2026.10.2 升到 v2026.10.3 的过程中，干活的还是旧升级器——这一路可能仍会踩到它已经修掉的坑。
3. 升到 v2026.10.3 之后，从它出发的下一次升级才真正吃到这些修复。
4. 如果你已经被卡住：官方给的路径是先走手动安装或恢复第一步；另有独立恢复助手可保留已完成记录并解锁原升级器（引自官方发布页）。

这不是要挑刺，而是使用说明——就像杀毒软件查不了「装它之前」就中了的毒，得先装上再全盘扫描。升级器也一样：先升上来，以后的升级才更稳。

✿ 7. 升级操作

❀ 升级前三件事

⚠️ 官方 Node 文档明确写着：先升 Node 再升 OpenClaw，避免 SQLite TEXT 截断问题。Node 26 是推荐运行时，网关启动更快、内存更省（引自官方 Node 文档）。

⚠️ 若第 2 步备份失败或校验不过：停手，先解决备份问题再升级。官方支持的唯一回滚方式就是这份带校验的备份（见第 9 节），备份不可信等于放弃后悔药。

❀ 分系统说明

❀ 如果你版本很老（2026.7.x 之前）

先走桥接版本 2026.9.5，跑完迁移再升最新（命令引自官方 updating 文档）：

⚠️ 两个细节： ① "版本老于 2026 年 7 月" 指版本号 < 2026.7.x，不是你安装动作的日期。 ② npm 11.15 及更早版本，上面命令去掉 --allow-scripts=openclaw 参数（引自官方安装文档）。 ③ 手动 npm/pnpm/bun 安装是备选路径，不走 openclaw update 的恢复与回滚流程（引自官方更新方法文档）。

❀ 自动更新说明

网关的自动更新默认关闭，需要显式开启；长时间运行的无头打包节点默认自动更新（引自官方 automatic-updates 文档）。本文不建议普通用户开启自动更新——按本文流程手动升，心里有数。

✿ 8. 升级后验证

⚠️ 官方发布页特别提醒：数据迁移后若有失败，会指向支持的修复命令；修复 worker 未善后前，保持网关停止，并保留新安装与恢复快照（引自官方发布页 Repair outcomes 条目）。

✿ 9. 出问题了怎么办

❀ 升级被卡住 / 报错

先看官方更新排错文档。已经被卡住的旧升级器：走手动安装或恢复第一步；或用独立恢复助手保留已完成记录并解锁原升级器（引自官方发布页）。

有残留的废弃升级器副本挡路时：等升级 worker 干完活，从受影响的安装运行 openclaw doctor --fix，再重试；保留恢复日志及其权限（#170170）。

❀ pnpm 的 openclaw 命令坏了

先备份，然后用同一账户、同一全局目录做同版本 pnpm 重装，或手动修复；官方步骤见更新方法文档（引自官方发布页 #170131）。

❀ 想回滚

数据库 schema 迁移是单向的——光降级安装包回不去。唯一受支持的恢复方式：用匹配旧版本还原升级前那份带校验的备份（引自官方回滚与恢复文档）。所以第 7 节的备份别省。

❀ MiniMax 旧登录态失效

旧的已存登录态或换过区域，重新登录一次：openclaw models auth login --provider minimax-portal（引自官方发布页 #160459）。

❀ Doctor 报 pending

未完成的 Doctor 维护现在会报「pending + 有用的下一步动作」，按提示走即可；重启或重载前先跑完 openclaw doctor --fix（引自官方发布页 #170339）。

✿ 10. 行动清单（抄作业版）

按需追加：

• ●
  版本老于 2026.7.x → 先走第 7 节的 2026.9.5 桥接流程
• ●
  MiniMax 用户 → 升级后如登录态失效，openclaw models auth login --provider minimax-portal 重新登录一次
• ●
  用 Codex 插件且版本老于 2026.9.7 → openclaw plugins update codex
• ●
  想跟 extended-stable（类 LTS）频道 → openclaw update --channel extended-stable

✿ 11. 参考链接

• ●
  官方发布页：https://docs.openclaw.ai/releases/2026.10.3
• ●
  更新指南：https://docs.openclaw.ai/install/updating
• ●
  更新排错：https://docs.openclaw.ai/install/update-troubleshooting
• ●
  备份指南：https://docs.openclaw.ai/install/backups
• ●
  Node 要求：https://docs.openclaw.ai/install/node
• ●
  回滚与恢复：https://docs.openclaw.ai/install/updating/rollback-and-recovery
• ●
  发布频道说明：https://docs.openclaw.ai/install/development-channels
• ●
  GitHub Releases：https://github.com/openclaw/openclaw/releases

本文事实陈述均尽量客观引用官方来源：版本号与日期来自 npm registry / GitHub Releases API，特性内容来自官方发布页原文，升级命令来自官方文档。文中 PR 编号均可在官方发布页原文中查到。