[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"article-install-openclaw-windows-powershell-wsl2-zh":3,"article-related-install-openclaw-windows-powershell-wsl2-zh":30,"series-tools-551239ec-2ece-4733-989a-ff59d6b8141b":75},{"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":22,"views":26,"created_at":27,"published_at":28,"topic_cluster_id":29},"551239ec-2ece-4733-989a-ff59d6b8141b","install-openclaw-windows-powershell-wsl2-zh","Windows PowerShell 安裝 OpenClaw 成果版","\u003Cp data-speakable=\"summary\">這篇教你在 Windows 上完成 \u003Ca href=\"\u002Ftag\u002Fopenclaw\">OpenClaw\u003C\u002Fa> 安裝，並驗證 gateway、模型連線與可用環境。\u003C\u002Fp>\u003Cp>這篇給想在 Windows 上把 OpenClaw 跑起來的開發者看，目標是少踩坑地完成\u003Ca href=\"\u002Fnews\u002Fllama-cpp-vs-vllm-benji-mo-xing-yin-qing-zen-me-xuan-zh\">本機\u003C\u002Fa>安裝、模型供應商設定與可用性驗證。照著做完，你會拿到一個可用的 OpenClaw 安裝結果、已連好的 Kimi \u003Ca href=\"\u002Ftag\u002Fapi\">API\u003C\u002Fa> key，還能判斷要走 PowerShell、WSL2，或直接改用雲端方案。\u003C\u002Fp>\u003Cp>如果你只想快速開始，也會知道何時應該跳過本機環境，直接用 \u003Ca href=\"https:\u002F\u002Fwww.kimi.com\u002Fresources\u002Fopenclaw-saas\">Kimi Claw\u003C\u002Fa>。本指南會交叉參考 \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fopenclaw\">OpenClaw GitHub repo\u003C\u002Fa> 與 \u003Ca href=\"https:\u002F\u002Fopenclaw.ai\u002Fdocs\">官方安裝文件\u003C\u002Fa>，方便你對照官方流程。\u003C\u002Fp>\u003Ch2>開始之前\u003C\u002Fh2>\u003Cul>\u003Cli>Windows 10 或 Windows 11，64-bit\u003C\u002Fli>\u003Cli>PowerShell 以目前使用者執行，若要裝 WSL2 則需要系統管理員權限\u003C\u002Fli>\u003Cli>Node.js 22.14 以上\u003C\u002Fli>\u003Cli>Git for Windows\u003C\u002Fli>\u003Cli>至少 4 GB RAM，建議 8 GB\u003C\u002Fli>\u003Cli>穩定網路連線\u003C\u002Fli>\u003Cli>Kimi Platform 帳號，用來建立 API key\u003C\u002Fli>\u003Cli>OpenClaw 存取權限或安裝網址\u003C\u002Fli>\u003Cli>若要使用 WSL2，BIOS 或 UEFI 需開啟虛擬化\u003C\u002Fli>\u003C\u002Ful>\u003Ch2>Step 1: 啟用 PowerShell 腳本並啟動安裝器\u003C\u002Fh2>\u003Cp>這一步的目的，是讓 PowerShell 能執行 OpenClaw 的安裝腳本，並直接拉起 Windows 安裝流程。這是最快的本機路徑，適合先驗證環境是否能跑。\u003C\u002Fp>\n\u003Cfigure class=\"my-6\">\u003Cimg src=\"https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1782093775396-g5vp.png\" alt=\"Windows PowerShell 安裝 OpenClaw 成果版\" class=\"rounded-xl w-full\" loading=\"lazy\" \u002F>\u003C\u002Ffigure>\n\u003Cpre>\u003Ccode>Set-ExecutionPolicy RemoteSigned -Scope CurrentUser\niwr -useb https:\u002F\u002Fopenclaw.ai\u002Finstall.ps1 | iex\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>你應該看到安裝精靈開啟，或在終端機中出現初始設定提示。若腳本被擋下來，先確認你已用目前使用者層級修改執行政策，再重新執行一次。\u003C\u002Fp>\u003Ch2>Step 2: 完成 onboarding 並選 QuickStart\u003C\u002Fh2>\u003Cp>這一步的目的，是把第一次啟動的提示走完，並選擇最簡單的設定路徑。QuickStart 適合想先把服務跑起來、之後再調整細節的開發者。\u003C\u002Fp>\n\u003Cfigure class=\"my-6\">\u003Cimg src=\"https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1782093765392-qwby.png\" alt=\"Windows PowerShell 安裝 OpenClaw 成果版\" class=\"rounded-xl w-full\" loading=\"lazy\" \u002F>\u003C\u002Ffigure>\n\u003Cp>在精靈裡先接受風險提示，再於 onboarding mode 選擇 QuickStart。若你想完全手動控制，也可以選 Manual，但會多出更多提示與決策。\u003C\u002Fp>\u003Cp>你應該看到安裝器接著進入模型設定流程。若畫面停在終端機沒有進度，關閉 PowerShell 後重新開啟，再跑一次安裝器。\u003C\u002Fp>\u003Ch2>Step 3: 建立 Kimi API key 並連接模型\u003C\u002Fh2>\u003Cp>這一步的目的，是把 OpenClaw 連到模型供應商，讓 \u003Ca href=\"\u002Ftag\u002Fagent\">agent\u003C\u002Fa> 可以實際執行任務。OpenClaw 使用 Kimi Platform 做驗證，所以在 agent 啟動前必須先有有效的 API key。\u003C\u002Fp>\u003Cp>打開 \u003Ca href=\"https:\u002F\u002Fplatform.kimi.com\">Kimi Platform\u003C\u002Fa>，前往 API Keys 建立新 key。把 key 貼回 onboarding 提示，若有選項可用，預設模型選 \u003Ccode>moonshot\u002Fkimi-k2.5\u003C\u002Fcode>。這個 key 只會顯示一次，建立後請妥善保存。\u003C\u002Fp>\u003Cp>你應該看到精靈接受 key，並往 channel 與效能設定前進。若 key 被拒絕，先檢查是否完整複製，並確認帳號權限層級符合要求。\u003C\u002Fp>\u003Ch2>Step 4: 完成設定並驗證 gateway\u003C\u002Fh2>\u003Cp>這一步的目的，是把剩下的提示走完，並確認 OpenClaw gateway 已經真的在跑。這個檢查會告訴你安裝是否可用，還是仍缺少某個服務步驟。\u003C\u002Fp>\u003Cp>繼續完成 channel 選擇、效能設定與 hook 設定，直到精靈顯示完成。接著在 PowerShell 或終端機執行驗證指令：\u003C\u002Fp>\u003Cpre>\u003Ccode>openclaw gateway status\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>你應該看到 running 的 gateway 狀態，這代表 OpenClaw 已可接收 agent 請求。若狀態是 stopped 或找不到，請重新執行 onboarding，或手動啟動 gateway。\u003C\u002Fp>\u003Ch2>Step 5: 建立 WSL2 Ubuntu 環境\u003C\u002Fh2>\u003Cp>這一步的目的，是在 WSL2 裡安裝 OpenClaw，適合想要完整 Linux 功能的情境。若你需要 systemd、較順的 \u003Ca href=\"\u002Ftag\u002Fnpm\">npm\u003C\u002Fa> build，或更接近伺服器的行為，這條路通常更穩。\u003C\u002Fp>\u003Cpre>\u003Ccode>wsl --install -d Ubuntu\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>Windows 重新啟動後，打開 Ubuntu，建立 Linux 使用者名稱與密碼。接著用 \u003Ccode>wsl --list --verbose\u003C\u002Fcode> 確認 Ubuntu 已出現在清單中。\u003C\u002Fp>\u003Cp>你應該看到 Ubuntu 成功啟動，且 WSL 回報該 distro 已安裝。若看不到，先確認 BIOS 或 UEFI 已開啟虛擬化，並且 PowerShell 是以系統管理員身分執行。\u003C\u002Fp>\u003Ch2>Step 6: 安裝 Node.js、OpenClaw 與 daemon\u003C\u002Fh2>\u003Cp>這一步的目的，是把 Linux 環境、執行階段與服務模式準備好，讓 OpenClaw 可以自動啟動。這會建立一個更耐用的安裝結果，適合長期使用。\u003C\u002Fp>\u003Cpre>\u003Ccode>sudo tee \u002Fetc\u002Fwsl.conf > \u002Fdev\u002Fnull << 'EOF'\n[boot]\nsystemd=true\n[interop]\nenabled=true\nappendWindowsPath=true\nEOF\n\nwsl --shutdown\ncurl -fsSL https:\u002F\u002Fdeb.nodesource.com\u002Fsetup_22.x | sudo -E bash -\nsudo apt-get install -y nodejs\nsudo npm install -g openclaw@latest\nopenclaw onboard --install-daemon\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>接著用 \u003Ccode>node --version\u003C\u002Fcode> 與 \u003Ccode>openclaw --version\u003C\u002Fcode> 驗證安裝。你應該看到 Node 22.x 以上與有效的 OpenClaw 版本字串。若 systemd 沒有啟用，回到 Ubuntu 後檢查 \u003Ccode>ps -p 1 -o comm=\u003C\u002Fcode> 是否回傳 \u003Ccode>systemd\u003C\u002Fcode>。\u003C\u002Fp>\u003Ch2>Step 7: 改用 Kimi Claw 省略本機安裝\u003C\u002Fh2>\u003Cp>這一步的目的，是在你想要最快拿到可用 agent 時，直接跳過本機部署。Kimi \u003Ca href=\"\u002Fnews\u002Fclawx-openclaw-desktop-app-zh\">Claw\u003C\u002Fa> 會在瀏覽器中提供 OpenClaw，不需要 Node.js、WSL 或手動處理 API key 流程。\u003C\u002Fp>\u003Cp>打開 \u003Ca href=\"https:\u002F\u002Fwww.kimi.com\u002Fresources\u002Fopenclaw-saas\">Kimi Claw\u003C\u002Fa>，建立 instance，並確認部署完成。工作區通常約兩分鐘內可開啟，裡面已經備好 gateway、工具與儲存。\u003C\u002Fp>\u003Cp>你應該看到瀏覽器工作區載入完成，且 agent 已可直接使用。若如此，代表你已完成部署，可以開始自動化任務，不必再處理 Windows 服務或 Linux 設定。\u003C\u002Fp>\u003Ctable>\u003Cthead>\u003Ctr>\u003Cth>指標\u003C\u002Fth>\u003Cth>基準／優化前\u003C\u002Fth>\u003Cth>結果／優化後\u003C\u002Fth>\u003C\u002Ftr>\u003C\u002Fthead>\u003Ctbody>\u003Ctr>\u003Ctd>設定步驟\u003C\u002Ftd>\u003Ctd>PowerShell 或 WSL2，且有多個手動檢查\u003C\u002Ftd>\u003Ctd>單指令 PowerShell 安裝，或直接使用瀏覽器版 Kimi Claw\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>所需環境\u003C\u002Ftd>\u003Ctd>Windows 加上 Node.js，WSL2 為選配\u003C\u002Ftd>\u003Ctd>PowerShell 路徑只需 Windows；Kimi Claw 不需本機 runtime\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>首次可用時間\u003C\u002Ftd>\u003Ctd>需先完成 runtime 與服務設定\u003C\u002Ftd>\u003Ctd>Kimi Claw 約兩分鐘即可進入工作區\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>功能覆蓋\u003C\u002Ftd>\u003Ctd>本機安裝依路徑而異\u003C\u002Ftd>\u003Ctd>Kimi Claw 提供完整 agent 工作區與雲端持久化\u003C\u002Ftd>\u003C\u002Ftr>\u003C\u002Ftbody>\u003C\u002Ftable>\u003Ch2>常見錯誤\u003C\u002Fh2>\u003Cul>\u003Cli>Node.js 版本低於 22.14：先升級到 Node 22.14 以上，再重新執行安裝器。\u003C\u002Fli>\u003Cli>沒有調整 PowerShell 執行政策：把 CurrentUser 設為 \u003Ccode>RemoteSigned\u003C\u002Fcode>，然後重開 PowerShell。\u003C\u002Fli>\u003Cli>WSL2 沒有啟用 systemd：在 \u003Ccode>\u002Fetc\u002Fwsl.conf\u003C\u002Fcode> 加入 \u003Ccode>systemd=true\u003C\u002Fcode>，再執行 \u003Ccode>wsl --shutdown\u003C\u002Fcode> 並重新開啟 Ubuntu。\u003C\u002Fli>\u003C\u002Ful>\u003Ch2>接下來可以看什麼\u003C\u002Fh2>\u003Cp>OpenClaw 跑起來之後，下一步可以接訊息通道、加入 \u003Ca href=\"\u002Ftag\u002Fskills\">skills\u003C\u002Fa>，並決定日常工作要用本機 gateway 還是雲端工作區。若你打算進入正式環境，先閱讀 OpenClaw 的\u003Ca href=\"\u002Fnews\u002Fsouth-korea-anthropic-ai-safety-cybersecurity-mou-zh\">安全\u003C\u002Fa>性與遠端存取說明，再把任何 UI 或服務暴露到 localhost 以外。\u003C\u002Fp>","這份指南教你在 Windows 上用 PowerShell、WSL2 或 Kimi Claw 完成 OpenClaw 安裝、連接模型供應商，並驗證 gateway 是否可用。","www.kimi.com","https:\u002F\u002Fwww.kimi.com\u002Fresources\u002Fhow-to-install-openclaw-on-windows",null,"https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1782093775396-g5vp.png","tools","zh","573d2a49-84d8-4017-9118-55bc5586dab9",[17,18,19,20,21],"OpenClaw","PowerShell","WSL2","Kimi Platform","Node.js",[23,24,25],"先用 PowerShell 快速驗證，再視需求切到 WSL2 或 Kimi Claw。","安裝完成後要檢查 gateway 狀態，不能只看腳本有跑完。","WSL2 路徑的關鍵是 Node 22.x、systemd 與 daemon 安裝。",0,"2026-06-22T02:02:28.203938+00:00","2026-06-22T02:02:28.201+00:00","6bc36f08-aed4-4cad-9812-92e8f881689b",{"tags":31,"relatedLang":34,"relatedPosts":38},[32],{"name":17,"slug":33},"openclaw",{"id":15,"slug":35,"title":36,"language":37},"install-openclaw-windows-powershell-wsl2-en","Install OpenClaw on Windows with PowerShell","en",[39,45,51,57,63,69],{"id":40,"slug":41,"title":42,"cover_image":43,"image_url":43,"created_at":44,"category":13},"27b9156f-d888-4fb6-8922-a607e16ad7c4","anthropic-github-repositories-claude-code-push-zh","Anthropic GitHub 91 個倉庫，Claude Code 加速","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1782082984505-d1hq.png","2026-06-21T23:02:28.590393+00:00",{"id":46,"slug":47,"title":48,"cover_image":49,"image_url":49,"created_at":50,"category":13},"142b6b02-b02b-40a9-a9f5-e3e4807ef3d4","cudf-turns-pandas-code-into-gpu-runs-zh","cuDF 讓 pandas 直接跑上 GPU","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1782058732771-box2.png","2026-06-21T16:18:27.113079+00:00",{"id":52,"slug":53,"title":54,"cover_image":55,"image_url":55,"created_at":56,"category":13},"4860bd59-d197-4c32-a4aa-e3f53aa08d7a","bigquery-vectorized-python-udfs-arrow-zh","BigQuery Arrow 向量化 Python UDF 實作","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1782027159471-91jd.png","2026-06-21T07:32:19.997774+00:00",{"id":58,"slug":59,"title":60,"cover_image":61,"image_url":61,"created_at":62,"category":13},"642eb00a-f3cd-422f-9d29-e113dc82e5d3","apples-gemini-powered-siri-seo-stakes-zh","Apple Siri 接上 Gemini，SEO 壓力升高","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1782011869139-s32t.png","2026-06-21T03:17:28.557729+00:00",{"id":64,"slug":65,"title":66,"cover_image":67,"image_url":67,"created_at":68,"category":13},"03ca3c65-1597-4a56-aaf5-09949ec0b995","databricks-custom-model-serving-endpoints-zh","Databricks 端點讓你少猜","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1782003811403-1hhn.png","2026-06-21T01:03:09.88432+00:00",{"id":70,"slug":71,"title":72,"cover_image":73,"image_url":73,"created_at":74,"category":13},"1210fbca-7d00-4a0d-9be2-39163079dbb0","go-turns-team-chaos-into-boring-builds-zh","Go 把團隊混亂變成穩定建置","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1781971401098-zdl4.png","2026-06-20T16:02:53.571588+00:00",[76,81,86,91,96,101,106,111,116,121],{"id":77,"slug":78,"title":79,"created_at":80},"855cd52f-6fab-46cc-a7c1-42195e8a0de4","surepath-real-time-mcp-policy-controls-zh","SurePath 推出即時 MCP 政策控管","2026-03-26T07:57:40.77233+00:00",{"id":82,"slug":83,"title":84,"created_at":85},"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":87,"slug":88,"title":89,"created_at":90},"af9c46c3-7a28-410b-9f04-32b3de30a68c","prompting-in-2026-what-actually-works-zh","2026 提示工程，真正有用的是什麼","2026-03-26T08:08:12.453028+00:00",{"id":92,"slug":93,"title":94,"created_at":95},"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":97,"slug":98,"title":99,"created_at":100},"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":102,"slug":103,"title":104,"created_at":105},"a5f94120-ac0d-4483-9a8b-63590071ac6a","claude-code-vs-cursor-2026-zh","Claude Code 與 Cursor 深度對比：202…","2026-03-26T13:27:14.279193+00:00",{"id":107,"slug":108,"title":109,"created_at":110},"0975afa1-e0c7-4130-a20d-d890eaed995e","practical-github-guide-learning-ml-2026-zh","2026 機器學習入門 GitHub 實用指南","2026-03-27T01:16:49.712576+00:00",{"id":112,"slug":113,"title":114,"created_at":115},"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":117,"slug":118,"title":119,"created_at":120},"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":122,"slug":123,"title":124,"created_at":125},"3ce6e6e2-bac5-463e-9f8d-45caabcc61f7","awesome-ai-for-science-research-tools-map-zh","AI 科研工具清單，開始像地圖了","2026-03-27T01:46:50.521945+00:00"]