🌿 OpenClaw v2026.10.9 升级科普指南：官方盖章的「安全版」

版本事实披露：本文版本事实来自 GitHub Releases 的 v2026.10.9 官方发布说明（2026-10-30 抓取）与官方发布页 docs.openclaw.ai/releases/2026.10.9（本次已上线；上一篇 v2026.10.8 撰写时该站发布页尚未上线）；Node 门槛取自 npm registry engines 字段实测与官方更新文档；升级命令经本机 CLI --help 实测（本机已是 2026.10.9）。引用来源统一称「官方发布说明（GitHub Releases）」与「官方发布页（docs.openclaw.ai）」。

✿ 1. 一句话总结与版本事实表

一句话总结：v2026.10.9 是官方明确标注「Security release（安全版本）」的纯维护版：修复 4 个依赖漏洞（MCP 的 URI 解析、Discord/A2UI 的超大集合、IMAP 的发件人伪装、Teams 的凭证路由），收紧工具权限与凭证日志输出，并把「更新失败后的回退」本身做得更安全。

官方原话：「Update OpenClaw to receive these fixes」（升级 OpenClaw 以获得这些修复）。没有大新功能——官方对它的定位就是一个「让人升级的安全补丁」。

另注：发布列表同期还有 extended-stable 长期支持线的 2026.9.36（切换命令 openclaw update --channel extended-stable，本机 CLI 帮助实测存在该选项）。

✿ 2. 这版和上一版有什么不一样（跨版对比）

只看单版发布页容易得出片面印象。按同一口径把最近两版放在一起看（.9 条目数为笔者按官方发布说明清点；.8 数据为官方口径，上一篇已核）：

两句结构性判断（基于上表，非单版印象）：

• ●规模从 162 缩到 48
  （约为上一版三成），是典型的「小而关键」补丁版。上一版把火力集中在「升级链路本身」，这一版换弹夹：官方安全响应 + 数据保全。
• ●安全内容的位置不同
  ：.9 的安全修复主要作为亮点（Highlights）发布；官方发布页还另设 Security and Privacy 分节单独收录 7 项——这部分不在这 11 条修复里，别漏看。
• ●修复占比佐证
  ：.8 约 71%（20/28），.9 为 55%（11/20）。口径：官方一级条目中属 Fixes 分类的条目占比（.8：7 组亮点+1 项变化+20 类修复=28；.9：8 条亮点+1 句定位说明+11 条修复=20，笔者清点）。

两个数字都对：GitHub 审计记录按版本区间清点（v2026.10.8..c213740，共 48 个 PR，另有 3 个已在 v2026.10.8 随版发布的 PR 计入基线排除）。

官方发布页则按「去重后的实际工作」清点（38 个 PR + 8 个直接提交，回退移植的包装 PR 不重复计数）。看到 38 或 48 都不是错，只是口径不同。

另外，同一修复在两处的 PR 编号可能不同：官方发布页会标注「改自前者」（如 #187276 改自 #185094、#187277 改自 #185160）。本文正文按 GitHub 发布说明口径标注。

✿ 3. 通俗总览：特性地图

官方发布说明按用户影响分组，含 8 条亮点与 11 条修复（条目数为笔者清点）；48 是审计口径的 unique PR 总数，两者口径不同（见第 2 节）。上图是主线的要点版，下面逐类展开。本文只讲与日常使用最相关的子集，全量清单见文末官方发布说明。

✿ 4. 逐类说人话：这版到底修了什么

❀ 4.1 安全补丁：四个依赖漏洞一次修完（本版主打）

这 4 项是官方把它定性为「安全版本」的直接原因（均引自官方发布说明与官方发布页）：

• ●fast-uri 升到 4.2.3
  ：MCP 工具的 schema 校验会拒绝畸形 URI scheme 和主机名——以前可能被放行的畸形标识现在会报错。如果你发现某个 MCP 工具升级后报校验错误，大概率是它以前在「带病运行」。
• ●Zod 补丁（A2UI 画布 + Discord 内嵌应用）
  ：声明了上限的数组/集合，超大输入提前拒绝，不再白白处理。
• ●nodemailer 升到 10.1.4（IMAP 邮件）
  ：最值得展开的一条——如果你的智能体接了邮箱，并设置「只允许某人发来的邮件进入」，伪装者以前能把可信地址藏在 From 头的嵌套注释里绕过发件人校验；现在过不了这道闸了。
• ●MSAL Node 7.1.1（Microsoft Teams / Azure 登录）
  ：修复一个可能把应用凭证发往错误目的地的库缺陷。修复包含在托管插件的安装与升级中。

