[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"article-how-to-update-openclaw-any-platform-zh":3,"article-related-how-to-update-openclaw-any-platform-zh":29,"series-tools-0af9dff5-4682-4a38-bcf1-8e3440058369":81},{"id":4,"slug":5,"title":6,"content":7,"summary":8,"source":9,"source_url":10,"author":11,"image_url":12,"cover_image":12,"category":13,"language":14,"translated_content":11,"related_article_id":15,"keywords":16,"key_takeaways":11,"views":26,"created_at":27,"published_at":28,"topic_cluster_id":11},"0af9dff5-4682-4a38-bcf1-8e3440058369","how-to-update-openclaw-any-platform-zh","任何平台更新 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","tools","zh","4b282edf-509f-4584-915d-13c27393dbc6",[17,18,19,20,21,22,23,24,25],"OpenClaw","更新教學","npm","Homebrew","Docker","Linux","版本檢查","備份","升級問題",6,"2026-04-02T01:09:31.761605+00:00","2026-04-03T07:04:12.877378+00:00",{"tags":30,"relatedLang":40,"relatedPosts":44},[31,33,34,36,38],{"name":20,"slug":32},"homebrew",{"name":19,"slug":19},{"name":22,"slug":35},"linux",{"name":17,"slug":37},"openclaw",{"name":21,"slug":39},"docker",{"id":15,"slug":41,"title":42,"language":43},"how-to-update-openclaw-any-platform-en","How to Update OpenClaw on Any Platform","en",[45,51,57,63,69,75],{"id":46,"slug":47,"title":48,"cover_image":49,"image_url":49,"created_at":50,"category":13},"c7266fac-bc4e-477c-93c6-1b0e45c7f0c2","happyhorse-11-video-api-workflow-zh","HappyHorse 1.1 把影片 API 變流程","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1782775990911-iqho.png","2026-06-29T23:32:45.976839+00:00",{"id":52,"slug":53,"title":54,"cover_image":55,"image_url":55,"created_at":56,"category":13},"8714d537-05ab-477f-a6a2-f1534fe7baea","sora-ai-2026-realistic-video-generation-guide-zh","Sora 2026 影片生成遷移指南","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1782774166692-6sig.png","2026-06-29T23:02:21.311473+00:00",{"id":58,"slug":59,"title":60,"cover_image":61,"image_url":61,"created_at":62,"category":13},"6d635736-4581-484c-aa7f-9c221b54215b","pixelrag-screenshots-retrievable-context-zh","PixelRAG 把截圖變可檢索上下文","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1782759807854-613a.png","2026-06-29T19:02:59.448799+00:00",{"id":64,"slug":65,"title":66,"cover_image":67,"image_url":67,"created_at":68,"category":13},"cdfe98b4-cfc9-4266-ba45-4b892e8214b0","codex-deepseek-v4-pro-moark-setup-zh","Codex 接入 DeepSeek-V4-Pro，三步可用","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1782738175563-wcfd.png","2026-06-29T13:02:24.814293+00:00",{"id":70,"slug":71,"title":72,"cover_image":73,"image_url":73,"created_at":74,"category":13},"37ef32c4-b40c-4d2e-822a-d41678837de1","devin-ai-alternatives-real-workflows-zh","Devin 替代工具先看工作流","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1782732810886-up7s.png","2026-06-29T11:32:58.321746+00:00",{"id":76,"slug":77,"title":78,"cover_image":79,"image_url":79,"created_at":80,"category":13},"d98bcfa9-686a-4465-8371-ba06d04b9799","claude-code-turns-agent-setup-into-terminal-work-zh","Claude Code 讓代理設定變終端工作","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1782731910840-j284.png","2026-06-29T11:18:01.715271+00:00",[82,87,92,97,102,107,112,117,122,127],{"id":83,"slug":84,"title":85,"created_at":86},"855cd52f-6fab-46cc-a7c1-42195e8a0de4","surepath-real-time-mcp-policy-controls-zh","SurePath 推出即時 MCP 政策控管","2026-03-26T07:57:40.77233+00:00",{"id":88,"slug":89,"title":90,"created_at":91},"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":93,"slug":94,"title":95,"created_at":96},"af9c46c3-7a28-410b-9f04-32b3de30a68c","prompting-in-2026-what-actually-works-zh","2026 提示工程，真正有用的是什麼","2026-03-26T08:08:12.453028+00:00",{"id":98,"slug":99,"title":100,"created_at":101},"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":103,"slug":104,"title":105,"created_at":106},"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":108,"slug":109,"title":110,"created_at":111},"a5f94120-ac0d-4483-9a8b-63590071ac6a","claude-code-vs-cursor-2026-zh","Claude Code 與 Cursor 深度對比：202…","2026-03-26T13:27:14.279193+00:00",{"id":113,"slug":114,"title":115,"created_at":116},"0975afa1-e0c7-4130-a20d-d890eaed995e","practical-github-guide-learning-ml-2026-zh","2026 機器學習入門 GitHub 實用指南","2026-03-27T01:16:49.712576+00:00",{"id":118,"slug":119,"title":120,"created_at":121},"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":123,"slug":124,"title":125,"created_at":126},"80cabc3e-09fc-4ff5-8f07-b8d68f5ae545","ai-trending-github-repos-and-research-feeds-zh","AI Trending：把 AI 資源收成一張表","2026-03-27T01:31:35.262183+00:00",{"id":128,"slug":129,"title":130,"created_at":131},"3ce6e6e2-bac5-463e-9f8d-45caabcc61f7","awesome-ai-for-science-research-tools-map-zh","AI 科研工具清單，開始像地圖了","2026-03-27T01:46:50.521945+00:00"]