Windows 安裝 OpenClaw：從零開始的完整教學

開始之前

這篇藍鴨教學會帶你在 Windows 上透過 WSL 安裝 OpenClaw，每一步都有截圖。

這篇教學適合在 Windows 10（版本 2004+）或 Windows 11 上安裝 OpenClaw。

💡 先讀這篇：為什麼不建議在 Windows 原生環境安裝 OpenClaw？——了解為什麼 WSL 是 Windows 用戶的最佳選擇。

如果你用的是 Mac，請看 macOS 安裝指南。 如果你不想在本地安裝，可以考慮 雲端部署方案。

你需要準備

• Windows 10 (版本 2004 以上) 或 Windows 11
• 至少 8GB RAM（建議 16GB）
• 至少 5GB 可用磁碟空間
• 穩定的網路連線
• 一個 API Key（至少一個）：OpenAI / Google / Anthropic，或免費的 Ollama Cloud

確認 Windows 版本：按 Win + R，輸入 winver，按 Enter。沒有 API Key？沒關係，後面有 Ollama Cloud 免費方案。

---

選擇安裝方式

Windows 上有兩種安裝方式：

方式	難度	適合	優點
方式 A：WSL 2（建議）	⭐⭐ 中等	所有人	Linux 環境，更穩定，OpenClaw 官方建議
方式 B：原生 Windows	⭐ 簡單	僅限快速體驗	不需前置設定，但陷阱多

鴨編建議：直接用方式 A（WSL）。OpenClaw 大量 CLI 工具在 Linux 環境更穩定，用原生 Windows 安裝經常運行一段時間就出啊。多花一點時間，一開始就走正確路。

---

方式 A：WSL 2 安裝（建議）

WSL（Windows Subsystem for Linux）讓你在 Windows 裡跑 Linux。OpenClaw 的 CLI 工具和相依套件在 Linux 環境更穩定，強烈建議用這種方式。

📘 完整版教學：如果想深入了解 WSL 的原理和使用技巧，請看 WSL 完整教學。

Step 1：確認 BIOS 虛擬化已開啟

WSL 2 需要硬體虛擬化支援。先確認你的電腦有沒有開：

以系統管理員身份開啟命令提示字元（Win + R → 輸入 cmd → Ctrl + Shift + Enter）：

systeminfo

找到最後幾行，確認「Hyper-V 需求」區塊：

Hyper-V 需求:    已偵測到 Hypervisor。將不會顯示 Hyper-V 所需功能。

如果顯示「韌體中已啟用虛擬化：否」，你需要到 BIOS 開啟：

1. 重新開機，按 DEL 或 F2 進入 BIOS
2. 找到 Intel VT-x（Intel 處理器）或 AMD-V / SVM Mode（AMD 處理器）
3. 設為 Enabled
4. 儲存並重新開機

Step 2：安裝 WSL 2

以系統管理員身份開啟 PowerShell（右鍵 → 以系統管理員身分執行）：

wsl --install

安裝完成後重新啟動電腦。

重啟後會自動開啟 Ubuntu，設定使用者名稱和密碼。

⚠️ 如果 wsl --install 沒反應，回頭確認 Step 1 的 BIOS 虛擬化是否已開啟。

Step 3：安裝 Node.js 24（使用 nvm）

OpenClaw 需要 Node.js 22.16 以上，官方建議安裝 Node 24。開啟 Ubuntu（從開始選單啟動）：

# 確認現有 Node 版本（如果已安裝）
node -v

# 如已安裝舊版，先移除
sudo apt remove nodejs -y
sudo apt autoremove -y
sudo apt update

# 安裝 nvm（Node 版本管理器）
curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

# 重新載入設定（或退出再重新登入）
exit

重新進入 WSL：

wsl -d ubuntu

# 確認 nvm
nvm --version

# 安裝 Node.js 24（官方推薦版本）
nvm install 24
nvm use 24

# 設為預設
nvm alias default 24

# 確認
node -v   # 應顯示 v24.x.x
which node  # 應在 ~/.nvm/versions/node/v24.x.x/bin/node

💡 已有 Node 22.16+？也可以繼續用，但官方建議有機會就升級到 Node 24。

Step 4：安裝與啟動 OpenClaw

# 方式一：npm 全域安裝（推薦，最簡單）
npm install -g openclaw
openclaw --version

# 方式二：傳統 git clone 安裝
sudo apt install python3.11 python3.11-venv python3-pip git -y
mkdir -p ~/Projects && cd ~/Projects
git clone https://github.com/openclaw/openclaw.git
cd openclaw
python3.11 -m venv .venv
source .venv/bin/activate
pip install --upgrade pip
pip install -r requirements.txt

設定 API Key

# npm 安裝方式：直接啟動時設定
openclaw start
# 首次會引導你設定 API Key

# git clone 方式：編輯 .env
cp .env.example .env
nano .env  # 填入 API Key，Ctrl+O 存檔，Ctrl+X 離開
python -m openclaw start

