OpenClaw 2026.6.11 → 2026.7.1 升级指南:有哪些变化,怎么避坑

7 月 14 号发现微信没反应了。查了一下才知道——不止微信，飞书也挂了，四个频道全部 circuit open。检查版本才发现，不知道什么时候已经升到了 2026.7.1 。

排查发现（grep 'metadata conflict' /tmp/openclaw/openclaw-2026-07-14.log），日志显示 plugin metadata conflict detected，原因是插件版本落后。旧插件和 7.1 不兼容， Gateway 反复启动失败， crash-loop recovery 机制暂时禁用了所有频道连接。

这篇文章就是这次翻车的复盘：怎么安全完成这次升级，以及升完后多了什么。

（如果你已经升完了才发现出问题，直接从 Step 2 开始查插件版本。）

🚨 升级步骤（含避坑）

Step 1 ：升级主程序

openclaw update 

升完后先确认版本：

openclaw --version 

Step 2 ：查插件版本（最关键的一步）

升完后不要急着重启，先查插件：

openclaw plugins list --outdated 

坑在这里：openclaw update 只升级主程序，不会碰插件。如果升完直接跑， Gateway 会因为旧插件不兼容而 panic 。

实测发现 4 个插件版本落后：

Step 3 ：更新过时插件

openclaw plugins update @openclaw/feishu 

openclaw plugins update @openclaw/kimi-provider 

openclaw plugins update @openclaw/moonshot-provider 

openclaw plugins update @openclaw/tavily-plugin 

注意 update 只接受单个插件 ID ，不支持批量。

Step 4 ：重启 Gateway

openclaw gateway restart 

Step 5 ：确认频道状态

openclaw channels status 

如果全绿 → 继续 Step 6 。

如果还是红 → 2026.7.1 新增了 crash-loop recovery 机制（旧版 6.11 没有这个机制）。这不是 Gateway 坏了，是异常状态触发后，重启一次可能清不干净。碰到这个情况，再重启一次就能恢复：

openclaw gateway restart sleep10 openclaw channels status 

Step 6 ：跑 doctor 清理积压

openclaw doctor --fix 

实测跑一次能清理孤儿 transcript 文件（ Gateway 反复启动失败后残留的会话文件，不清理不影响运行但会堆在磁盘上）、重建插件注册表、取消卡死的 TaskFlow 。上面那次翻车清理了 129 个孤儿文件和一个卡死的 TaskFlow 。

Step 7 ：检查 cron

openclaw cron list 

看有没有连续失败的 job 。曾经发现一个 Vault 维护的 cron 失败了 9 次，原因是 prompt 里硬编码了一些已不存在的目录路径。 7.1 可以用 openclaw cron edit 直接改 prompt ，不用删掉重建：

openclaw cron edit <job-id>--message'新的 prompt'

（这个功能在 7.1 上可用。）

🆕 升级后有什么变化

以下新功能列表来源于官方 CHANGELOG （本地路径：npm root -g/openclaw/CHANGELOG.md， 1700+ 行）。

Control UI 重做了。  Dashboard 改成会话优先——侧边栏可折叠、可固定常用页面，设置移到底部。多了上下文环（一眼看 token 用量）和推理难度滑块。如果你每天都在用 Dashboard ，这个变化感受最明显。

cron edit 值得一试。  以前改 cron job 的 prompt 只能删掉重建，现在 openclaw cron edit <job-id> --message '新 prompt' 一步到位。顺带还能调 --every 改执行频率。

其他变化（来源：官方 CHANGELOG ）：

避坑经验来自 7 月 14 日实操。新功能列表来源于官方 CHANGELOG 。

如果还没升，按上面的顺序来，插件先更新再重启，这样最稳妥。如果已经升完了，重点看看 Control UI 和 cron edit——这两个是日常用得最多的变化。