[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"article-how-to-update-openclaw-any-platform-zh":3,"tags-how-to-update-openclaw-any-platform-zh":34,"related-lang-how-to-update-openclaw-any-platform-zh":47,"related-posts-how-to-update-openclaw-any-platform-zh":51,"series-tools-0af9dff5-4682-4a38-bcf1-8e3440058369":88},{"id":4,"title":5,"content":6,"summary":7,"source":8,"source_url":9,"author":10,"image_url":11,"keywords":12,"language":22,"translated_content":10,"views":23,"is_premium":24,"created_at":25,"updated_at":25,"cover_image":11,"published_at":26,"rewrite_status":27,"rewrite_error":10,"rewritten_from_id":28,"slug":29,"category":30,"related_article_id":31,"status":32,"google_indexed_at":33,"x_posted_at":10,"tweet_text":10,"title_rewritten_at":10,"title_original":10,"key_takeaways":10,"topic_cluster_id":10,"embedding":10,"is_canonical_seed":24},"0af9dff5-4682-4a38-bcf1-8e3440058369","任何平台更新 OpenClaw 教學","\u003Cp>你的 \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fopenclaw\" target=\"_blank\" rel=\"noopener\">OpenClaw\u003C\u002Fa> 如果還卡在舊版，很多修補和安全更新就吃不到。這種事很常見，尤其你把狀態放在 \u003Ccode>~\u002F.openclaw\u003C\u002Fcode> 時。講白了，更新很簡單，但細節沒顧好就會翻車。\u003C\u002Fp>\u003Cp>這篇直接講實作。你會看到怎麼查版本、怎麼備份、怎麼在 \u003Ca href=\"https:\u002F\u002Fbrew.sh\" target=\"_blank\" rel=\"noopener\">Homebrew\u003C\u002Fa>、npm、Linux 套件管理器和 Docker 更新。也會講常見失敗情境，像是容器明明說最新，結果跑的還是舊映像。\u003C\u002Fp>\u003Cp>我先講結論。更新前先看版本，再備份，再升級。這三步沒做，後面任何問題都很難查。\u003C\u002Fp>\u003Ch2>先確認你現在跑哪個版本\u003C\u002Fh2>\u003Cp>更新前先看版本。這不是廢話，這是省時間。你如果不先記錄舊版，之後很難比對行為差異。\u003C\u002Fp>\n\u003Cfigure class=\"my-6\">\u003Cimg src=\"https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1775199984923-ljdj.png\" alt=\"任何平台更新 OpenClaw 教學\" class=\"rounded-xl w-full\" loading=\"lazy\" \u002F>\u003C\u002Ffigure>\n\u003Cp>本機安裝可以直接跑這個指令：\u003C\u002Fp>\u003Cp>\u003Ccode>openclaw --version\u003C\u002Fcode>\u003C\u002Fp>\u003Cp>如果你用 Docker，就不要只看 tag。tag 會變，快取也會騙人。你要看實際映像和 digest，才知道容器到底吃到哪個版本。\u003C\u002Fp>\u003Cp>版本確認這步，對排錯很有用。像是技能載入方式變了、設定檔解析變了、啟動流程變了，你都能快速定位問題是不是更新造成的。\u003C\u002Fp>\u003Cul>\u003Cli>本機安裝：\u003Ccode>openclaw --version\u003C\u002Fcode>\u003C\u002Fli>\u003Cli>Docker：\u003Ccode>docker inspect openclaw | grep -i image\u003C\u002Fcode>\u003C\u002Fli>\u003Cli>Docker 再確認 digest，別只信 tag\u003C\u002Fli>\u003Cli>更新前先記錄舊版，方便回頭比對\u003C\u002Fli>\u003C\u002Ful>\u003Cp>說真的，很多人就是跳過這一步。然後更新完才開始猜。這樣很浪費時間，也很容易把舊問題誤判成新問題。\u003C\u002Fp>\u003Ch2>先備份設定和資料\u003C\u002Fh2>\u003Cp>\u003Ca href=\"\u002Fnews\u002Fopenclaw-update-guide-safe-upgrades-2026-zh\">Open\u003C\u002Fa>Claw 常把使用者資料放在 \u003Ccode>~\u002F.openclaw\u003C\u002Fcode>。裡面可能有設定、API keys，還有歷史資料。你只要動到升級，先備份就對了。\u003C\u002Fp>\u003Cp>本機備份很簡單，直接複製一份即可：\u003C\u002Fp>\u003Cp>\u003Ccode>cp -r ~\u002F.openclaw ~\u002F.openclaw-backup-$(date +%Y%m%d)\u003C\u002Fcode>\u003C\u002Fp>\u003Cp>這樣會產生有日期的備份。萬一新版改了設定格式，你還有退路。對 Docker 來說，狀況通常比較單純，因為資料多半是掛載進容器，不是直接寫死在容器內。\u003C\u002Fp>\u003Cp>如果你是把 \u003Ccode>~\u002F.openclaw\u003C\u002Fcode> 掛到 \u003Ccode>\u002Fhome\u002Fnode\u002F.openclaw\u003C\u002Fcode>，重建容器不會把資料洗掉。這就是容器化的好處之一。你可以更新映像，但資料還留在主機上。\u003C\u002Fp>\u003Cblockquote>“The only way to go fast, is to go well.” — Robert C. Martin\u003C\u002Fblockquote>\u003Cp>這句話拿來講升級很貼切。先備份，再動手。你花 1 分鐘備份，通常比事後救火省 30 分鐘以上。\u003C\u002Fp>\u003Cp>如果你是團隊共用環境，備份更重要。因為一次升級失敗，不只影響你自己，還可能卡住別人的工作流程。\u003C\u002Fp>\u003Ch2>在 npm、Homebrew、Linux、Docker 更新\u003C\u002Fh2>\u003Cp>更新方式取決於你怎麼裝的。這點很重要。你如果裝在 npm，卻跑 Homebrew 的指令，當然不會有用。\u003C\u002Fp>\n\u003Cfigure class=\"my-6\">\u003Cimg src=\"https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1775199981028-5ov0.png\" alt=\"任何平台更新 OpenClaw 教學\" class=\"rounded-xl w-full\" loading=\"lazy\" \u002F>\u003C\u002Ffigure>\n\u003Cp>如果你是 npm 全域安裝，更新可以這樣做：\u003C\u002Fp>\u003Cp>\u003Ccode>npm update -g openclaw\u003C\u002Fcode>\u003C\u002Fp>\u003Cp>如果你想直接拿最新版，也可以用：\u003C\u002Fp>\u003Cp>\u003Ccode>npm install -g openclaw@latest\u003C\u002Fcode>\u003C\u002Fp>\u003Cp>macOS 用 Homebrew 的話，指令很直白：\u003C\u002Fp>\u003Cp>\u003Ccode>brew update && brew upgrade openclaw\u003C\u002Fcode>\u003C\u002Fp>\u003Cp>Linux 則要看發行版。Debian 和 Ubuntu 常用 \u003Ccode>apt\u003C\u002Fcode>。Arch 則是 \u003Ccode>pacman\u003C\u002Fcode>。\u003C\u002Fp>\u003Cul>\u003Cli>Debian 或 Ubuntu：\u003Ccode>sudo apt update && sudo apt upgrade openclaw\u003C\u002Fcode>\u003C\u002Fli>\u003Cli>Arch Linux：\u003Ccode>sudo pacman -Syu openclaw\u003C\u002Fcode>\u003C\u002Fli>\u003Cli>Docker：先 pull，再 stop、remove、重建容器\u003C\u002Fli>\u003Cli>想少管維護，可看 \u003Ca href=\"https:\u002F\u002Fopenclawlaunch.com\" target=\"_blank\" rel=\"noopener\">OpenClaw Launch\u003C\u002Fa>\u003C\u002Fli>\u003C\u002Ful>\u003Cp>Docker 這邊最容易踩雷。你只 pull 映像，不代表正在跑的容器會換掉。你還是得停掉舊容器，再用新映像重建。\u003C\u002Fp>\u003Cp>如果你不想自己盯升級，\u003Ca href=\"https:\u002F\u002Fopenclawlaunch.com\" target=\"_blank\" rel=\"noopener\">OpenClaw Launch\u003C\u002Fa> 主打自動更新和代管部署。它的價格大概是每月 3 美元。對比自己顧多個環境，這筆錢其實不算高。\u003C\u002Fp>\u003Cp>我覺得這裡的差別很現實。你要的是控制權，還是少一點維運。這沒有標準答案，但你最好先想清楚。\u003C\u002Fp>\u003Ch2>驗證升級，順便比一下維護成本\u003C\u002Fh2>\u003Cp>升級完不要急著收工。先驗證版本，再跑一個真實請求。版本號只代表檔案變了，不代表整個流程都正常。\u003C\u002Fp>\u003Cp>你可以再跑一次：\u003C\u002Fp>\u003Cp>\u003Ccode>openclaw --version\u003C\u002Fcode>\u003C\u002Fp>\u003Cp>如果是 Docker，記得檢查 im\u003Ca href=\"\u002Fnews\u002Fai-agents-trust-control-security-tools-zh\">age\u003C\u002Fa> digest。然後重啟 service，因為很多服務不會自動載入新 binary。\u003C\u002Fp>\u003Cp>不同安裝方式的維護成本，其實差很多。下面這個比較很實際：\u003C\u002Fp>\u003Cul>\u003Cli>npm：適合本來就用 Node 工具鏈的人，但權限問題常出現\u003C\u002Fli>\u003Cli>Homebrew：macOS 上最省事，更新指令清楚\u003C\u002Fli>\u003Cli>Linux 套件管理器：流程穩，但發版速度看發行版\u003C\u002Fli>\u003Cli>Docker：隔離乾淨，但還是得自己管映像和容器重建\u003C\u002Fli>\u003C\u002Ful>\u003Cp>還有一個常被忽略的成本，就是排錯時間。如果新版改了設定格式，你可能要重命名 \u003Ccode>~\u002F.openclaw\u002Fopenclaw.json\u003C\u002Fcode>，再從備份搬資料。這些都不是大事，但疊起來很煩。\u003C\u002Fp>\u003Cp>如果 npm 權限出問題，有人會直接用 \u003Ccode>sudo npm update -g openclaw\u003C\u002Fcode>。但長期來看，把全域 prefix 放到家目錄，通常更乾淨，也少很多權限衝突。\u003C\u002Fp>\u003Ch2>更新失敗時，先看這幾種狀況\u003C\u002Fh2>\u003Cp>大多數失敗都逃不出幾類。第一種是權限錯誤。第二種是設定檔不相容。第三種是 Docker 快取讓你看錯版本。\u003C\u002Fp>\u003Cp>npm 權限錯誤，通常是因為全域安裝目錄不能寫。短期可以用 sudo 硬解，但長期最好改全域 prefix。這樣你不用每次升級都跟系統權限吵架。\u003C\u002Fp>\u003Cp>如果更新後啟動失敗，先看 release notes 和 changelog。很多時候，作者早就寫了遷移方式。你如果先刪設定，反而會把原本能救的資料弄沒。\u003C\u002Fp>\u003Cp>Docker 的 cache 問題也很常見。你明明 pull 了，卻還是舊版。這時候別猜，直接確認 digest。那才是最準的。\u003C\u002Fp>\u003Cp>Op\u003Ca href=\"\u002Fnews\u002Fjiuwenclaw-self-evolving-ai-agent-zh\">enCl\u003C\u002Fa>aw 更新其實不難。你只要把它當成一般 production 變更：先查版本、先備份、從正確管道升級、最後做驗證。流程一清楚，很多問題就不會發生。\u003C\u002Fp>\u003Cp>如果你每天都在用它，更新策略就不該靠運氣。你可以自己管，也可以交給代管服務。差別不是技術高低，是你想把時間花在哪裡。\u003C\u002Fp>\u003Ch2>OpenClaw 為何要這樣升級\u003C\u002Fh2>\u003Cp>這題其實牽涉到軟體發佈方式。Node 工具、系統套件、容器映像，各自有各自的節奏。OpenClaw 這種工具如果同時支援多平台，就一定會出現版本分歧。\u003C\u002Fp>\u003Cp>npm 走的是 JavaScript 生態。Homebrew 偏向 macOS 使用者。Linux 套件管理器跟發行版綁很緊。Docker 則把環境包起來，但你還是要處理映像更新和容器重建。\u003C\u002Fp>\u003Cp>這也是為什麼很多工具最後都會提供多條升級路徑。不是因為複雜，而是因為使用者真的分散。開發者社群裡，有人愛本機安裝，有人直接上容器，有人乾脆丟到代管平台。\u003C\u002Fp>\u003Cp>如果你想看官方原始碼和發佈節奏，可以直接看 \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fopenclaw\" target=\"_blank\" rel=\"noopener\">OpenClaw GitHub\u003C\u002Fa>。要看 macOS 套件流程，就看 \u003Ca href=\"https:\u002F\u002Fbrew.sh\" target=\"_blank\" rel=\"noopener\">Homebrew\u003C\u002Fa>。如果你在意容器來源，則要盯官方映像和 digest，而不是只看 tag。\u003C\u002Fp>\u003Cp>這種工具的維運重點很務實。不是每次升級都會出事，但只要出一次，你就會知道備份有多重要。這就是現場經驗，不是理論。\u003C\u002Fp>\u003Ch2>最後怎麼做最穩\u003C\u002Fh2>\u003Cp>我的建議很直接。先查版本，再備份，然後用你原本的安裝管道升級。升級後立刻跑一次真實工作流，確認設定、技能和啟動都正常。\u003C\u002Fp>\u003Cp>如果你在團隊環境裡用 OpenClaw，我會建議把升級流程寫成固定腳本。至少把版本檢查、備份和驗證變成標準步驟。這樣你下次更新時，不用重新想一次。\u003C\u002Fp>\u003Cp>如果你想少碰維運，代管方案會比較省心。反過來說，如果你很在意掌控每個細節，自管就比較適合你。你現在用的是哪一種？如果你已經踩過 Docker cache 或 npm 權限坑，這篇流程應該可以幫你少走幾次冤枉路。\u003C\u002Fp>","教你在 Mac、Windows、Linux 和 Docker 更新 OpenClaw。先查版本、先備份，再處理 npm、Homebrew、套件管理器與容器常見升級問題。","openclawlaunch.com","https:\u002F\u002Fopenclawlaunch.com\u002Fguides\u002Fopenclaw-update",null,"https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1775199984923-ljdj.png",[13,14,15,16,17,18,19,20,21],"OpenClaw","更新教學","npm","Homebrew","Docker","Linux","版本檢查","備份","升級問題","zh",0,false,"2026-04-02T01:09:31.761605+00:00","2026-04-03T07:04:12.877378+00:00","done","546437ef-4f82-45af-a9af-7bcf280135a3","how-to-update-openclaw-any-platform-zh","tools","4b282edf-509f-4584-915d-13c27393dbc6","published","2026-04-07T07:41:10.018+00:00",[35,36,37,39,40,41,43,45],{"name":20,"slug":20},{"name":14,"slug":14},{"name":16,"slug":38},"homebrew",{"name":15,"slug":15},{"name":21,"slug":21},{"name":18,"slug":42},"linux",{"name":13,"slug":44},"openclaw",{"name":17,"slug":46},"docker",{"id":31,"slug":48,"title":49,"language":50},"how-to-update-openclaw-any-platform-en","How to Update OpenClaw on Any Platform","en",[52,58,64,70,76,82],{"id":53,"slug":54,"title":55,"cover_image":56,"image_url":56,"created_at":57,"category":30},"d058a76f-6548-4135-8970-f3a97f255446","why-gemini-api-pricing-is-cheaper-than-it-looks-zh","為什麼 Gemini API 定價其實比看起來更便宜","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1778869845081-j4m7.png","2026-05-15T18:30:25.797639+00:00",{"id":59,"slug":60,"title":61,"cover_image":62,"image_url":62,"created_at":63,"category":30},"68e4be16-dc38-4524-a6ea-5ebe22a6c4fb","why-vidhub-huiyuan-hutong-bushi-quan-shebei-tongyong-zh","為什麼 VidHub 會員互通不是「買一次全設備通用」","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1778789450987-advz.png","2026-05-14T20:10:24.048988+00:00",{"id":65,"slug":66,"title":67,"cover_image":68,"image_url":68,"created_at":69,"category":30},"7a1e174f-746b-4e82-a0e3-b2475ab39747","why-buns-zig-to-rust-experiment-is-right-zh","為什麼 Bun 的 Zig-to-Rust 實驗是對的","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1778767879127-5dna.png","2026-05-14T14:10:26.886397+00:00",{"id":71,"slug":72,"title":73,"cover_image":74,"image_url":74,"created_at":75,"category":30},"e742fc73-5a65-4db3-ad17-88c99262ceb7","why-openai-api-pricing-is-product-strategy-zh","為什麼 OpenAI API 定價是產品策略，不是註腳","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1778749859485-chvz.png","2026-05-14T09:10:26.003818+00:00",{"id":77,"slug":78,"title":79,"cover_image":80,"image_url":80,"created_at":81,"category":30},"c757c5d8-eda9-45dc-9020-4b002f4d6237","why-claude-code-prompt-design-beats-ide-copilots-zh","為什麼 Claude Code 的提示設計贏過 IDE Copilot","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1778742645084-dao9.png","2026-05-14T07:10:29.371901+00:00",{"id":83,"slug":84,"title":85,"cover_image":86,"image_url":86,"created_at":87,"category":30},"4adef3ab-9f07-4970-91cf-77b8b581b348","why-databricks-model-serving-is-right-default-zh","為什麼 Databricks Model Serving 是生產推論的正確預設","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1778692245329-a2wt.png","2026-05-13T17:10:30.659153+00:00",[89,94,99,104,109,114,119,124,129,134],{"id":90,"slug":91,"title":92,"created_at":93},"de769291-4574-4c46-a76d-772bd99e6ec9","googles-biggest-gemini-launches-in-2026-zh","Google 2026 最大 Gemini 盤點","2026-03-26T07:26:39.21072+00:00",{"id":95,"slug":96,"title":97,"created_at":98},"855cd52f-6fab-46cc-a7c1-42195e8a0de4","surepath-real-time-mcp-policy-controls-zh","SurePath 推出即時 MCP 政策控管","2026-03-26T07:57:40.77233+00:00",{"id":100,"slug":101,"title":102,"created_at":103},"9b19ab54-edef-4dbd-9ce4-a51e4bae4ebb","mcp-in-2026-the-ai-tool-layer-teams-use-zh","2026 年 MCP：團隊真的在用的 AI 工具層","2026-03-26T08:01:46.589694+00:00",{"id":105,"slug":106,"title":107,"created_at":108},"af9c46c3-7a28-410b-9f04-32b3de30a68c","prompting-in-2026-what-actually-works-zh","2026 提示工程，真正有用的是什麼","2026-03-26T08:08:12.453028+00:00",{"id":110,"slug":111,"title":112,"created_at":113},"05553086-6ed0-4758-81fd-6cab24b575e0","garry-tan-open-sources-claude-code-toolkit-zh","Garry Tan 開源 Claude Code 工具包","2026-03-26T08:26:20.068737+00:00",{"id":115,"slug":116,"title":117,"created_at":118},"042a73a2-18a2-433d-9e8f-9802b9559aac","github-ai-projects-to-watch-in-2026-zh","2026 必看 20 個 GitHub AI 專案","2026-03-26T08:28:09.619964+00:00",{"id":120,"slug":121,"title":122,"created_at":123},"a5f94120-ac0d-4483-9a8b-63590071ac6a","claude-code-vs-cursor-2026-zh","Claude Code 與 Cursor 深度對比：202…","2026-03-26T13:27:14.279193+00:00",{"id":125,"slug":126,"title":127,"created_at":128},"0975afa1-e0c7-4130-a20d-d890eaed995e","practical-github-guide-learning-ml-2026-zh","2026 機器學習入門 GitHub 實用指南","2026-03-27T01:16:49.712576+00:00",{"id":130,"slug":131,"title":132,"created_at":133},"bfdb467a-290f-4a80-b3a9-6f081afb6dff","aiml-2026-student-ai-ml-lab-repo-review-zh","AIML-2026：像課綱的學生實驗 Repo","2026-03-27T01:21:51.467798+00:00",{"id":135,"slug":136,"title":137,"created_at":138},"80cabc3e-09fc-4ff5-8f07-b8d68f5ae545","ai-trending-github-repos-and-research-feeds-zh","AI Trending：把 AI 資源收成一張表","2026-03-27T01:31:35.262183+00:00"]