如何在 Windows 上安裝 OpenClaw

OpenClaw 是打造 AI 工作流程的強大工具，但對初學者而言，在 Windows 上設定可能不太直覺。本指南會帶你了解主要安裝方式，讓你能快速開始。

OpenClaw Windows 安裝：3 種方法比較

在開始操作前，先快速了解在 Windows 上安裝 OpenClaw 的三種方式。各方法在設定時間、功能完整度與技術需求上各有取捨。

Kimi Claw 是一款線上工具，可讓你在瀏覽器中執行 OpenClaw。它會自動處理安裝與設定，因此你不需要設定 Node.js、WSL 或 API key。幾分鐘內即可開始使用已就緒的 agent。

若要進行本機 PowerShell 或 WSL2 設定，請往下查看方法 1或方法 2。若想完全省略本機安裝，請直接跳到方法 3：Kimi Claw。如果想更快開始，也可以立刻著手。

在 Windows 本機安裝 OpenClaw 前需要準備什麼

若你打算在本機安裝 OpenClaw，請確認系統符合以下需求。若選擇 Kimi Claw 這類雲端方案，則可直接略過本節。

系統需求

• Windows 10 或 Windows 11（64-bit）

• 至少 4 GB RAM（若要穩定建置 npm，建議 8 GB）

• 穩定的網際網路連線

• 若選擇 WSL2，初始設定需要系統管理員權限

• OpenClaw WSL2：必須在 BIOS/UEFI 中啟用虛擬化

必要軟體

• Node.js 22.14 或更高版本。 OpenClaw 需要現代化的 Node.js 執行環境。請從 nodejs.org 下載，或透過 onboarding script 安裝。

• Git for Windows（選用但建議安裝）。部分 npm 套件與 skills 依賴 Git。

方法 1：使用 PowerShell 在 Windows 上安裝 OpenClaw

相較於 WSL2，PowerShell 方法步驟較少，也不需要 Linux 環境。只要一行指令就能下載 OpenClaw、檢查你的 Node.js 版本，並啟動 onboarding wizard。此方法適用於 Windows 10 與 Windows 11。

步驟 1：安裝並執行你的 OpenClaw

為保護系統，Windows 預設會限制腳本執行。在安裝 OpenClaw 前，你必須先執行這個「安全開關」指令，允許 PowerShell 執行本機腳本：

接著，執行以下指令：

執行指令後，你應該會看到類似下方截圖的輸出。繼續進行 onboarding 前，請關閉並重新開啟 PowerShell，以重新整理系統 PATH。

步驟 2：確認風險提示並選擇 onboarding 模式

選取 Yes 以確認你已了解風險並繼續。

接著選取 QuickStart，快速開始 onboarding。你之後仍可調整設定；若要完整配置，也可以選擇 Manual。

步驟 3：設定並驗證你的 AI 模型

1. 選擇 Moonshot AI 作為模型／驗證提供者

1. 驗證並設定你的 AI 模型

若要連接 OpenClaw，請透過 Kimi Platform 啟用你的 Kimi API Key。儲值 $5 可獲得$5 獎勵券，但我們建議儲值 $20 以上，以解鎖 Tier 2 存取權限。這能降低延遲，並確保你的 OpenClaw agent 能處理複雜的多步驟任務。

1. 建立 Kimi API key

前往 API Keys 區段並點選 Create API Key。請務必將你的 API Key 保存在安全且方便取用的位置；它只會在建立時顯示一次。

1. 輸入你的 API key 並選擇預設模型

當 onboarding wizard 提示時，將你專屬的 API key 貼到 PowerShell/Terminal 視窗中。

當系統要求選擇預設模型時，請選取 moonshot/kimi-k2.5（若已反白顯示，則可選擇「Keep current」）。此模型在 agentic 任務的速度與推理能力之間取得最佳平衡。

步驟 4：選擇頻道

選擇你想連接到 OpenClaw 的應用程式。若不確定，可以直接略過。

步驟 5：設定效能選項

點選 Yes 進行設定，或點選 No 略過。

步驟 6：啟用 Hooks

選擇與 bot 對話的方式，然後等待它開始執行。

步驟 7：執行你的 OpenClaw

完成以上步驟後，就可以開始使用 OpenClaw。

方法 2：使用 WSL2 在 Windows 上安裝 OpenClaw

OpenClaw WSL2 設定可在 Windows 內提供完整的 Linux 環境，也是官方建議的 OpenClaw 執行方式。此方法能使用完整功能，包括 systemd daemon 管理、原生 shell 腳本，以及更順暢的 npm 建置。若你打算在 Windows 上將 OpenClaw 用於日常工作流程或開發，OpenClaw WSL 是最佳選擇。

步驟 1：在 Windows 11/10 上為 OpenClaw 啟用 WSL2

以系統管理員身分開啟 PowerShell，並執行：

此指令會啟用 WSL、下載 Ubuntu 並進行安裝。流程完成後，請重新啟動電腦。Windows 重新啟動後，Ubuntu 會啟動並要求你建立使用者名稱與密碼。

如果你已安裝 WSL，請檢查：

步驟 2：為 systemd 設定 WSL2

OpenClaw 會使用 systemd 作為背景服務執行。請在 WSL 設定中啟用它：

接著從 PowerShell 重新啟動 WSL：

重新開啟 Ubuntu terminal，並確認 systemd 正在執行：

輸出應顯示 systemd。若顯示的是 init，請再次檢查你的 /etc/wsl.conf 檔案。

步驟 3：安裝 Node.js 22.14+

OpenClaw 需要 Node.js 22.14 或更新版本。請從 NodeSource repository 安裝：

確認安裝結果：

步驟 4：透過 npm 安裝 OpenClaw

Node.js 就緒後，請全域安裝 OpenClaw：

