OpenClaw 版本頻道切換：快速切換 Stable、Beta 與 Dev

身為開發者，我們都經歷過那種「想試用新功能，卻又擔心弄壞生產環境」的掙扎。手動切換版本、管理不同的環境配置，往往耗費掉原本該拿來寫程式的時間。

OpenClaw 提供三種更新頻道，讓你根據需求靈活選擇：

• stable: npm dist-tag 為 latest。推薦給大多數使用者。
• beta: npm dist-tag 為 beta（測試中的版本）。
• dev: main 分支 (git) 的最新進度。發佈時的 npm dist-tag 為 dev。 main 分支是用來實驗和積極開發的，可能包含未完成的功能或 breaking changes。請不要在生產環境的 Gateway 中使用它。

我們會先將版本發佈到 beta 進行測試，接著將經過驗證的版本提升 (promote) 到 latest，且不更動版本號 —— 對於 npm 安裝來說，dist-tags 才是唯一的真實來源。

切換頻道

openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev

--channel 會將你的選擇儲存在設定中 (update.channel)，並自動對齊安裝方式：

• stable/beta (package 安裝)：透過對應的 npm dist-tag 進行更新。
• stable/beta (git 安裝)：切換到最新且符合的 git tag。
• dev：確保使用 git checkout（預設為 ~/openclaw，可用 OPENCLAW_GIT_DIR 覆蓋），切換到 main 分支，對齊遠端進行 rebase、建置，並從該路徑安裝全域 CLI。

小撇步：如果你想同時並行 stable 和 dev，可以保留兩個 clone 並將你的 Gateway 指向 stable 的那個。

一次性版本或標籤指定

使用 --tag 可以針對單次更新指定特定的 dist-tag、版本或 package 規格，這不會改變你原本設定的頻道：

# 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 僅適用於 package (npm) 安裝。Git 安裝會忽略此參數。
• 此標籤不會被儲存。你下次執行 openclaw update 時，仍會使用原本設定的頻道。
• 降級保護：如果目標版本比目前版本舊，OpenClaw 會要求確認（可用 --yes 跳過）。

預檢執行

在不做出任何實際更動的情況下，預覽 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) 會顯示生效的頻道、目標版本、計畫執行的動作，以及是否需要降級確認。

外掛程式與頻道

當你使用 openclaw update 切換頻道時，OpenClaw 也會同步外掛程式 (plugins) 的來源：

• dev 頻道會優先使用來自 git checkout 的內建外掛程式。
• stable 和 beta 頻道則會還原為 npm 安裝的外掛程式套件。
• 核心更新完成後，npm 安裝的外掛程式也會隨之更新。

檢查目前狀態

openclaw update status

這會顯示目前啟用的頻道、安裝類型（git 或 package）、目前版本以及來源（設定檔、git tag、git branch 或預設值）。

標籤最佳實踐

• 為你希望 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)
  • dev -> main 分支快照（選用）

macOS 應用程式可用性

Beta 和 dev 版本可能不會包含 macOS 應用程式的發佈。這是正常的：

• git tag 和 npm dist-tag 仍然可以發佈。
• 請在發佈說明 (release notes) 或變更日誌 (changelog) 中註明「此 beta 版本不提供 macOS 建置版本」。

---

下一步

• 瞭解如何配置 Gateway
• 管理你的 Plugins

有任何疑問嗎？歡迎詢問我們的 AI Setup Assistant 協助你完成設定。