想在 Windows 上穩定執行 OpenClaw，最推薦的方式是 **WSL 2 + Ubuntu**。
本篇會一步一步帶你完成：
– 啟用 WSL 2
– 安裝 Ubuntu
– 安裝 Node.js（LTS）
– 安裝 OpenClaw
– 啟動 Gateway
– 常見錯誤排除
—
## 1) 系統需求
– Windows 10 2004 以上（建議 Windows 11）
– 具備系統管理員權限
– 可連網
先用 **PowerShell（系統管理員）**檢查 WSL 狀態。
“`powershell
wsl –status
“`
—
## 2) 啟用與安裝 WSL 2
在 **PowerShell（系統管理員）**執行：
“`powershell
wsl –install
“`
安裝完成後若系統要求重開機，請先重開。
重開後設定預設 WSL 版本為 2：
“`powershell
wsl –set-default-version 2
“`
查看發行版與版本：
“`powershell
wsl -l -v
“`
如果還沒有 Ubuntu，安裝它：
“`powershell
wsl –install -d Ubuntu
“`
—
## 3) 進入 Ubuntu 後先更新套件
以下指令請在 **Ubuntu（WSL）終端機**執行：
“`bash
sudo apt update && sudo apt upgrade -y
“`
安裝常用工具：
“`bash
sudo apt install -y curl git build-essential
“`
—
## 4) 安裝 Node.js（建議 LTS）
使用 NodeSource 安裝 LTS（範例：22.x）：
“`bash
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash –
sudo apt install -y nodejs
“`
確認版本：
“`bash
node -v
npm -v
“`
—
## 5) 安裝 OpenClaw
全域安裝：
“`bash
sudo npm install -g openclaw
“`
驗證：
“`bash
openclaw –version
“`
首次設定精靈：
“`bash
openclaw configure
“`
—
## 6) 啟動與檢查 Gateway
啟動 Gateway：
“`bash
openclaw gateway start
“`
查看狀態：
“`bash
openclaw gateway status
“`
需要重啟時：
“`bash
openclaw gateway restart
“`
—
## 7) 建議使用方式（Windows + WSL）
– OpenClaw 主程式在 WSL 內執行（穩定）
– Chrome 可在 Windows 端搭配 Browser Relay 使用
– 專案建議放在 WSL 檔案系統（例如 `~/workspace`），效能通常比掛載 C 槽更好
—
## 8) 常見錯誤排除
### 問題 A：`wsl –install` 無法執行
**可能原因**
– 沒有用系統管理員開 PowerShell
– Windows 版本太舊
**處理方式**
– 用系統管理員重新開 PowerShell
– 更新 Windows 後再試
### 問題 B：Node 版本太舊導致安裝失敗
**處理方式**
– 重新執行 NodeSource 的 LTS 安裝步驟
### 問題 C：`openclaw: command not found`
**處理方式**
– 關閉終端機重開
– 檢查 npm 全域路徑是否在 PATH
### 問題 D：Browser Relay 連線不到
**處理方式**
“`bash
openclaw gateway status
openclaw gateway restart
“`
並確認：
– Chrome 擴充功能已啟用
– Site access = On all sites
– 目標分頁 Relay 顯示 ON / Attached
—
## 9) 完成驗收清單
請確認以下 5 項都成立：
1. `wsl -l -v` 顯示 Ubuntu 且版本為 2
2. `node -v` 與 `npm -v` 正常
3. `openclaw –version` 正常
4. `openclaw gateway status` 顯示 running
5. Browser Relay 能附著到目標網頁