openclaw update status
像先去看公告栏：我现在在哪条轨道上？有没有新版在前面？
Cli 导读
更新 OpenClaw：安全切换稳定版 / 测试版 / 开发版
用 `openclaw update` 命令升级或切换频道，支持 `--dry-run` 预览操作，`--channel` 持久化设置频道。注意：降级需要确认，因为旧版可能破坏配置；通过 npm/pnpm/bun 全局安装的用户请走包管理器更新流程。
先讲这一页到底在解决什么
更新 OpenClaw：安全切换稳定版 / 测试版 / 开发版
用 `openclaw update` 命令升级或切换频道，支持 `--dry-run` 预览操作，`--channel` 持久化设置频道。注意：降级需要确认，因为旧版可能破坏配置；通过 npm/pnpm/bun 全局安装的用户请走包管理器更新流程。
第一站
🚦 先记住四种最常见姿势：看、试、升、换轨
官方把很多用法列在一起，其实可以压成四类。
openclaw update --dry-run
像先让物业拿出施工计划，不真的拆墙。
openclaw update
像真的开始换零件、建新房间、做最后体检。
--channel stable|beta|dev
像决定你接下来走稳当轨、试新轨，还是开发主线轨。
第二站
🧭 channel 和 tag，不是一个东西
这一页如果不先分清这两个词，很容易看晕。
--channel像选一条长期轨道。你以后默认就沿这条轨走。
--tag像这次临时指定“我要坐这班车”，不一定改变你长期住在哪条轨道边。
stable / beta / dev
像稳妥线、尝鲜线、施工现场线。越往后，变化越快，风险也越高。
main tag对包安装来说，像直接说“我今天就坐去主工地的那班车”。
第三站
🧪 --dry-run 在这里特别值，因为升级不是小事
官方把 dry-run 讲得很清楚：它会预演 channel、tag、重启这些动作，但不真的动手。
--dry-run像物业先拿一张施工路线图给你看：会换什么、会不会重启、会不会同步插件。
--no-restart像换完零件后先不重新拉总闸，让你自己决定什么时候停机重启。
--json像把整个施工计划改成机器能直接读的表格。
🎈 一句话
升级前先演一遍，特别适合胆小但专业的值班方式。
第四站
🏗 Git checkout 流程不是“拉代码就完了”，而是一整套施工检查
这页写得最硬的地方，其实是最该讲清的地方。尤其 dev 轨道，不是简单切 branch。
先要求工作树干净
像施工前先把地面清空，不允许一半是旧砖一半是新砖乱摊着。
切到对应轨道
stable 去最新稳定 tag，beta 去 beta tag，dev 去 main。
构建、UI、doctor
像换完零件以后，不只装好，还要跑一次整屋体检，确认没把别的地方带崩。
同步插件
像主楼换了零件，附属仓库和外挂小工具也要一起跟上节奏。
第五站
⚠️ downgrade 要确认，因为“往回坐旧电梯”不一定安全
官方特别提醒降级要确认。这不是多余谨慎，而是老版本可能看不懂你现在的新配置。
⬇ 回退版本
像把新装修的房间硬塞回旧图纸，有些接口可能就对不上了。
⏱
--timeout像告诉施工队：每一步最多等多久，别一项卡住拖到天黑。
openclaw --update像一个快捷小门，背后还是走同样那整套更新流程。
📌 一句话
升级是换新，降级是回旧，回旧往往比向前走更容易踩空。
最后总结
🎈 把 openclaw update 这页压成一句话
openclaw update 就像物业升级整栋楼：先看公告，再做试演，再决定走哪条轨道，真正动手后还要构建、体检、同步插件，尽量别把楼里原本好好的东西震坏。
如果你下一页只想继续看一页，我建议看 /cli/onboard。因为升级之前和升级之后，最常见的问题仍然是：第一次到底怎么把整套东西顺利带起来。