发布渠道

OpenClaw 提供四个更新渠道：

• stable：npm dist-tag latest。推荐大多数用户使用。
• extended-stable：npm dist-tag extended-stable。这是一个全新的、滞后一个受支持月份的软件包渠道。它仅提供软件包，并且只能在前台安装。启用 update.checkOnStart 后，已存储的选择会收到只读更新提示，但绝不会自动应用更新。
• beta：npm dist-tag beta。当 beta 不存在或比当前稳定版本更旧时，回退到 latest。
• dev：main（git）的移动分支头。发布时使用 npm dist-tag dev。main 用于实验和积极开发；其中可能包含未完成的功能或破坏性变更。不要将其用于生产环境的 Gateway 网关。

稳定构建通常会先发布到 beta，在那里经过验证，然后在不提升版本号的情况下晋升为 latest。维护者也可以直接发布到 latest。对于 npm 安装，dist-tag 是事实来源。

切换渠道

openclaw update --channel stableopenclaw update --channel extended-stableopenclaw update --channel betaopenclaw update --channel dev

--channel 会将所选渠道持久化到配置中的 update.channel，并同时驱动两种安装路径：

对于 dev git 安装，默认检出目录是 ~/openclaw（设置 OPENCLAW_HOME 时则为 $OPENCLAW_HOME/openclaw）；可通过 OPENCLAW_GIT_DIR 覆盖。

一次性指定版本或标签

使用 --tag 可针对单次更新指定特定 dist-tag、版本或软件包规范，且不会更改持久化的渠道：

# 安装特定版本openclaw update --tag 2026.4.1-beta.1 # 从 beta dist-tag 安装（一次性，不持久化）openclaw update --tag beta # 切换到不断变化的 GitHub main 检出内容（持久化）openclaw update --channel dev # 安装特定 npm 软件包规范openclaw update --tag openclaw@2026.4.1-beta.1 # 从 GitHub main 安装一次，但不持久化渠道openclaw update --tag main

注意：

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

试运行

预览 openclaw update 将执行的操作，但不进行任何更改：

openclaw update --dry-runopenclaw update --channel beta --dry-runopenclaw update --tag 2026.4.1-beta.1 --dry-runopenclaw update --dry-run --json

试运行会报告实际生效的渠道、目标版本、计划执行的操作，以及是否需要降级确认。

插件和渠道

使用 openclaw update 切换渠道时，也会同步插件来源：

• dev 会将具有内置对应版本的已安装插件切换回其内置（git 检出）来源。
• stable 和 beta 会恢复通过 npm 或 ClawHub 安装的插件软件包。
• extended-stable 会将采用裸版本、默认版本或 latest 意图的符合条件的官方 npm 插件解析为与已安装核心完全相同的版本。它不会在运行时查询插件的 @extended-stable 标签。
• 核心更新完成后，会更新通过 npm 安装的插件。

检查当前状态

openclaw update status

显示当前生效的渠道（以及决定该渠道的来源：配置、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-tag 仍是 npm 安装的事实来源：
  • latest -> stable
  • extended-stable -> 滞后一个受支持月份的软件包版本
  • beta -> 候选构建或优先发布到 beta 的稳定构建
  • dev -> main 快照（可选）

macOS 应用可用性

Beta 和 dev 构建可能不包含 macOS 应用版本。这没有问题：

• git 标签和 npm dist-tag 仍可独立发布。
• 在发布说明或变更日志中明确注明“此 beta 版本没有 macOS 构建”。

相关内容

• 更新
• 安装程序内部机制