乐于分享
好东西不私藏

OpenClaw 版本升级避坑指南:升级前必看的那些坑

OpenClaw 版本升级避坑指南:升级前必看的那些坑

收到升级提醒,手一抖点了升级——结果服务挂了、配置丢了、Skills 全失效。这样的事故在 OpenClaw 社区并不少见。

如果你不想成为下一个案例,这篇升级避坑指南请认真看完。

近两周事故回顾

先看看最近发生了什么:

v2026.3.28(3月28日)

  • 最新版本,建议观望
  • 修复了若干稳定性问题

v2026.3.22(3月22日)

  • 大批用户升级后 Docker 全新安装失败(shared-network namespace 问题)
  • Chrome MCP 被移除,依赖浏览器插件 Relay 的用户升级后功能直接失效
  • OpenAI Token 认证回滚问题,新保存的 Token 莫名其妙变回旧的
  • ClawHub 成为默认安装源,部分第三方插件路径改变

v2026.3.11(3月11日)

  • 安全漏洞修复,需立即升级
  • 但部分用户升级后配置丢失

v2026.3.13(3月13日)

  • 因上版本事故,被迫发布回收版本 v2026.3.13-1

总结一下: 近两周发布了 9 个版本(含 beta),平均每 1.5 天一个版本。迭代极快,修复也快,但不稳定也是真的。

beta → beta.1 → beta.2 → stable,路径看着清晰,但每个版本都可能藏雷。

正确升级姿势

记住这个顺序,升级前必做:

第一步:备份配置

openclaw backup create --only-config

第二步:查看变更日志 去 GitHub Releases 页面,看看这个版本改了什么: https://github.com/openclaw/openclaw/releases

第三步:重点看 Breaking Changes 如果版本说明里标记了 Breaking 两个字,这意味着会有大改。你的现有配置很可能需要手动调整。

第四步:等 2-3 天 不要在版本发布后第一时间升级。等社区反馈,如果 Discord 和 GitHub Issues 里没有大规模哀嚎,再升级不迟。

第五步:确认无重大问题后,执行升级

openclaw update # 或 npm install -g openclaw

第六步:升级后检查

openclaw doctor

这会检查你的配置是否正常,Skills 是否能正常加载。

关键提醒

  • 永远不要在生产环境第一时间升级
     — 你自己的树莓派、NAS、淘汰笔记本,都算
  • Breaking Changes 需要逐条对照自己的配置
     — 别跳过这一步
  • 升级前备份,升级后验证
     — 养成习惯
  • beta 版本不要在主账号上测试
     — 有独立测试环境再说

我的建议

软件不是股票,不要追涨杀跌。

看到升级提醒,先点「稍后」,等 3 天看看社区有没有哀嚎——如果没有,再升级也不迟。

毕竟,折腾这东西还是比较费时间的。


你升级遇到过问题吗?欢迎留言说说。

往期文章:

OpenClaw 免费助手/工具(1):SearXNG,一个属于你自己的搜索引擎

OpenClaw 免费助手/工具(2):RustFS 存储方案

如何为 AI 助手选择大模型?GLM-5 使用体验与性价比分析

OpenClaw:一个真正「懂你」的 AI 助手

觉得有用?点个「在看」让更多人看到 👇