還沒有 API Key？ 有兩個免費選項：

選項 1：Ollama Cloud（建議）——先到 ollama.com 建立帳號，再在 WSL 中執行：

ollama signin
ollama launch openclaw
# 選雲端模型（如 qwen3-coder:480b-cloud、deepseek-v3.1:671b-cloud）→ 不需本機 GPU

選項 2：Google AI Studio——到 aistudio.google.com 申請免費 API Key。

WSL 裡的 localhost:3000 在 Windows 瀏覽器可以直接存取。

🛠️ 小工具：OpenAI Codex CLI（幫你修復錯誤）

如果在 WSL 裡安裝 OpenClaw 時遇到錯誤，可以安裝 OpenAI Codex CLI——一個在終端機裡跑的 AI coding agent，能幫你分析錯誤訊息並提出修復方案：

# 安裝 Codex CLI（需要 Node 22.16+，已安裝的話直接用）
npm install -g @openai/codex

# 在 OpenClaw 目錄中模擬讀獲錯誤
cd ~/Projects/openclaw
codex "explain this error and how to fix it: [把錯誤訊息貼在這裡]"

💡 Codex CLI 需要 OpenAI API Key。如果你已經安裝 Ollama，也可以設定它使用本機模型來回答喔。詳見 Codex CLI 文件。

詳細說明見 Ollama + OpenClaw 完整教學。

---

方式 B：原生 Windows 安裝（不建議）

⚠️ 建議使用方式 A（WSL）。原生 Windows 安裝在長期使用中容易遇到路徑啊、C++ 編譯錯誤等啊，維護成本高。以下僅供無法使用 WSL 的情況參考。

Step 1：安裝 Python 3.11+

1. 前往 python.org/downloads
2. 下載最新的 Python 3.11+ 安裝檔
3. 執行安裝程式

⚠️ 重要！安裝時一定要勾選「Add Python to PATH」，這一步很多人忘記！

4. 安裝完成後，開啟 命令提示字元（按 Win + R，輸入 cmd）：

python --version
REM 應該顯示 Python 3.11.x 或更新

pip --version
REM 應該顯示 pip 24.x.x

如果 python 沒反應，試試 python3 或 py。

Step 2：安裝 Git

1. 前往 git-scm.com/download/win
2. 下載並安裝（使用預設設定即可）
3. 確認：

git --version
REM 應該顯示 git version 2.x.x

Step 3：安裝 Node.js 24

1. 前往 nodejs.org
2. 下載 Node.js 24（官方推薦）或最新版 LTS
3. 安裝（使用預設設定）
4. 確認：

node --version
REM 應該 v24.x.x（最低需要 v22.16.0+）

Step 4：下載 OpenClaw

REM 建立專案目錄
mkdir C:\Projects
cd C:\Projects

REM 下載 OpenClaw
git clone https://github.com/openclaw/openclaw.git
cd openclaw

Step 5：建立虛擬環境

REM 建立虛擬環境
python -m venv .venv

REM 啟動虛擬環境
.venv\Scripts\activate

REM 成功後前面會出現 (.venv)
REM (.venv) C:\Projects\openclaw>

Step 6：安裝 OpenClaw

REM 升級 pip
pip install --upgrade pip

REM 安裝相依套件
pip install -r requirements.txt

⚠️ 如果出現 C++ 編譯錯誤，你需要安裝 Visual Studio Build Tools：

1. 前往 visualstudio.microsoft.com/visual-cpp-build-tools/
2. 下載並安裝
3. 選擇「Desktop development with C++」
4. 重新執行 pip install -r requirements.txt

Step 7：設定 API Key 並啟動

REM 複製範本設定
copy .env.example .env

REM 用記事本編輯
notepad .env

在 .env 中填入至少一個 API Key，然後啟動：

python -m openclaw start

如果 Windows Defender 跳出防火牆警告，點「允許存取」即可。

---

常見問題

python 指令找不到

原因：安裝 Python 時沒勾選 Add to PATH

解法：

1. 重新執行 Python 安裝程式
2. 選「Modify」
3. 確認勾選「Add Python to environment variables」

或手動加 PATH：

setx PATH "%PATH%;C:\Users\你的使用者名稱\AppData\Local\Programs\Python\Python311"

pip install 出現 Microsoft Visual C++ 14.0 is required

安裝 Visual Studio Build Tools（Step 6 有說明）。

防火牆擋住 OpenClaw

Windows Defender 可能會跳出警告。點「允許」即可，這只是讓 Python 監聽本地 port。

WSL 裡 localhost 打不開

試試用 WSL 的 IP：

hostname -I
# 用顯示的 IP 取代 localhost

---

下一步

安裝完成！接下來你可以：

• 🧩 學習 Skill：讓 AI 學會可重複的工作流
• 🤖 打造你的第一個 Agent
• 🔑 申請 Google API Key 串接更多服務
• ☁️ 不想管伺服器？改用雲端部署