更新、重置与卸载:换渠道注意事项
升级和重来都是常规操作,OpenClaw 为每一步都准备了官方命令。
更新网关
openclaw update --channel stable # 稳定通道
openclaw update --channel dev # 追新通道
桌面端在应用内更新;注意渠道概念同样适用于手机端(见下)。更新后跑一遍 openclaw doctor,让它把配置迁移到新格式。
升级前先备份
- 整目录备份:把
~/.openclaw拷走,工作区、状态库、配置一次带走(地图见数据归属)。 - 官方命令:
openclaw backup与openclaw migrate子命令覆盖备份与迁移场景。 - 社区经验:大版本更新前后各备份一次,出问题随时回滚。
手机端:渠道别混着换
官方明确的警告,值得单独一节:
- Google Play 与独立 APK(GitHub 或第三方整理包)是不同更新渠道,签名身份可能不同。
- 切换渠道时安卓可能要求先卸载再装,这会删除应用的本地数据。
- 所以:选定渠道就固定用;非要换,先备份重要内容(虽然聊天历史主存在网关侧,手机端主要丢的是配对与缓存)。
重置的几个层级
| 想重来什么 | 做法 |
|---|---|
| 当前会话 | 聊天里 /new 或 /reset(会带上今昨记忆) |
| 某项配置 | openclaw configure 改回,或直接编辑配置文件 |
| 引导向导 | 重跑 openclaw onboard,幂等 |
| 整套状态 | openclaw reset 相关子命令(先备份!) |
卸载
官方提供卸载命令(CLI 参考 uninstall 页)。手动卸载的完整清单:CLI 全局包、守护进程服务、~/.openclaw 目录、桌面应用本体——按需全清或保留数据只删程序。
更新后的小问题
- 新版本行为变化带来「以前好用现在怪」时,先看官方发布说明(有专门的发布说明页),很多「故障」其实是行为改进。
- 实在不行回滚到上一个稳定版,社区对旧版的兼容讨论也比较活跃。
排查手册到此,集中快答见高频问答。