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

開始之前

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

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

你需要準備

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

💡 確認 Windows 版本：按 Win + R，輸入 winver，按 Enter。

---

選擇安裝方式

Windows 上有兩種安裝方式：

方式	難度	適合	優點
方式 A：原生 Windows	⭐ 簡單	新手	不需要額外工具
方式 B：WSL 2	⭐⭐ 中等	開發者	Linux 環境，更穩定

推薦新手用方式 A，有開發經驗的可以選方式 B。

---

方式 A：原生 Windows 安裝

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

1. 前往 nodejs.org
2. 下載 LTS 版本
3. 安裝（使用預設設定）
4. 確認：

node --version
REM 應該 v18 以上

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>

⚠️ 每次開新的命令提示字元都需要重新啟動：

cd C:\Projects\openclaw
.venv\Scripts\activate

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：

OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx
GOOGLE_API_KEY=your-google-api-key
ANTHROPIC_API_KEY=sk-ant-xxxxxxxx

💡 不知道怎麼申請 Google API Key？ 看 Google API Key 申請指南。

Step 8：啟動 OpenClaw

python -m openclaw start

看到以下訊息就成功了：

🐾 OpenClaw is starting...
✅ Server running at http://localhost:3000

打開瀏覽器前往 http://localhost:3000。

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

---

方式 B：WSL 2 安裝（進階）

WSL（Windows Subsystem for Linux）讓你在 Windows 裡跑 Linux。好處是很多 Python 套件在 Linux 上更穩定。

Step 1：安裝 WSL 2

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

wsl --install

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

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

⚠️ 如果 wsl --install 沒反應，可能需要先在 BIOS 中啟用虛擬化（Intel VT-x 或 AMD-V）。

Step 2：在 WSL 中安裝

開啟 Ubuntu（從開始選單啟動），接下來的步驟跟 Linux/macOS 一樣：

# 更新系統
sudo apt update && sudo apt upgrade -y

# 安裝 Python 和工具
sudo apt install python3.11 python3.11-venv python3-pip git nodejs npm -y

# 下載 OpenClaw
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

# 設定
cp .env.example .env
nano .env  # 填入 API Key，Ctrl+O 存檔，Ctrl+X 離開

# 啟動
python -m openclaw start

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

---

常見問題

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 串接更多服務
• ☁️ 不想管伺服器？改用雲端部署