stable
像正式班车。大多数人坐这条最省心。
Install 导读
三个更新通道怎么选、怎么切、怎么不翻车
stable 是生产首选，beta 是预发布验证通道，dev 是 main 分支的每日构建，别拿 dev 上生产。切换通道用 `openclaw update --channel`，它会记住你的选择并自动对齐安装方式；如果只想临时试一个版本，用 `--tag` 不改变通道。最容易搞错的是 beta 通道的降级回退逻辑：当 beta 标签缺失或比 stable 旧时，实际安装的是 stable，不是 beta。
先讲这一页到底在解决什么
三个更新通道怎么选、怎么切、怎么不翻车
stable 是生产首选，beta 是预发布验证通道，dev 是 main 分支的每日构建，别拿 dev 上生产。切换通道用 `openclaw update --channel`，它会记住你的选择并自动对齐安装方式；如果只想临时试一个版本，用 `--tag` 不改变通道。最容易搞错的是 beta 通道的降级回退逻辑：当 beta 标签缺失或比 stable 旧时，实际安装的是 stable，不是 beta。
第一站
🛣️ 三条车道，别背英文，记感觉就够了
这页最值得先记住的就是这三个角色分工。
beta
像试运行班车。东西比 stable 新，但还在观察。
dev
像施工现场直通车。最快看到新东西，也最容易遇到半成品。
main 分支
更像实验工地，不适合正式 Gateway 值班。
第二站
🔁 切换 channel，不是在“临时看看”，而是在“以后默认走这条路”
所以 --channel 和 --tag 千万别混了。
openclaw update --channel stable像对司机说：“以后都按正式班车时刻表接我。”
openclaw update --channel beta像改坐试运行班车，以后更新都会先朝 beta 轨道看。
openclaw update --channel dev像正式签字进入开发快线，后面会盯着 git checkout 和 main 的最新动静。
🎈 一句话
--channel 是改长期车道，不是一趟体验票。
第三站
🎟️ --tag 则像“这次我只想坐这班指定列车”
它不会改你长期配置，这一点非常关键。
openclaw update --tag beta像只想临时坐一次 beta 班车，看看风景，不改常驻路线。
openclaw update --tag 2026.3.28-beta.1像点名说“我要这一班具体车次”，很适合回放、测试、对版本。
openclaw update --tag main像这次临时抓 GitHub main 这趟车看看，但下一次默认路线还是按你之前的 channel。
📌 官方提醒
--tag 只对包安装路线有用，git 安装不会听它。
第四站
🪞 dry-run 和 status，其实是在给你“先看路线图，再决定要不要上车”
这两条命令很适合怕踩坑的人。
openclaw update --dry-run像先让售票员把行程单打印出来，你只看不付款。
openclaw update --dry-run --json像把路线单改成机器也能看的结构化清单，适合自动化系统自己读。
openclaw update status像问一句：“我现在到底在哪条轨道上？现在坐的是包车还是 git 车？”
🎈 收住一句
怕翻车时，先 status，再 dry-run，最后再真的更新。