❀ 4.2 权限与凭证不再裸奔

• ●tools.fs.workspaceOnly
  （仅工作区限制）现在覆盖 Gateway 构建的委托与媒体工具：受限的设置变更仍需审批，媒体读取不出允许的目录（#185094）。
• ●
  MCP 命令行检查的输出不再暴露凭证——脚本读到的是占位符而不是真密钥，已保存的凭证本身不受影响（#180321）。
• ●
  Google 登录的 client secret 在控制台与日志尾部输出中打码（原始日志文件不变）（#183193）。

❀ 4.3 升级失败也能「安全地失败」（Windows 用户重点）

上一版（.8）主打「升级别中断」，这一版管的是「中断了也别留烂摊子」：

• ●Git 源码安装回滚保留你的修改
  ：回滚不再重置 checkout、删掉你的本地编辑；若回滚被拒，先保存修改再按打印出的恢复命令操作（#185201）。
• ●Windows 回滚自动重试文件锁
  ：npm 更新回滚遇到临时文件占用会自动重试；如果安装包目录仍然丢失，报错会直接告诉你保留了哪些恢复目录、关掉哪些进程后把它们移到哪里（#185160）。
• ●同版本更新失败不再把 Gateway 留在停止状态
  ：核心没变且可安全重启时可以正常拉起，原失败原因仍会如实报告（官方发布页；数据或所有权检查不允许时恢复仍会被阻止）。
• ●文件系统重新挂载后 repair 能继续修
  ：能认出「发布版启动器」并保留原启动器与封存的恢复助手，中断的包更新不再修不动（#186557）。

❀ 4.4 数据保全：三种「差点以为丢了」的场景

• ●Node/SQLite 升级后索引被误判
  ：Node 升级改变 SQLite 分词（把文本切成可搜索词条的方式）后，启动和 Doctor 不再把陈旧的全文搜索索引当成数据库损坏；完好的数据库可以就地备份修复，更新快照也一并覆盖（官方发布页 Updates and Maintenance 分节）。
• ●超大对话档案卡迁移
  ：档案逐条处理而非整体展开成一个大字符串，不再超出 Node.js 字符串上限，Doctor 迁移不再被卡死（#170853）。
• ●磁盘写满后自愈
  ：空间释放并通过清理与完整性检查后，智能体即可恢复写入，无需重启网关。注意官方注明的边界：被中断的写入不会自动重放（#176902）。

❀ 4.5 其他日常修复（挑高频的）

• ●
  模型登录刷新「撞车」不再导致聊天和模型列表请求失败，冗余刷新也会跳过（#179144）。
• ●
  新建 ACP 会话在你指定的项目目录启动（含会话重置后），不再悄悄用默认工作区；需要给网关主机上的绝对路径（#176852）。
• ●
  Codex 对话中 steering 消息（对话进行中追加的引导消息）带的本地图片改从该会话自己的工作区解析（#181528）。
• ●
  技能 YAML 行内值带尾注释时，图标/主页等元数据不再丢（引号里的 # 仍算值的一部分）（#171224）。
• ●openclaw gateway probe --ssh
   尊重显式指定的 SSH 端口 22，不再错用别名配置的端口（#171092）。
• ●
  视频生成结果会列出被供应商忽略的选项（文本与 JSON 输出都有）（#171172）。
• ●
  macOS：被动停止时不再误卸载未安装的服务（#181257）；Mac 应用在远程或未激活配置没有本地服务可停时，不再误报 Gateway 失败（官方发布页 Native Apps 分节）。

✿ 5. 先泼一盆冷水

1. 安全修复只有装上才生效
   。官方原话「Update OpenClaw to receive these fixes」。只要还停在旧版，这 4 个漏洞补丁就帮不到你——漏洞可不会等你。

2. Node 门槛本版没有放宽。npm engines 实测仍为 >=24.22.1 <25 || >=26.12.1。本机实测：PATH 下 Node v24.18.0 被运行时准入拒绝，CLI 自动换用网关服务的 Node 才继续跑——「命令跑通了」不等于「你的 Node 达标」。    官方更新文档当前口径已是「24.x 线 24.16.0+ 或 26.1.0+ 受支持，24.22.1+/26.12.1+ 因安全原因强烈推荐」，与 2026.10.10-beta.5 发布说明「把硬性要求降为安全建议」一致，预计随 2026.10.10 正式版落地。等正式版，别在稳定环境装 beta（最新预发布版 2026.10.10-beta.5 已于 2026-10-30 发布）。

3. 自愈有边界。磁盘满恢复「被中断的写入不会自动重放」；同版本失败恢复「数据或所有权检查不允许重启时仍会被阻止」。自愈能力不是可以随便造的理由。

