OpenClaw 要怎麼更新？

在裝 OpenClaw 的那台電腦或主機上執行 openclaw update。它會自己判斷安裝方式（npm、pnpm、Bun、git），檢查新版之後才切換。想先看它會做什麼，可以加 --dry-run 預覽，不會改任何東西。用 Mac App 的話，官方文件寫要透過 App 自己的更新功能。

OpenClaw 更新要多久？

我在 2 核心 4 GB 的雲端測試機上，從 2026.10.2 更新到 2026.10.3，openclaw update 花了 4 分鐘：準備 16 秒、檢查新版 98 秒、切換和更新後的整理 123 秒。電腦比較快或版本差比較少，時間會不一樣。

OpenClaw 更新會不會把設定或資料弄壞？

官方的設計是先在旁邊檢查新版，設定、資料庫結構、Node 版本、外掛四項都通過才切換，而且切換前會替資料庫做快照。我實測時四項都是 ok。官方文件還是建議大版本更新前自己先備份，7 月以前的舊版要先升到 2026.9.5，再升到最新版。

OpenClaw 可以自動更新嗎？

可以，但預設是關的。官方文件寫，在 ~/.openclaw/openclaw.json 把 update.auto.enabled 設成 true，或在控制台的 Settings → Updates 打開。前提是 Gateway 要裝成系統服務，直接在終端機跑的 Gateway 只會提示有更新，不會自己換。

OpenClaw 怎麼更新？一行 openclaw update，我從 2026.10.2 實測更新到 2026.10.3

OpenClaw 改版改得很勤。我在 10 月 14 日查 npm 上的版本清單，10 月以來就有 2026.10.1、10.2、10.3 三個正式版，另外還有 2026.10.5 的測試版。裝好之後沒多久，你大概就會看到「有新版本」的提示。

這篇講怎麼更新、更新時會看到什麼、要注意哪些事。我在雲端測試機上用 npm 裝了舊版 2026.10.2，實際跑一次預覽和更新，下面的時間和訊息都是那次的。還沒裝 OpenClaw 的話，先看 OpenClaw 安裝怎麼選。

一行指令：openclaw update

官方文件推薦的做法就是在裝 OpenClaw 的那台電腦或主機上執行：

openclaw update

它會自己判斷你是怎麼裝的（npm、pnpm、Bun 或從原始碼用 git 裝），不用記不同的指令。比較特別的是它不會直接覆蓋：先把新版放在旁邊，用新版的程式檢查你的設定、資料庫、Node.js 版本和外掛能不能用，都通過才切換過去，切換前還會替資料庫做一份快照。

幾個常用的寫法：

openclaw update status：看目前的版本、更新管道、有沒有新版。
openclaw update --dry-run：只預覽會做哪些事，不改任何東西。
openclaw update --yes：跳過確認提示，適合寫在腳本或遠端執行。
openclaw update --channel beta：改用測試版的管道，以後都跟著測試版更新。

實測：從 2026.10.2 更新到 2026.10.3

測試機是 2 核心 4 GB 的 Ubuntu，裝的是 Node.js 24.21.0 和 npm 11.19.0。我先用 npm 裝舊版 2026.10.2，花了 41 秒，openclaw --version 顯示 OpenClaw 2026.10.2。

先看狀態

openclaw update status 列出三行：安裝方式是 npm、更新管道是 stable（預設）、有新版本 2026.10.3 可以更新。最後一行直接告訴你下一步：Run: openclaw update。

它還附了一個警告：找不到系統服務管理員，更新後要自己重新啟動 Gateway。這是因為我的測試機沒有 systemd，一般的 Linux 主機或 Mac 不會有這個問題。

預覽要做什麼

openclaw update --dry-run 跑了 3 秒，開頭就寫 No changes were applied，接著列出：目前版本 2026.10.2、目標版本 2026.10.3、更新模式 npm，以及它打算做的四件事：

用 npm 換成 openclaw@2026.10.3。
更新完同步外掛。
必要的話更新指令補完的快取。
重新啟動 Gateway 服務，並跑健康檢查（doctor）。

正式更新

接著執行 openclaw update --yes，前後花了 4 分鐘。結束時的摘要寫了它經過的四個階段：準備 16 秒、放置新版不到 1 秒、檢查新版 98 秒、切換和更新後的整理 123 秒。

檢查那一段列了四項，全部是 ok：設定（config）、資料庫結構（database-schema）、Node.js 版本（node-runtime）、外掛能不能用（plugin-availability）。中間它替兩個資料庫做了快照，跑了一次健康檢查，外掛的部分顯示不需要更新。最後一行是：

✅ OpenClaw updated to 2026.10.3 (from 2026.10.2).

再跑 openclaw --version，顯示 OpenClaw 2026.10.3；openclaw update status 變成 up to date。

過程中有幾個黃色的警告，例如 Gateway 只綁在本機、建議之後跑 openclaw doctor --fix 完成延後的修復。這些都是我的測試環境沒有設定完整造成的提醒，不影響更新本身成功。

更新前要注意的事

很舊的版本要分兩步。官方文件寫，2026 年 7 月以前裝的版本，要先升到 2026.9.5、跑過它的資料搬移，再升到最新版。直接跳到最新版，健康檢查會擋下來並告訴你怎麼做。

大版本更新前自己先備份。自動做的設定副本和資料庫快照，官方說不等於完整的備份。

Linux 上用 systemd 跑的話，服務如果被停用或遮蔽（masked），更新前要先解除，不然更新會在一開始就拒絕執行。

更新完記得重啟 Gateway。如果 Gateway 是裝成系統服務，更新會負責重新啟動它；如果你是直接在終端機開著跑，要自己關掉再開。

其他安裝方式不是用這個指令：Mac 的 OpenClaw App 要用 App 自己的更新功能；用 Docker 跑的，是換新的映像檔。手機和電腦 App 怎麼裝，在 OpenClaw App 怎麼下載。

另外，我用 npm 11.19 裝的時候，npm 跳出幾行警告，說 OpenClaw 底下幾個套件的安裝腳本沒有執行。OpenClaw 本身照常能用，更新也成功。官方文件給的 npm 安裝指令，在 npm 11.16 以上會加上 --allow-scripts=openclaw，我裝的時候也有加。

要不要開自動更新

Gateway 的自動更新預設是關的。要打開，官方文件寫有兩種方式：在 ~/.openclaw/openclaw.json 把 update.auto.enabled 設成 true，或在控制台的 Settings → Updates 開啟。

前提是 Gateway 要裝成系統服務，這樣它才能安全地換版本、重新啟動。直接在終端機跑的 Gateway，只會提示有新版，不會自己更新。

更新管道也會影響自動更新的行為。stable（預設）會在新版出來一段時間後，分批推給大家；beta 一有新版就更新；extended-stable 只提示、永遠不會自動更新，適合想穩定、不想常變動的人。我查的時候，extended-stable 是 2026.8.35，stable 是 2026.10.3。

如果你的 OpenClaw 是放在 Hostinger 這類 VPS 上、裝成系統服務，開自動更新可以省掉自己定期連進去更新的麻煩；放在家裡電腦、偶爾才開的，手動跑 openclaw update 就夠了。OpenClaw 要選 Hostinger 哪一級方案、續約價多少，我整理在 Hostinger 評價。

這篇沒有測的

Gateway 裝成系統服務時的自動重啟、自動更新實際觸發、從 7 月以前的舊版分兩步升級、Mac App 和 Docker 的更新方式。我的測試機沒有 systemd，也沒有讓 Gateway 在背景執行。

更新完成後實際跟助理對話。這次沒有設定 AI 模型。