開發通道¶

最後更新：2026-01-21

OpenClaw 提供三種更新通道：

• stable：npm dist-tag latest。
• beta：npm dist-tag beta（測試中的建置）。
• dev：main（git）的持續前進頭；npm dist-tag：dev（發佈時）。 外掛與頻道

我們會先將建置發佈到 beta、進行測試，然後將經審核的建置提升為 latest， 而不變更版本號 —— dist-tag 是 npm 安裝時的權威來源。

切換通道¶

Git 檢出：

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

• stable/beta 會檢出最新且符合的標記（通常是同一個標記）。
• dev 會切換到 main，並在上游基礎上 rebase。

npm／pnpm 全域安裝：

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

這會透過對應的 npm dist-tag 更新（latest、beta、dev）。

當你明確使用 --channel 切換通道時，OpenClaw 也會同步調整安裝方式：

• dev 會確保使用 git 檢出（預設 ~/openclaw，可用 OPENCLAW_GIT_DIR 覆寫）， 更新後並從該檢出安裝全域 CLI。
• stable/beta 會使用相符的 dist-tag 從 npm 安裝。

提示：如果你想同時使用 stable 與 dev，請保留兩個 clone，並將 Gateway 閘道器 指向 stable 的那一個。

外掛與通道¶

當你使用 openclaw update 切換通道時，OpenClaw 也會同步外掛來源：

• 標記最佳實務
• stable 與 beta 會還原以 npm 安裝的外掛套件。

標記最佳實務¶

• 為你希望 git 檢出落點的版本加上標記（vYYYY.M.D 或 vYYYY.M.D-<patch>）。
• 保持標記不可變：不要移動或重複使用標記。
• npm dist-tag 仍是 npm 安裝的權威來源：
• latest → stable
• beta → 候選建置
• dev → main 快照（選用）

macOS App 可用性¶

Beta 與 dev 建置可能不包含 macOS App 發佈。這是可以接受的： Docker 是 選用 的。

• 仍可發佈 git 標記與 npm dist-tag。
• 請在發佈說明或變更紀錄中註明「此 beta 無 macOS 建置」。