4. 降级有坑
   。官方明确：新版若已升级 SQLite 数据库结构，旧版打不开新库；降级要用升级前的兼容备份（官方文档 rollback-and-recovery 分节）。

✿ 6. 升级实操：三步走

❀ 第一步：查 Node 版本（不是走过场）

v2026.10.9 的 engines.node 要求（npm 实测）：>=24.22.1 <25 或 >=26.12.1。⚠️ 提醒：npm config get engine-strict 为 false（npm 默认）时，npm 安装阶段不拦截 Node 版本，只由 OpenClaw 运行时拒绝启动——「npm 装上了」不等于「Node 达标」。

不达标先升级 Node 再继续，建议直接上 24.22.1+ 或 26.12.1+（官方 Node 指南：https://docs.openclaw.ai/install/node ）。

❀ 第二步：升级前做「带校验的备份」

备份覆盖配置、凭证、会话与工作区。官方更新文档原话：升级这类大版本前要做「verified backup」，自动配置副本和迁移恢复原件不算完整备份；openclaw backup verify 可校验档案（以上子命令均经本机 CLI 帮助实测存在）。

❀ 第三步：一条命令升级

确认提示出现时按提示确认（脚本化环境可加 --yes）；想先看会发生什么，用 openclaw update --dry-run 预览（两者均为 CLI 帮助实测存在的参数）。

分系统差异（引自官方更新文档 docs.openclaw.ai/install/updating 与本机 CLI 帮助实测）：

极老版本桥接备注（引自官方更新文档）：

• ●
  桥接命令：openclaw gateway stop && npm install -g openclaw@2026.9.5 --allow-scripts=openclaw && openclaw --version && openclaw doctor --fix
• ●
  官方注明该命令适用于 npm 12 或 11.16+；npm 11.15 及更早需去掉 --allow-scripts=openclaw
• ●
  pnpm 用 pnpm add -g --allow-build=openclaw openclaw@2026.9.5；Bun 用 bun add -g --trust openclaw@2026.9.5
• ●
  旧格式的单文件记忆索引，需先用 2026.9.7 迁移出兼容副本再重试

❀ 升级后验证三连

1. openclaw doctor
    —— 体检配置与运行时；
2. openclaw update status
    —— 确认版本与更新通道；
3. 发一条消息确认 Gateway 正常回复（最真实的端到端验证）。

✿ 7. 升级失败怎么办

• ●更新中断/留下未完成的激活
  ：openclaw update recover 续跑被保留的激活，不需要重启健康的 Gateway（本机 CLI 帮助实测存在）。
• ●更新后 Doctor / 插件状态不对
  ：openclaw update repair 把没完成的更新、以及更新后 Doctor/插件的遗留状态收拾好——本版还增强了它：文件系统重新挂载后能认出发布版启动器，同版本失败不再把 Gateway 留在停止态。
• ●想回退
  ：优先用升级前的备份 openclaw backup restore（恢复到全新暂存目录，本机 CLI 帮助实测存在）；或 openclaw update --tag <旧版本号> 一次性指定版本（本机 CLI 帮助实测存在该参数，降级需确认）。注意第 5 节第 4 条的数据库结构坑：跨回已迁移结构的版本要用升级前的备份。
• ●想知道更新进行到哪
  ：openclaw update status 查看更新状态；官方文档称它确认驱动丢失时会指名 repair 作为下一步动作。

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

✿ 9. 参考资料

1. 官方发布说明（GitHub Releases）：https://github.com/openclaw/openclaw/releases/tag/v2026.10.9
2. 官方发布页（本次已上线）：https://docs.openclaw.ai/releases/2026.10.9
3. npm 包页：https://www.npmjs.com/package/openclaw/v/2026.10.9
4. 官方 Node 指南：https://docs.openclaw.ai/install/node
5. 更新文档：https://docs.openclaw.ai/install/updating
6. update CLI 文档：https://docs.openclaw.ai/cli/update
7. backup CLI 文档：https://docs.openclaw.ai/cli/backup
8. 预发布版参考（Node 兼容性放宽）：https://github.com/openclaw/openclaw/releases/tag/v2026.10.10-beta.5
9. 更新日志 Markdown 原文：https://raw.githubusercontent.com/openclaw/openclaw/main/CHANGELOG/2026.10.9.md

本文事实陈述均引用官方来源；条目数与占比为笔者按官方发布说明清点；规模数字为官方原文口径；升级命令、Node 门槛与子命令存在性经本机 CLI/npm 实测（2026-10-30）。