收到升级提醒,手一抖点了升级——结果服务挂了、配置丢了、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 使用体验与性价比分析
觉得有用?点个「在看」让更多人看到 👇
夜雨聆风