Skip to main content
OpenClaw 提供四个更新通道：
  • stable：npm dist-tag latest。推荐大多数用户使用。
  • extended-stable：npm dist-tag extended-stable。这是一个全新的、滞后一个受支持月份的软件包通道。它仅适用于软件包，安装仅在前台进行。当启用 update.checkOnStart 时，它会接收只读的更新提示，包括直接安装最终的 extended-stable 软件包，但绝不会自动应用更新。
  • beta：npm dist-tag beta。当 beta 缺失或早于当前稳定版本时，会回退到 latest。
  • dev：main（git）的最新移动版本。发布时使用 npm dist-tag dev。main 用于实验和积极开发，可能包含未完成的功能或破坏性变更。不要在生产网关中运行它。
稳定版构建通常会先发布到 beta，在那里经过验证，然后再在不更改版本号的情况下 提升到 latest。维护者也可以直接发布到 latest。Dist-tag 是 npm 安装的事实来源。

​
切换通道

--channel 会将选择持久化到配置中的 update.channel，并驱动这两种 安装路径： 对于 dev git 安装，默认检出目录为 ~/openclaw（或在设置了 OPENCLAW_HOME 时为 $OPENCLAW_HOME/openclaw）；可通过 OPENCLAW_GIT_DIR 覆盖。 自动更新活动会固定其公布的上游提交，因此即使倒计时期间 main 继续推进，显示的列表也会预览从实际目标安装版本开始的最多五个提交。手动执行 openclaw update --channel dev 仍会以当前上游 main 为目标。
要让 stable 和 dev 并行使用，请使用两个独立的检出目录，并让各自的网关指向自己的目录。

​
一次性版本或标签目标

使用 --tag 来针对特定的 dist-tag、版本或包规范进行单次更新，不会更改持久化的 channel：
注意：
  • --tag 仅适用于 package（npm）安装；git 安装会忽略它。
  • 该标签不会被持久化；下一次 openclaw update 会使用已配置的 channel。
  • --tag main 会映射为一次性运行所用的 npm 兼容规范 github:openclaw/openclaw#main。如果要进行持久化的 main 跟踪安装，请使用 openclaw update --channel dev（package 安装会切换到 git 检出版本） 或通过安装器的 git 方法重新安装： curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --version main。 npm 安装路径会直接拒绝 GitHub/git 源目标，并会引导你改用 git 方法。
  • 降级保护：如果目标版本比当前 版本更旧，OpenClaw 会提示确认（可用 --yes 跳过）。
  • extended-stable 始终使用其已验证的精确 package 目标。它不是 --tag extended-stable 的一次性别名，并且 --tag 不能与有效的 extended-stable channel 组合使用。
  • --channel beta 与 --tag beta 不同：channel 流程在 beta 缺失或更旧时 可以回退到 stable/latest，而 --tag beta 总是 在该次运行中直接针对原始的 beta dist-tag。

​
试运行

在不进行更改的情况下预览 openclaw update 会做什么：
试运行会报告生效的通道、目标版本、计划执行的操作，以及是否需要降级确认。

​
插件和通道

使用 openclaw update 切换通道时，也会同步插件来源：
  • dev 会将已安装且有对应内置版本的插件切回其内置（git checkout）来源。
  • stable 和 beta 会恢复 npm 安装或 ClawHub 安装的插件包。
  • extended-stable 会将符合条件的官方 npm 插件，使用裸/默认或 latest 意图，解析为当前安装的核心版本的精确版本。运行时不会查询插件的 @extended-stable 标签。
  • npm 安装的插件会在核心更新完成后更新。

​
检查当前状态

显示当前激活的通道（以及决定该通道的来源：配置、Git 标签、Git 分支、已安装版本或默认值）、安装类型（Git 或软件包）、当前版本，以及更新可用性。

​
标签最佳实践

  • 将你希望 git 检出落到的发布版本打上标签：稳定版使用 vYYYY.M.PATCH， beta 版使用 vYYYY.M.PATCH-beta.N。诸如 -alpha.N、-rc.N 和 -next.N 之类的命名预发布后缀不是稳定版或 beta 版目标。
  • 为兼容性考虑，旧式的数字稳定标签（如 vYYYY.M.PATCH-1 和 v1.0.1-1）仍会 被识别为稳定的 git 标签。
  • vYYYY.M.PATCH.beta.N（以点分隔）也会为兼容性而被识别；优先使用 -beta.N。
  • 保持标签不可变：切勿移动或重用标签。
  • npm dist-tags 仍然是 npm 安装的事实来源：
    • latest -> 稳定版
    • extended-stable -> 受支持月份包的滞后发布
    • beta -> 候选构建或 beta 优先的稳定版构建
    • dev -> 主分支快照（可选）

​
macOS 应用可用性

Beta 和开发版本可能不包含 macOS 应用发布。这是可以的：
  • git 标签和 npm dist-tag 仍然可以独立发布。
  • 在发布说明或更新日志中注明“此 beta 没有 macOS 构建”。

​
相关内容