或者，使用官方安裝腳本：

確認安裝結果：

步驟 5：透過 onboarding 完成 OpenClaw Windows 設定

使用 daemon flag 執行 onboarding wizard，將 OpenClaw 設定為 systemd service：

wizard 會引導你完成：

• 選擇你的 LLM provider 並輸入 API key

• 選擇預設模型

• 設定訊息頻道（選用）

• 將 gateway 安裝為背景服務

onboarding 完成後，請啟用服務持續性，讓 OpenClaw 在 WSL 啟動時自動啟動：

gateway 是處理所有 OpenClaw 作業的核心背景服務，包括 agent 請求、訊息傳遞與模型執行。確認它正在執行，代表你的 OpenClaw 安裝已完成且可開始使用，也能避免後續步驟發生錯誤。

在 PowerShell 或 WSL terminal 中執行以下指令以檢查狀態：

方法 3：使用 Kimi Claw 在 Windows 上執行 OpenClaw（無需設定）

如果管理 Node.js、WSL 和 API keys 對你來說太繁瑣，Kimi Claw 提供更簡單的 OpenClaw 執行方式。你可以直接在瀏覽器中執行 OpenClaw，無需本機設定或手動配置。請依照以下步驟開始：

步驟 1：開啟 Kimi Claw 並建立 instance

前往 Kimi Claw 頁面，點選 Create 開始。

步驟 2：開始部署

在彈出視窗中確認部署。Kimi Claw 會在約兩分鐘內完成 OpenClaw 環境設定，包括 gateway、workspace 與工具。全程不需要指令或手動配置。

步驟 3：在你的 workspace 中工作

部署完成後，你的 workspace 會在儀表板中開啟。你可以直接在瀏覽器中與 AI agent 對話、設定 skills、配置排程任務，並管理檔案。

Kimi Claw 提供哪些功能

• 零 設定：不需要管理 Node.js、WSL 或 API key

• 40 GB 雲端儲存空間：儲存報告、資料集與產生的檔案，並可跨工作階段保留

• 持續記憶：你的 AI agent 會記住過去互動、偏好與脈絡

• 5,000+ ClawHub skills：立即使用自動化、研究、coding 與分析 skills

• 排程任務自動化：設定每日報告、提醒、監控等週期性任務

• 支援任何裝置：可從 Windows、Mac 或行動裝置上的任何瀏覽器存取你的 OpenClaw agent

OpenClaw 的 Windows 防火牆與安全設定

Kimi Claw 會在雲端伺服器上自動處理安全與網路設定。若你偏好使用 PowerShell 或 WSL2 在本機安裝 OpenClaw，安裝後建議完成幾項安全設定。

• 設定 Windows Firewall

OpenClaw gateway 第一次啟動時，Windows Firewall 可能會提示你允許網路存取。請只允許私人網路。若你使用 OpenClaw WSL2，gateway 會在 Linux 環境中執行並透過 localhost 通訊，因此通常不需要額外的防火牆規則。

如果 Browser Relay 或其他功能無法連線，請確認 localhost 流量沒有被 antivirus programs、VPN clients 或 corporate firewalls 等第三方安全軟體封鎖。

• 保護 Control UI

OpenClaw Control UI 會在 port 18789 上執行，並提供對你的 agent 的完整存取權限。絕對不要將此 port 暴露到公用網際網路。 請讓 gateway 綁定在 127.0.0.1，並只從本機存取。

若要安全地遠端存取，請使用 Tailscale 建立私人網路通道：

如此可讓 port 保持在 localhost，同時透過你的私人 Tailscale 網路存取。

Windows 上常見的 OpenClaw 安裝錯誤與修正方式

即使有清楚的指南，安裝過程中仍可能遇到問題。以下列出在 Windows 上安裝 OpenClaw 時最常回報的問題與修正方式。

無法辨識 OpenClaw

• 原因： npm global bin directory 不在你的系統 PATH 中。

• 修正： 執行以下指令找出你的 npm prefix

將輸出路徑加入 Windows environment variables。不要附加 \\bin。接著關閉並重新開啟 PowerShell。

安裝時找不到 Git

• 原因： 尚未安裝 Git for Windows。

• 修正： 從 git-scm.com 下載並安裝 Git。安裝完成後，重新啟動 PowerShell，並再次執行 OpenClaw Windows installer。

Node.js 版本太舊

• 原因： 你的系統使用較舊版本的 Node.js，不符合最低需求（v22.14+）。

• 修正： 從 nodejs.org 下載並安裝最新 LTS 版本。若你使用 OpenClaw WSL2，請透過 NodeSource repository 重新安裝。

權限遭拒錯誤

• 原因： PowerShell 權限不足，或 npm global directory 不可寫入。

• 修正： 以系統管理員身分執行 PowerShell，或將 npm global prefix 改為使用者可寫入的目錄

Gateway 無法啟動

• 原因： Port 18789 已被使用，或設定檔已損毀。

• 修正： 檢查是否有衝突的程序，並重新啟動

WSL2 systemd 無法運作

• 原因： /etc/wsl.conf 檔案缺少 systemd 設定。

• 修正： 確認檔案包含正確設定

若缺少該設定，請新增後在 PowerShell 中使用 wsl --shutdown 重新啟動 WSL。

結論

依你的需求不同，在 Windows 上安裝 OpenClaw 可以只是簡單的腳本設定，也可以是較進階的 WSL2 環境。若你想要完整掌控與高度彈性，PowerShell 和 WSL2 都是可靠選擇。若你想跳過設定、立即開始，Kimi Claw 可讓你在瀏覽器中執行 OpenClaw，無需本機設定。選擇最符合你的工作流程與技術熟悉度的方式，就能充分發揮 OpenClaw 的價值。