更新 OpenClaw：確保你的 Gateway 穩定運行

追蹤快速疊代的開源專案最怕遇到「更新即爆炸」的情況，特別是當你的服務已經上線。OpenClaw 目前處於 pre-1.0 階段，更新頻率非常快。如果你不想在更新後對著一堆錯誤訊息發呆，這篇指南會告訴你最穩定的升級路徑。

處理更新就像處理基礎設施：先更新，接著執行檢查，最後重啟並驗證。

需要準備的東西

在開始更新前，請先確認以下資訊：

最推薦的更新路徑是重新執行官網的安裝腳本。它會自動偵測現有的安裝路徑，進行就地升級，並在需要時執行 openclaw doctor。

curl -fsSL https://openclaw.ai/install.sh | bash

如果你不希望重新執行設定精靈，可以加上 --no-onboard 參數。如果你是原始碼安裝（git），請使用：

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --no-onboard

如果你是透過 npm 或 pnpm 安裝的，請擇一執行：

npm i -g openclaw@latest
# 或者
pnpm add -g openclaw@latest

注意：我們不建議使用 Bun 執行 Gateway，因為這會導致 WhatsApp 或 Telegram 出現 bug。

更新完成後，請依序執行以下指令來確保環境正常：

openclaw doctor
openclaw gateway restart
openclaw health

如果你想切換更新頻道（例如測試 beta 功能），可以使用：

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

對於從 GitHub clone 下來的開發版本，建議直接使用內建指令：

openclaw update

這個指令會執行一套安全的流程：確保工作區乾淨、切換頻道、執行 git pull --rebase、安裝依賴並重新編譯，最後自動重啟 Gateway（除非你加上 --no-restart）。

如果你偏好手動操作，流程如下：

git pull
pnpm install
pnpm build
pnpm ui:build
openclaw doctor
openclaw health

無論你用哪種方式更新，openclaw doctor 是最核心的工具。它的任務就是「修復、遷移、警告」。它會幫你處理過時的設定鍵值、檢查 DM 政策安全性，並確保 Linux 上的 systemd 服務在登出後依然運行。

如果你是原始碼安裝，執行 openclaw doctor 時它也會主動詢問是否要先執行更新。

如果你在更新過程中卡住了，可以執行 openclaw doctor 並仔細閱讀輸出訊息，通常解決方案就在裡面。

如果新版本有問題，你可以隨時指定版本號裝回去：

npm i -g openclaw@<版本號>
openclaw doctor
openclaw gateway restart

對於原始碼安裝，可以利用 git 回退到特定日期的狀態：

git checkout "$(git rev-list -n 1 --before="2026-01-01" origin/main)"
pnpm install
pnpm build

有任何設定上的疑問，可以詢問 AI Setup Assistant。

OpenClaw Expert

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