[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"article-7-ways-to-install-openclaw-zh":3,"article-related-7-ways-to-install-openclaw-zh":35,"series-industry-fd2045a8-4772-4615-981c-eabdfa7f558d":85},{"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":27,"views":31,"created_at":32,"published_at":33,"topic_cluster_id":34},"fd2045a8-4772-4615-981c-eabdfa7f558d","7-ways-to-install-openclaw-zh","7 種安裝 OpenClaw 的方式","\u003Cp data-speakable=\"summary\">這篇整理 \u003Ca href=\"\u002Ftag\u002Fopenclaw\">OpenClaw\u003C\u002Fa> 的 7 種安裝方式，讓你能依照作業系統、開發習慣與部署情境，快速選出最合適的安裝路徑。\u003C\u002Fp>\u003Cp>如果你想在 10 分鐘內決定要用哪一種安裝法，這份清單會直接告訴你：哪個最快上手、哪個最適合開發、哪個最適合伺服器部署。OpenClaw 的文件把安裝路徑分得很清楚，從安裝腳本到容器化部署都有對應做法，而且還標示了 Node 24 為建議版本，Node 22.19 以上也可用。\u003C\u002Fp>\u003Ctable>\u003Cthead>\u003Ctr>\u003Cth>項目\u003C\u002Fth>\u003Cth>安裝型態\u003C\u002Fth>\u003Cth>適合情境\u003C\u002Fth>\u003Cth>關鍵特點\u003C\u002Fth>\u003C\u002Ftr>\u003C\u002Fthead>\u003Ctbody>\u003Ctr>\u003Ctd>安裝腳本\u003C\u002Ftd>\u003Ctd>自動化腳本\u003C\u002Ftd>\u003Ctd>新手、快速安裝\u003C\u002Ftd>\u003Ctd>可偵測系統並補齊必要元件\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>本機前綴安裝\u003C\u002Ftd>\u003Ctd>本機隔離\u003C\u002Ftd>\u003Ctd>想保留獨立環境\u003C\u002Ftd>\u003Ctd>工具與 Node 放在本機前綴\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>npm \u002F pnpm \u002F bun\u003C\u002Ftd>\u003Ctd>套件管理器\u003C\u002Ftd>\u003Ctd>已有 Node 工具鏈\u003C\u002Ftd>\u003Ctd>可直接全域安裝 CLI\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>從原始碼安裝\u003C\u002Ftd>\u003Ctd>開發建置\u003C\u002Ftd>\u003Ctd>貢獻者、除錯者\u003C\u002Ftd>\u003Ctd>可直接從本機檢出版本編譯\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>GitHub main 版\u003C\u002Ftd>\u003Ctd>追蹤主分支\u003C\u002Ftd>\u003Ctd>測試最新變更\u003C\u002Ftd>\u003Ctd>安裝器改抓 main 分支\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>容器與套件管理\u003C\u002Ftd>\u003Ctd>部署導向\u003C\u002Ftd>\u003Ctd>伺服器、機群、自動化\u003C\u002Ftd>\u003Ctd>支援 Docker、Podman、Nix、Ansible\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>驗證與完成設定\u003C\u002Ftd>\u003Ctd>安裝後檢查\u003C\u002Ftd>\u003Ctd>確認可用性\u003C\u002Ftd>\u003Ctd>可查版本、診斷與 Gateway 狀態\u003C\u002Ftd>\u003C\u002Ftr>\u003C\u002Ftbody>\u003C\u002Ftable>\u003Ch2>1. 安裝腳本\u003C\u002Fh2>\u003Cp>這是大多數人最省事的做法。你只要執行一行指令，腳本會先檢查你的系統，再補上缺少的項目，最後直接帶你進入初始化流程，不需要先手動處理一堆前置條件。\u003C\u002Fp>\n\u003Cfigure class=\"my-6\">\u003Cimg src=\"https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1780550292997-e3fd.png\" alt=\"7 種安裝 OpenClaw 的方式\" class=\"rounded-xl w-full\" loading=\"lazy\" \u002F>\u003C\u002Ffigure>\n\u003Cp>如果你是 macOS、Linux 或 WSL2 使用者，這條路通常最快。Windows 也有對應的 PowerShell 版本；如果你想要桌面式輔助工具，官方還提供原生 Windows Hub 應用，能看系統匣狀態，也能切到\u003Ca href=\"\u002Fnews\u002Fapples-gemini-deal-turns-cloud-ai-into-local-ai-zh\">本機\u003C\u002Fa> \u003Ca href=\"\u002Ftag\u002Fmcp\">MCP\u003C\u002Fa> 模式。\u003C\u002Fp>\u003Cul>\u003Cli>macOS、Linux、WSL2：\u003Ccode>curl -fsSL https:\u002F\u002Fopenclaw.ai\u002Finstall.sh | bash\u003C\u002Fcode>\u003C\u002Fli>\u003Cli>Windows PowerShell：\u003Ccode>iwr -useb https:\u002F\u002Fopenclaw.ai\u002Finstall.ps1 | iex\u003C\u002Fcode>\u003C\u002Fli>\u003Cli>若要略過初始化，可加上 \u003Ccode>--no-onboard\u003C\u002Fcode>\u003C\u002Fli>\u003C\u002Ful>\u003Ch2>2. 本機前綴安裝\u003C\u002Fh2>\u003Cp>如果你不想把 Node 或 OpenClaw 裝到整台機器的全域環境，本機前綴安裝會比較適合。文件提到的 \u003Ccode>~\u002F.openclaw\u003C\u002Fcode> 這種佈局，就是為了把安裝範圍控制在自己的使用者目錄內。\u003C\u002Fp>\u003Cp>這種方式很適合想要環境隔離的人，尤其是常在不同專案間切換、又不想讓系統級工具互相干擾的使用者。它也支援 \u003Ca href=\"\u002Ftag\u002Fnpm\">npm\u003C\u002Fa> 安裝，並可透過同一條前綴流程處理 git 檢出安裝。\u003C\u002Fp>\u003Cul>\u003Cli>指令：\u003Ccode>curl -fsSL https:\u002F\u002Fopenclaw.ai\u002Finstall-cli.sh | bash\u003C\u002Fcode>\u003C\u002Fli>\u003Cli>適合本機前綴型安裝\u003C\u002Fli>\u003Cli>不想依賴全域 Node 工具鏈時很實用\u003C\u002Fli>\u003C\u002Ful>\u003Ch2>3. npm、pnpm 或 bun\u003C\u002Fh2>\u003Cp>如果你本來就有自己的 Node 工具鏈，直接用套件管理器安裝會最順手。文件列出 npm、pnpm、bun 這三種支援路徑，安裝完後再補一個初始化指令，就能把 daemon 拉起來。\u003C\u002Fp>\n\u003Cfigure class=\"my-6\">\u003Cimg src=\"https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1780550287493-3see.png\" alt=\"7 種安裝 OpenClaw 的方式\" class=\"rounded-xl w-full\" loading=\"lazy\" \u002F>\u003C\u002Ffigure>\n\u003Cp>這類流程對開發者很友善，因為幾乎不用改變現有工作習慣。pnpm 在第一次安裝後需要明確允許建置腳本，bun 則可用於全域 CLI 安裝，但 Gateway 的 daemon 執行環境仍以 Node 為建議選擇。\u003C\u002Fp>\u003Cul>\u003Cli>npm：\u003Ccode>npm install -g openclaw@latest\u003C\u002Fcode>\u003C\u002Fli>\u003Cli>pnpm：\u003Ccode>pnpm add -g openclaw@latest\u003C\u002Fcode>\u003C\u002Fli>\u003Cli>bun：\u003Ccode>bun add -g openclaw@latest\u003C\u002Fcode>\u003C\u002Fli>\u003Cli>接著執行：\u003Ccode>openclaw onboard --install-daemon\u003C\u002Fcode>\u003C\u002Fli>\u003C\u002Ful>\u003Ch2>4. 從原始碼安裝\u003C\u002Fh2>\u003Cp>如果你是貢獻者，或你想直接跑本機檢出的版本，從原始碼安裝會是最有控制權的做法。這條路最適合開發流程，因為你可以自己決定建置、連結與執行方式。\u003C\u002Fp>\u003Cp>流程很直觀：先複製專案，再安裝相依套件，接著建置核心與介面，最後把 CLI 全域連結起來。如果你不想全域 link，也可以直接在倉庫內用 \u003Ccode>pnpm openclaw ...\u003C\u002Fcode> 執行。\u003C\u002Fp>\u003Cpre>\u003Ccode>git clone https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fopenclaw.git\ncd openclaw\npnpm install && pnpm build && pnpm ui:build\npnpm link --global openclaw\nopenclaw onboard --install-daemon\u003C\u002Fcode>\u003C\u002Fpre>\u003Ch2>5. GitHub main 分支檢出\u003C\u002Fh2>\u003Cp>這條路可以理解成「追最新變更」的安裝方式。它仍然透過安裝腳本執行，但會指定從 \u003Ca href=\"\u002Ftag\u002Fgithub\">GitHub\u003C\u002Fa> 的 main 分支拉取，而不是走一般釋出版流程。\u003C\u002Fp>\u003Cp>如果你正在測試功能、驗證修補，或想確認主分支目前的狀態，這種做法很方便。文件把版本指定成 \u003Ccode>main\u003C\u002Fcode>，代表它比較適合需要緊跟開發進度的人，而不是追求穩定釋出的使用者。\u003C\u002Fp>\u003Cul>\u003Cli>指令：\u003Ccode>curl -fsSL --proto '=https' --tlsv1.2 https:\u002F\u002Fopenclaw.ai\u002Finstall.sh | bash -s -- --install-method git --version main\u003C\u002Fcode>\u003C\u002Fli>\u003Cli>適合測試最新主分支狀態\u003C\u002Fli>\u003Cli>仍是用安裝腳本，不是手動 git 編譯\u003C\u002Fli>\u003C\u002Ful>\u003Ch2>6. 容器與套件管理器\u003C\u002Fh2>\u003Cp>如果你是在伺服器、機群或偏好宣告式管理的環境中部署，容器與套件管理器會更符合實務需求。文件把 \u003Ca href=\"\u002Ftag\u002Fdocker\">Docker\u003C\u002Fa>、Podman、Nix、Ansible 和 Bun 這幾種方式放在同一類，\u003Ca href=\"\u002Fnews\u002F5-takeaways-from-spurs-vs-trail-blazers-game-5-zh\">重點\u003C\u002Fa>是部署模型，而不是單一指令。\u003C\u002Fp>\u003Cp>這些選項最適合在意維運一致性的人。Docker 適合容器化或無頭部署，Podman 是無 root 的替代方案，Nix 適合宣告式安裝，Ansible 則很適合自動化佈署到多台主機。\u003C\u002Fp>\u003Cul>\u003Cli>Docker：容器化或無頭部署\u003C\u002Fli>\u003Cli>Podman：無 root 容器替代方案\u003C\u002Fli>\u003Cli>Nix：用 Nix flake 做宣告式安裝\u003C\u002Fli>\u003Cli>Ansible：自動化機群佈署\u003C\u002Fli>\u003C\u002Ful>\u003Ch2>7. 驗證並完成設定\u003C\u002Fh2>\u003Cp>安裝結束後，別急著直接開始用，先確認 CLI 能不能正常呼叫，Gateway 有沒有成功啟動。文件建議先看版本、跑診斷，再查 Gateway 狀態，這樣比較容易提早發現問題。\u003C\u002Fp>\u003Cp>如果你想讓服務跟著系統自動啟動，也可以依平台做對應設定。macOS 會用 LaunchAgent，Linux 和 WSL2 會用 systemd 使用者服務，原生 Windows 則可能改用排程工作，必要時再搭配啟動\u003Ca href=\"\u002Fnews\u002Fcoinstats-api-turns-crypto-data-into-one-stack-zh\">資料\u003C\u002Fa>夾項目。\u003C\u002Fp>\u003Cpre>\u003Ccode>openclaw --version\nopenclaw doctor\nopenclaw gateway status\u003C\u002Fcode>\u003C\u002Fpre>\u003Ch2>怎麼挑\u003C\u002Fh2>\u003Cp>如果你要的是最少步驟，先選安裝腳本；如果你想要環境隔離，本機前綴安裝更合適；如果你本來就有 Node 工具鏈，npm、pnpm 或 bun 會最順手。對開發者來說，從原始碼安裝最彈性；對需要追最新變更的人，main 分支檢出最直接。\u003C\u002Fp>\u003Cp>至於伺服器、容器平台或多機自動化部署，Docker、Podman、Nix 與 Ansible 會比手動安裝更穩。簡單說，第一次安裝選腳本，寫程式選原始碼，做部署選容器或自動化工具，通常不會錯。\u003C\u002Fp>","7 種安裝 OpenClaw 的方法一次看懂，包含腳本、套件管理器、原始碼與容器，幫你快速選出最適合的安裝路徑。","docs.openclaw.ai","https:\u002F\u002Fdocs.openclaw.ai\u002Finstall",null,"https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1780550292997-e3fd.png","industry","zh","733b6421-021f-4531-b3ba-80359e582574",[17,18,19,20,21,22,23,24,25,26],"OpenClaw","安裝方式","Node.js","npm","pnpm","bun","Docker","Podman","Nix","Ansible",[28,29,30],"安裝腳本最適合新手與快速上手","已有 Node 工具鏈的人可直接用 npm、pnpm 或 bun","開發者與貢獻者適合從原始碼安裝，部署團隊則適合容器或自動化方案",0,"2026-06-04T05:17:41.00891+00:00","2026-06-04T05:17:40.984+00:00","caa87b65-9bbc-46fe-bba8-4f4158dd2d8b",{"tags":36,"relatedLang":44,"relatedPosts":48},[37,39,40,42,43],{"name":19,"slug":38},"nodejs",{"name":20,"slug":20},{"name":17,"slug":41},"openclaw",{"name":18,"slug":18},{"name":21,"slug":21},{"id":15,"slug":45,"title":46,"language":47},"7-ways-to-install-openclaw-en","7 ways to install OpenClaw","en",[49,55,61,67,73,79],{"id":50,"slug":51,"title":52,"cover_image":53,"image_url":53,"created_at":54,"category":13},"d73870f0-f463-413f-8f4e-0b859ca78c97","ai-fraud-blockchain-finance-defenses-zh","AI 詐騙跑太快，防線怎麼追","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1780557487797-7fzf.png","2026-06-04T07:17:34.282107+00:00",{"id":56,"slug":57,"title":58,"cover_image":59,"image_url":59,"created_at":60,"category":13},"c64ecc12-d2bf-419c-938f-407b6ae2d74c","5-blockchain-ai-market-signals-for-buyers-zh","5 個區塊鏈 AI 市場訊號","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1780556577201-iu8x.png","2026-06-04T07:02:25.523387+00:00",{"id":62,"slug":63,"title":64,"cover_image":65,"image_url":65,"created_at":66,"category":13},"06734645-2e2f-4903-9e47-e6ac889e34b7","game-thread-prompt-turns-nba-chatter-into-template-zh","Game-thread prompt 把聊天變模板","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1780547608583-tp2j.png","2026-06-04T04:33:05.772212+00:00",{"id":68,"slug":69,"title":70,"cover_image":71,"image_url":71,"created_at":72,"category":13},"c323ffb6-20c8-468a-9d37-68e801588ee5","5-takeaways-from-spurs-vs-trail-blazers-game-5-zh","5 個 Spurs 對 Trail Blazers Game 5 重點","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1780546677776-oc0j.png","2026-06-04T04:17:25.558061+00:00",{"id":74,"slug":75,"title":76,"cover_image":77,"image_url":77,"created_at":78,"category":13},"0231f359-f786-4e6c-8104-d3fae443f98b","4-chipotle-promo-details-for-members-zh","4 個 Chipotle 會員活動重點","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1780540375071-5xa3.png","2026-06-04T02:32:19.54736+00:00",{"id":80,"slug":81,"title":82,"cover_image":83,"image_url":83,"created_at":84,"category":13},"39e4c1b2-4a8d-4baf-86eb-f65d4f6c3624","why-chipotle-53000-burrito-stunt-smart-brand-marketing-zh","為什麼 Chipotle 的 53,000 捲餅活動是聰明的品牌行銷","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1780538579630-nkln.png","2026-06-04T02:02:28.454411+00:00",[86,91,96,101,106,111,116,121,126,131],{"id":87,"slug":88,"title":89,"created_at":90},"ee073da7-28b3-4752-a319-5a501459fb87","ai-in-2026-what-actually-matters-now-zh","2026 AI 真正重要的事","2026-03-26T07:09:12.008134+00:00",{"id":92,"slug":93,"title":94,"created_at":95},"83bd1795-8548-44c9-9a7e-de50a0923f71","trump-ai-framework-power-speech-state-preemption-zh","川普 AI 框架瞄準電力、言論與州權","2026-03-26T07:12:18.695466+00:00",{"id":97,"slug":98,"title":99,"created_at":100},"ea6be18b-c903-4e54-97b7-5f7447a612e0","nvidia-gtc-2026-big-ai-announcements-zh","NVIDIA GTC 2026 重點拆解","2026-03-26T07:14:26.62638+00:00",{"id":102,"slug":103,"title":104,"created_at":105},"4bcec76f-4c36-4daa-909f-54cd702f7c93","claude-users-spreading-out-and-getting-better-zh","Claude 用戶更分散，也更會用","2026-03-26T07:22:52.325888+00:00",{"id":107,"slug":108,"title":109,"created_at":110},"bd903b15-2473-4178-9789-b7557816e535","openclaw-raises-hard-question-for-ai-models-zh","OpenClaw 逼問 AI 模型價值","2026-03-26T07:24:54.707486+00:00",{"id":112,"slug":113,"title":114,"created_at":115},"eeac6b9e-ad9d-4831-8eec-8bba3f9bca6a","gap-google-gemini-checkout-fashion-search-zh","Gap 把結帳搬進 Gemini","2026-03-26T07:28:23.937768+00:00",{"id":117,"slug":118,"title":119,"created_at":120},"0740e53f-605d-4d57-8601-c10beb126f3c","google-pushes-gemini-transition-to-march-2026-zh","Google 把 Gemini 轉換延到 2026 年 3…","2026-03-26T07:30:12.825269+00:00",{"id":122,"slug":123,"title":124,"created_at":125},"e660d801-2421-4529-8fa9-86b82b066990","metas-llama-4-benchmark-scandal-gets-worse-zh","Meta Llama 4 分數風波又擴大","2026-03-26T07:34:21.156421+00:00",{"id":127,"slug":128,"title":129,"created_at":130},"183f9e7c-e143-40bb-a6d5-67ba84a3a8bc","accenture-mistral-ai-sovereign-enterprise-deal-zh","Accenture 攜手 Mistral AI 賣主權 AI","2026-03-26T07:38:14.818906+00:00",{"id":132,"slug":133,"title":134,"created_at":135},"191d9b1b-768a-478c-978c-dd7431a38149","mistral-ai-faces-its-hardest-year-yet-zh","Mistral AI 迎來最硬的一年","2026-03-26T07:40:23.716374+00:00"]