跳轉到主要內容
OpenClaw 提供三個更新通道：
  • stable：npm dist-tag latest。建議大多數使用者使用。
  • beta：npm dist-tag beta，若目前存在且為最新；如果 beta 缺少或比 最新穩定版本更舊，更新流程會退回使用 latest。
  • dev：main 的移動最新狀態（git）。npm dist-tag：dev（發布時）。 main 分支用於實驗與積極開發。它可能包含 未完成的功能或破壞性變更。請勿將其用於生產環境 gateways。
我們通常會先將穩定建置發布到 beta，在該通道測試後，再執行 明確的提升步驟，將已驗證的建置移至 latest，且不 變更版本號。維護者也可以在需要時將穩定版本 直接發布到 latest。Dist-tags 是 npm 安裝的事實來源。

​
切換通道

openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev
--channel 會將你的選擇保存在 config（update.channel）中，並對齊 安裝方式：
  • stable（套件安裝）：透過 npm dist-tag latest 更新。
  • beta（套件安裝）：優先使用 npm dist-tag beta，但當 beta 缺少或比 目前穩定標籤更舊時，會退回使用 latest。
  • stable（git 安裝）：checkout 最新的穩定 git 標籤。
  • beta（git 安裝）：優先使用最新的 beta git 標籤，但當 beta 缺少或更舊時，會退回使用 最新的穩定 git 標籤。
  • dev：確保有 git checkout（預設 ~/openclaw，可用 OPENCLAW_GIT_DIR 覆寫）、切換到 main、在 upstream 上 rebase、建置，並從該 checkout 安裝全域 CLI。
如果你想並行使用 stable 與 dev，請保留兩個 clones，並讓你的 gateway 指向 stable 的那個。

​
一次性指定版本或標籤

使用 --tag 針對特定 dist-tag、版本或套件規格執行單次 更新，且不會變更你已保存的通道： 
# Install a specific version
openclaw update --tag 2026.4.1-beta.1

# Install from the beta dist-tag (one-off, does not persist)
openclaw update --tag beta

# Install from GitHub main branch (npm tarball)
openclaw update --tag main

# Install a specific npm package spec
openclaw update --tag openclaw@2026.4.1-beta.1
注意事項：
  • --tag 僅適用於套件（npm）安裝。Git 安裝會忽略它。
  • 標籤不會被保存。下一次 openclaw update 會照常使用你設定的 通道。
  • 降級保護：如果目標版本比你目前的版本更舊， OpenClaw 會提示確認（可用 --yes 跳過）。
  • --channel beta 與 --tag beta 不同：通道流程在 beta 缺少或更舊時，可能退回到 stable/latest；而 --tag beta 只會在該次執行中指定原始的 beta dist-tag。

​
Dry run

預覽 openclaw update 會做什麼，而不實際變更： 
openclaw update --dry-run
openclaw update --channel beta --dry-run
openclaw update --tag 2026.4.1-beta.1 --dry-run
openclaw update --dry-run --json
Dry run 會顯示有效通道、目標版本、計畫動作，以及 是否需要降級確認。

​
Plugins 與通道

當你使用 openclaw update 切換通道時，OpenClaw 也會同步 Plugin 來源：
  • dev 優先使用 git checkout 中的 bundled plugins。
  • stable 與 beta 會還原 npm 安裝的 Plugin 套件。
  • npm 安裝的 plugins 會在核心更新完成後更新。

​
檢查目前狀態

openclaw update status
顯示作用中的通道、安裝種類（git 或套件）、目前版本，以及 來源（config、git tag、git branch 或 default）。

​
標記最佳實務

  • 為你希望 git checkout 落到的版本加上標籤（stable 使用 vYYYY.M.D， beta 使用 vYYYY.M.D-beta.N）。
  • vYYYY.M.D.beta.N 也會被辨識以保持相容性，但建議使用 -beta.N。
  • 舊版 vYYYY.M.D-<patch> 標籤仍會被辨識為 stable（非 beta）。
  • 保持標籤不可變：絕不要移動或重複使用標籤。
  • npm dist-tags 仍是 npm 安裝的事實來源：
    • latest -> stable
    • beta -> candidate build 或 beta-first stable build
    • dev -> main snapshot（可選）

​
macOS app 可用性

Beta 與 dev 建置可能不包含 macOS app 發布。這沒問題：
  • git tag 與 npm dist-tag 仍然可以發布。
  • 在 release notes 或 changelog 中註明「此 beta 沒有 macOS build」。

​
相關