openclaw update 命令用于管理 OpenClaw 的版本更新和渠道切换。支持在 stable(稳定版)、beta(测试版)和 dev(开发版)渠道之间切换,同时保持配置的安全性和完整性。
核心功能
此命令管理 OpenClaw 的版本更新和渠道切换。支持在 stable、beta 和 dev 渠道之间平滑过渡,同时确保配置的安全性和完整性。
基本命令
# 执行标准更新
openclaw update
# 查看当前渠道和可用更新
openclaw update status
# 交互式渠道选择界面
openclaw update wizard
命令参数
| 参数 | 说明 |
|---|---|
--channel <stable|beta|dev> |
设置更新渠道(git + npm;会持久化到配置中) |
--tag <version> |
覆盖 npm 分发标签,用于单次更新 |
--no-restart |
更新后跳过 Gateway 服务重启 |
--json |
生成机器可读的 JSON 格式输出 |
--timeout <seconds> |
自定义各步骤的超时时间 |
渠道特定行为
每个渠道遵循不同的安装模式:
- dev(开发版):需要 git 仓库(默认位置:
~/openclaw) - stable(稳定版)和 beta(测试版):使用 npm 包安装,配合相应的分发标签
安全特性
降级警告
降级操作需要确认,因为旧版本可能会破坏配置兼容性。
dev 渠道的工作流程包含预检验证机制。当当前代码测试失败时,会有回退逻辑检查最多 10 个先前的提交。
使用示例
切换到测试版渠道
# 切换到 beta 渠道并更新
openclaw update --channel beta
查看更新状态
# 查看当前渠道和可用更新
openclaw update status
使用向导进行渠道选择
# 启动交互式渠道选择
openclaw update wizard
提示
更多详情请参考 官方英文文档。