使用 openclaw update 快速切換版本與頻道

每次看到新版本發佈，心裡總是既期待又怕受傷害。手動拉取代碼、切換分支、重新編譯，這些重複的操作不只浪費時間，還容易在過程中漏掉某些步驟導致系統崩潰。如果你正在尋找一種更直覺、更安全的方式來管理版本，那麼 openclaw update 就是為你準備的。

這套工具幫你處理了所有瑣碎的更新邏輯，無論你是要追求穩定的生產環境，還是想搶先體驗最新的開發功能，都能一鍵完成。

需要準備的東西

OpenClaw 已安裝（透過 npm/pnpm 或 git checkout）
乾淨的 git 工作目錄（如果你是從原始碼安裝，不能有未提交的變更）

快速開始

想要在 5 分鐘內完成更新或切換頻道？跟著這幾個步驟做：

檢查目前狀態：先看看你現在在哪個頻道。
Terminal window
```
openclaw update status
```
執行更新：直接更新到當前頻道的最新版本。
Terminal window
```
openclaw update
```
切換頻道：如果你想試試測試版，可以切換到 beta。
Terminal window
```
openclaw update --channel beta
```
使用小幫手：如果你不確定要選什麼，讓互動式介面引導你。
Terminal window
```
openclaw update wizard
```

常用指令與參數

你可以根據需求靈活使用這些參數：

--no-restart: 更新完成後不要自動重啟 Gateway 服務。
--channel <stable|beta|dev>: 設定更新頻道。這會同時影響 git 和 npm 的來源，並存入設定檔。
--tag <dist-tag|version>: 僅限本次更新使用特定的 npm 標籤或版本。
--json: 輸出機器可讀的 UpdateRunResult JSON 格式。
--timeout <seconds>: 設定每個步驟的超時時間（預設為 1200 秒）。
openclaw --update: 這是 openclaw update 的快捷寫法。

深入了解更新機制

當你切換頻道時，OpenClaw 會自動對齊安裝方式：

dev 頻道：確保你有 git checkout（預設位置在 ~/openclaw），更新代碼並從中安裝全域 CLI。
stable/beta 頻道：直接從 npm 安裝對應的標籤版本。

如果你使用 git 安裝，更新流程會非常嚴謹。它會先檢查你有無未提交的變更，接著切換到目標標籤或分支。在 dev 頻道中，它甚至會在臨時目錄進行 lint 檢查與 TypeScript 編譯，如果最新的 commit 編譯失敗，它會自動往回找最多 10 個 commit，直到找到一個可以正常運作的版本為止。最後，它會執行 openclaw doctor 確保一切正常，並同步你的插件。

疑難排解

版本降級問題：如果你嘗試安裝比目前更舊的版本，系統會要求你確認，因為舊版本可能會弄壞你的設定檔。
更新超時：如果你的網路環境較慢，導致檢查更新失敗，可以嘗試增加超時時間：
Terminal window
```
openclaw update status --timeout 10
```
Git 狀態不乾淨：如果更新失敗並提示 worktree 不乾淨，請先 commit 或 stash 你的變更。

如果你在更新過程中遇到任何無法解決的疑難雜症，歡迎詢問 AI Setup Assistant。

下一步

openclaw doctor: 執行更新後的安全檢查
Development channels: 深入了解各頻道的差異
Updating: 更多關於 npm/pnpm 的更新方式
CLI reference: 完整的指令清單

OpenClaw Expert

還是卡住了？

如果這篇文件沒有解決你的情境，直接問 OpenClaw Expert，拿到可執行步驟。