2026 年 OpenClaw 升級事故多半不是「新版本壞掉」，而是兩套二進位同時在 PATH 上、launchd 仍指向舊路徑，或設定檔 schema 變更但沒有對照差異。本篇整理：openclaw update 與官方 install.sh 重裝何時用哪條路、npm 全域與原始碼 checkout 並存的典型錯誤、可執行的回滾清單，以及在新加坡、東京、首爾、香港、美西、美東各放一台Mac mini M4 雲 Mac做灰度閘道時，如何用 openclaw health 做業務驗收。首次安裝與常駐流程可先對照 OpenClaw Gateway 常駐與 npm 部署 FAQ。
一、openclaw update 與官方 install.sh：兩條路怎麼選
同一釋出線上，小版本／修補優先用官方支援的 openclaw update：保留您已驗證的設定與守護行程腳本，風險最低。當出現相依斷裂（Node 版本不符、全域 CLI 與閘道 bundle 脫鉤）、或您曾手改過安裝前綴導致目錄結構不一致時，再備份後重跑 install.sh 收斂到官方預設佈局。兩者都跑完後，務必用同一使用者身分執行 openclaw doctor 與 openclaw health，避免「終端機看得到、launchd 看不到」的假陽性。
二、npm 全域與原始碼 checkout 並存：PATH 與模組地獄
常見現象是 command not found、MODULE_NOT_FOUND、或「明明升級了版本字串卻不變」：幾乎都是 which openclaw 指到錯誤前綴，或 NODE_PATH 殘留舊樹。處理順序：① 在登入 shell 與非互動 SSH 各印一次 PATH；② 暫時移除非官方 shim；③ 只保留一條安裝來源（npm 或 原始碼 npm link／本地 node 啟動），另一條改名備份。工具白名單與子行程深度若在新版行為不同，請交叉閱讀 OpenClaw 工具白名單與 maxSpawnDepth FAQ。
三、設定遷移與回滾清單（可列印）
升級前複製 openclaw.json、環境變數樣板、以及 launchd plist 到帶時間戳的目錄；若使用鑰匙圈項目，記下條目名稱與建立帳戶。回滾時依序：停閘道 → 還原 plist 與設定 → 安裝前一版釋出物 → 啟動後立刻跑 openclaw health。磁碟快滿會讓日誌輪替與 TLS 握手變慢，看起來像「網路抽風」，升級前順手清快取與舊日誌。
- 已備份：設定、plist、環境變數、鑰匙圈條目清單
- 已記錄：升級前後
openclaw --version與node -v - 已驗證：本機埠、上游 API、以及 Runner 實際連到的閘道位址
四、多地區 M4 雲 Mac 灰度閘道與 openclaw health 驗收
灰度不是只換二進位：要為每個都會區準備獨立流量比例與可觀測的錯誤預算。建議每區一臺常駐閘道，先以內部帳號與單一頻道驗 openclaw health（程序存活、設定可解析、上游連通、磁碟與檔案權限），再切 5% 真實流量。席位輪換與併聯佇列設計可參考 跨國團隊雲端 Mac 席位與併聯佇列 FAQ，避免灰度期間搶同一閘道。
五、升級當日最小驗收
每一臺閘道在切流量前跑：openclaw doctor（版本與鑑權）、openclaw health（端到端就緒）、以及一條可重播的乾跑對話或工具呼叫。全部綠燈後再開 DNS／負載權重；若僅單區異常，優先比對該區 plist 與 PATH，而不是假設上游 LLM 故障。
在 vpszap 雲上，這一切更簡單
本文假設您能 SSH 到實體 Apple Silicon Mac，CPU／SSD 不與他人共享。vpszap 提供實體 M4 Mac mini、無虛擬化層，約五分鐘開通並交付SSH 與 VNC，按天、週、月、季計費、無長約，節點涵蓋新加坡、東京、首爾、香港、美西、美東，適合每區一臺閘道做灰度與對照實驗。
想把 OpenClaw 跑在可預期的硬體與網路上，請從 vpszap 雲端 Mac mini 首頁 選與控制平面一致的地區。