在 Windows 上安裝 OpenClaw：從 PowerShell 到 WSL2 的完整指南
在 Windows 上開發最煩的就是環境問題。很多工具在 Linux 跑得好好的，一換到 Windows 就會遇到路徑錯誤、權限不足或依賴項噴錯。如果你正想試試 OpenClaw，這篇教學會幫你避開這些常見的坑，讓你在 Windows 也能順暢運行。
懶人包： WSL2 是目前唯一官方認證的穩定路徑。PowerShell 適合快速測試，但有一定的局限性。
需要準備的東西
Section titled “需要準備的東西”在開始之前，請確保你具備以下條件：
- Windows 10 (version 1903+) 或 Windows 11
- PowerShell 5.1 或更新版本 (現代 Windows 已內建)
- API key (來自 Anthropic, OpenAI 或 Google — 或者用 Ollama 跑免費本地模型)
- Node.js (如果你的電腦沒裝，安裝程式會自動幫你處理)
雖然 PowerShell 很快，但官方團隊建議生產環境使用 WSL2。這裡提供兩個路徑供你選擇：
方法 1：PowerShell (快速但有限制)
Section titled “方法 1：PowerShell (快速但有限制)”⚠️ 注意： 原生 PowerShell 安裝尚未經過官方團隊完整測試，可能會遇到工具相容性問題。
以 系統管理員身分 開啟 PowerShell 並執行：
iwr -useb https://openclaw.ai/install.ps1 | iex這個腳本會執行以下動作：
- 檢查 Node.js 22+ (若缺失則透過 winget/Chocolatey/Scoop 安裝)
- 執行
npm install -g openclaw@latest - 啟動設定精靈
如果你想從 GitHub 源碼安裝或自訂目錄，可以使用以下指令：
# 從 GitHub 源碼安裝iwr -useb https://openclaw.ai/install.ps1 | iex -InstallMethod git
# 使用自訂目錄進行 git 安裝iwr -useb https://openclaw.ai/install.ps1 | iex -InstallMethod git -GitDir "C:\openclaw"方法 2：WSL2 (重度使用推薦)
Section titled “方法 2：WSL2 (重度使用推薦)”如果你打算長期使用 OpenClaw 或追求最穩定的體驗，WSL2 是最佳選擇。它能讓你在 Windows 內擁有完整的 Linux 環境。
第一步：安裝 WSL2 以系統管理員身分開啟 PowerShell：
wsl --install完成後請重新啟動電腦。
第二步：啟用 systemd (必要) 重啟後進入 Ubuntu 並執行：
# 為 OpenClaw gateway 啟用 systemdsudo nano /etc/wsl.conf加入以下內容：
[boot]systemd=true儲存 (Ctrl+O, Enter, Ctrl+X) 並在 PowerShell 中重啟 WSL：
wsl --shutdownwsl第三步：在 WSL 中安裝 OpenClaw 在 Ubuntu 終端機執行：
curl -fsSL https://openclaw.ai/install.sh | bash安裝後的配置
Section titled “安裝後的配置”安裝完成後，設定精靈會自動啟動。你需要處理以下兩個核心部分：
1. 配置 AI 模型與聊天頻道
Section titled “1. 配置 AI 模型與聊天頻道”| Provider | 說明 |
|---|---|
| Anthropic (Claude) | 綜合表現最好，需要 API key |
| OpenAI | 適合寫程式 |
| Google Gemini | 提供免費額度 |
| Ollama | 完全免費，在本地端執行 |
接著選擇你偏好的通訊軟體：WhatsApp, Telegram, Discord 或 iMessage。
2. 安裝 Gateway Daemon
Section titled “2. 安裝 Gateway Daemon”當系統詢問時，建議將 Gateway 安裝為 Daemon，這樣 OpenClaw 就會在背景持續執行：
openclaw onboard --install-daemon執行以下四個指令來確認一切正常：
# 檢查版本openclaw --version
# 執行診斷openclaw doctor
# 開啟控制面板openclaw dashboard
# 確認 Daemon 狀態openclaw onboard --install-daemon「openclaw is not recognized」
Section titled “「openclaw is not recognized」”這代表 npm 的全域 bin 資料夾不在你的 PATH 環境變數中。
解決方法：
- 執行
npm config get prefix找出路徑。 - 將該路徑加上
\bin(通常是%AppData%\npm) 新增到你的 PATH。 - 重新開啟 PowerShell。
「spawn git ENOENT」錯誤
Section titled “「spawn git ENOENT」錯誤”使用源碼安裝時需要 Git for Windows。
解決方法：
- 從 git-scm.com/download/win 下載。
- 使用預設設定安裝。
- 重新開啟 PowerShell 並重試。
Node.js 版本問題
Section titled “Node.js 版本問題”如果你的 Node.js 版本太舊，請更新：
# 使用 wingetwinget install OpenJS.NodeJS.LTS
# 或使用 Chocolateychoco install nodejs-ltsWindows Defender 阻擋安裝
Section titled “Windows Defender 阻擋安裝”請為 OpenClaw 目錄新增排除項：
- 開啟 Windows 安全性 → 病毒與威脅防護。
- 點擊「管理設定」。
- 找到「排除項目」→ 新增排除資料夾：
%AppData%\npm\node_modules\openclaw。
如果你還是搞不定，我們的 AI Setup Assistant 已經讀過所有文件，可以即時幫你解決具體的 Windows 報錯。
PowerShell vs WSL2：該選哪一個？
Section titled “PowerShell vs WSL2：該選哪一個？”| 比較項目 | PowerShell | WSL2 |
|---|---|---|
| 設定時間 | 2 分鐘 | 10 分鐘 |
| 穩定性 | 普通 | 極佳 |
| Shell 工具 | 有限 | 完整 Linux |
| 更新方式 | 簡單 | 簡單 |
| 適用對象 | 快速測試 | 進階使用者 |
我的建議是：先從 PowerShell 開始。如果你遇到問題或想要更強大的控制權，再切換到 WSL2。
- 一般安裝指南 → — 跨平台通用說明
- 串接 Telegram → — 從手機遠端控制
- Docker 部署 → — 使用容器化環境
- 使用本地 AI → — 實現零 API 成本
OpenClaw Expert
還是卡住了？
如果這篇文件沒有解決你的情境，直接問 OpenClaw Expert，拿到可執行步驟。