OpenClaw Windows 11 家用版 WSL2 安裝全攻略：新手 30 分鐘搞定 AI 助理
本文說明：本教學專為 Windows 11 家用版用戶設計（非企業版/Pro版），完整說明如何透過 WSL2（Windows Subsystem for Linux）安裝 OpenClaw AI 助理。即使你從未用過 Linux 指令，按照本文步驟 30 分鐘內即可完成安裝，開始享受 24 小時 AI 助理服務。
Windows 用戶安裝 OpenClaw 的最佳路徑
OpenClaw 雖然支援 Windows 原生安裝（PowerShell 方式），但官方文件明確指出 強烈推薦在 WSL2 環境下運行。這是因為 OpenClaw 的許多底層功能（如 Shell 指令執行、系統整合、Daemon 服務）在 Linux 環境下表現更穩定，許多 Skills 外掛也是專為 Linux/macOS 設計的。
❌ PowerShell 原生安裝的問題
- 部分 Skills 無法在 Windows 原生環境執行
- Shell 指令相容性問題頻發
- Daemon 服務設定較複雜
- 路徑分隔符號問題（反斜線 vs 正斜線）
✅ WSL2 安裝的優勢
- 完整 Linux 環境，100% 相容
- 所有 Skills 正常運行
- Systemd 服務自動管理
- Windows 與 Linux 檔案系統可互通
系統需求確認
Windows 11 家用版安裝 OpenClaw 的需求
硬體需求：
- CPU：支援虛擬化（大多數現代 CPU）
- RAM：8GB 以上（16GB 推薦）
- 磁碟：20GB 以上可用空間
軟體需求：
- Windows 11（版本 21H2 以上）
- BIOS 中啟用虛擬化（Intel VT-x 或 AMD-V）
- 網路連線（安裝期間需下載套件）
# 在 PowerShell（系統管理員）確認 Windows 版本
winver
# 確認虛擬化是否已啟用
systeminfo | findstr /i "hyper-v"
步驟一：啟用 WSL2（一行指令搞定）
Windows 11 的 WSL2 安裝比以往簡單得多，只需一行指令。以系統管理員身分開啟 PowerShell（右鍵開始選單 → Windows 終端機（系統管理員）），輸入：
# 一鍵安裝 WSL2（自動安裝 Ubuntu）
wsl --install
# 安裝完成後重新開機
Restart-Computer
📌 wsl --install 會自動完成以下步驟
- 啟用 Windows 虛擬機器平台功能
- 啟用 Linux 子系統功能
- 下載並安裝最新版 WSL2 核心
- 安裝 Ubuntu 22.04 LTS（預設發行版）
重新開機後，Ubuntu 會自動啟動並要求你設定 Linux 使用者名稱和密碼（與 Windows 帳號無關，可以自由設定）。
常見問題：WSL2 安裝失敗
若提示虛擬化未啟用，需進入 BIOS 開啟：
- Intel 處理器：啟用 Intel VT-x（或 Intel Virtualization Technology）
- AMD 處理器：啟用 AMD-V（或 SVM Mode）
步驟二：進入 Ubuntu 環境並更新套件
重新開機後，打開「開始選單」搜尋「Ubuntu」並啟動。首次進入需要設定用戶名稱和密碼，完成後執行系統更新：
# 更新 Ubuntu 套件列表並升級
sudo apt update && sudo apt upgrade -y
# 安裝常用工具
sudo apt install -y curl wget git build-essential
小技巧：建議安裝 Windows Terminal（Microsoft Store 免費下載），比預設的 Ubuntu 視窗好用很多，支援多分頁和美化主題。
步驟三：在 WSL2 中安裝 Node.js 22
OpenClaw 需要 Node.js v22。在 Ubuntu（WSL2）終端機中執行：
# 方法一：使用 NodeSource 官方倉庫（推薦）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
# 驗證安裝
node --version # 應顯示 v22.x.x
npm --version
# 方法二：使用 nvm（方便切換版本）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
nvm alias default 22
為什麼要用 WSL2 而不是 Windows 原生安裝 Node.js？
在 Windows 原生環境安裝 Node.js 並使用 npm 全域安裝套件時，路徑問題和權限問題非常複雜。WSL2 提供完整的 Linux 環境，npm 全域安裝和環境變數設定都像在真實 Linux 機器上一樣簡單直接，不會遇到 Windows 特有的 EACCES 權限錯誤。
步驟四：安裝 OpenClaw（在 WSL2 中）
在 WSL2 的 Ubuntu 終端機中，執行官方安裝腳本：
# 官方一鍵安裝腳本（在 WSL2 Ubuntu 中執行）
curl -fsSL https://openclaw.ai/install.sh | bash
# 或手動 npm 安裝
npm install -g openclaw@latest
# 啟動 Onboarding 並安裝 Systemd 服務
openclaw onboard --install-daemon
WSL2 中使用 Systemd 的注意事項
Windows 11 的 WSL2 現已原生支援 Systemd（2022年後的版本），但需要確認已啟用：
# 確認 /etc/wsl.conf 中啟用 Systemd
cat /etc/wsl.conf
# 若無此設定，執行：
echo -e "[boot]\nsystemd=true" | sudo tee /etc/wsl.conf
# 重啟 WSL2
wsl --shutdown # 在 PowerShell 執行
# 然後重新打開 Ubuntu
步驟五：Onboarding 引導設定
執行 openclaw onboard --install-daemon 後進入互動式引導，依序完成：
1輸入 AI 模型 API 金鑰
貼上你的 Anthropic Claude API 金鑰（格式：sk-ant-api03-...）或 OpenAI API 金鑰（格式：sk-proj-...）。
2選擇通訊頻道
Windows 用戶最推薦選擇 Telegram 或 WhatsApp。Discord 也是很好的選擇，特別適合已有 Discord 習慣的用戶。（Windows 無法使用 iMessage）
3設定 AI 助理名稱與性格
給你的 AI 助理取一個名字（例如：「Jarvis」、「Alice」），並透過 soul.md 文件設定其個性特質和工作偏好。
4安裝 Daemon 服務
選擇安裝 Systemd 服務，這樣每次 WSL2 啟動時 OpenClaw Gateway 都會自動運行。
步驟六：設定 Windows 開機自動啟動 WSL2
預設情況下，WSL2 需要手動啟動。若想讓 OpenClaw 在 Windows 開機後自動運行，需要設定一個自動啟動腳本：
# 在 PowerShell 中建立啟動腳本
$scriptContent = @"
wsl -d Ubuntu -u root service cron start
wsl -d Ubuntu -- bash -c "openclaw gateway start &"
"@
$scriptPath = "$env:APPDATA\Microsoft\Windows\Start Menu\Programs\Startup\start-openclaw.ps1"
$scriptContent | Out-File -FilePath $scriptPath -Encoding UTF8
# 或使用工作排程器（推薦）
# 開啟「工作排程器」→ 建立基本工作
# 觸發條件：使用者登入時
# 動作：啟動程式：wsl.exe
# 引數：-d Ubuntu -- bash -c "openclaw gateway start"
更簡單的方法：使用 NSSM 把 WSL2 設為 Windows 服務
NSSM（Non-Sucking Service Manager）可以將任何程式設為 Windows 服務，包括 WSL2 中的 OpenClaw，確保完全的開機自動啟動。
步驟七：驗證安裝與測試連線
# 在 WSL2 Ubuntu 中執行
openclaw doctor
openclaw gateway status
openclaw dashboard # 在 Windows 瀏覽器中打開控制面板
# 發送測試訊息
openclaw message send --target "你的電話號碼" --message "Hello from Windows 11 WSL2!"
成功後，你的 Telegram/WhatsApp 應該會收到來自 OpenClaw 的回覆。打開瀏覽器前往 http://127.0.0.1:18789/ 可以看到 OpenClaw 的 Web 控制面板。
Windows 11 + WSL2 效能優化技巧
💾 限制 WSL2 記憶體使用
WSL2 預設會使用大量系統 RAM，影響 Windows 遊戲或其他應用程式。建議在 %UserProfile%\.wslconfig 中設定：
[wsl2]
memory=4GB # 限制 WSL2 最多使用 4GB RAM
processors=4 # 限制使用 4 個 CPU 核心
swap=2GB # 設定交換空間
🌐 網路加速（台灣用戶必讀）
OpenClaw 在 Windows 11 WSL2 環境中呼叫 Claude/OpenAI API 時，需要穿越台灣到美國的跨太平洋網路，延遲可能高達 200-300ms。建議搭配 VPN07，選擇日本或美國節點，可將 API 呼叫延遲降低至 50-80ms，大幅提升 OpenClaw 的響應速度。VPN07 支援 1000Mbps 千兆頻寬，在 WSL2 中配置也非常簡單。
📁 存取 Windows 檔案
WSL2 可以直接存取 Windows 檔案系統，讓 OpenClaw 能夠讀寫你的 Windows 文件：
# Windows C 槽在 WSL2 中的路徑
ls /mnt/c/Users/你的用戶名/Documents
# 讓 OpenClaw 存取 Windows 桌面文件
ln -s /mnt/c/Users/你的用戶名/Desktop ~/desktop
常見問題與排解方法
❌ WSL2 中 openclaw 指令找不到
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
# 或設定 npm 全域目錄
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
❌ WSL2 無法連接網路（DNS 解析失敗）
# 修復 WSL2 DNS 問題
echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf
# 防止被覆蓋
sudo chattr +i /etc/resolv.conf
❌ API 連線超時（台灣用戶常見）
從台灣連接 Anthropic/OpenAI API 可能遇到不穩定問題。啟用 VPN07 並在 WSL2 中配置代理即可解決。VPN07 提供 1000Mbps 千兆頻寬，十年穩定運營，是台灣 OpenClaw 用戶的首選加速工具。
進階備用：PowerShell 原生安裝方案
若你的電腦無法啟用 WSL2（如虛擬機環境），OpenClaw 也提供 Windows 原生安裝方案：
# 在 PowerShell（系統管理員）中執行
iwr -useb https://openclaw.ai/install.ps1 | iex
# 或手動安裝（需先安裝 Node.js 22 Windows 版）
npm install -g openclaw@latest
openclaw onboard --install-daemon
PowerShell 安裝模式下，部分需要 Linux Shell 的 Skills 可能無法正常運行，建議優先使用 WSL2 方案。
Windows 11 上 OpenClaw 的實際應用場景
安裝完成後，你的 Windows 11 電腦就成為了一台 24 小時待命的 AI 助理主機。以下是最適合 Windows 用戶的應用場景：
程式開發輔助
透過 Telegram 傳訊控制 Windows PC 上的 Visual Studio Code，讓 OpenClaw 在背景執行測試、修復 Bug，並自動提交 GitHub PR。
遊戲主機多工利用
如果你的 Windows 11 主機主要用於遊戲，OpenClaw 可在閒置時段（深夜、上班時）自動執行任務，充分利用電腦資源。
商業分析自動化
結合 Excel 和 Python，OpenClaw 可自動抓取市場數據、生成分析報告，並透過 WhatsApp 傳送至你的手機。
影片創作工作流
Windows 上有 DaVinci Resolve、Adobe Premiere 等強大影片剪輯工具，OpenClaw 可自動化前置作業，如素材整理、轉檔、字幕生成。
資料庫備份監控
設定 OpenClaw 定時監控本地資料庫的備份狀態，異常時主動透過 Telegram 發出警報通知。
多語言內容創作
讓 OpenClaw 幫你批量翻譯文件、生成多語言版本的部落格文章或產品說明，節省大量人工翻譯時間。
WSL2 中 OpenClaw 的進階設定技巧
設定 OpenClaw 使用代理（VPN07 配置）
在 WSL2 中讓 OpenClaw 透過 VPN07 加速，只需設定環境變數：
# 在 ~/.bashrc 中加入（以本機代理端口為例）
export HTTP_PROXY="http://127.0.0.1:7890"
export HTTPS_PROXY="http://127.0.0.1:7890"
source ~/.bashrc
OpenClaw Session 記憶與跨裝置同步
OpenClaw 的記憶系統儲存在本機，但你可以透過設定讓它在 Windows 和 Android/iPhone 之間同步記憶：
# 查看 OpenClaw 記憶存儲位置
openclaw status --show-paths
# 使用 Syncthing 或 OneDrive 同步 memory 資料夾
🔄 更新 OpenClaw 至最新版
OpenClaw 版本更新非常頻繁，建議每週更新一次以獲得最新功能：
npm update -g openclaw
openclaw --version
# 重啟 Gateway 套用新版本
openclaw gateway restart
為什麼 VPN07 是 Windows 11 + OpenClaw 用戶的最佳選擇
在 Windows 11 WSL2 環境中，OpenClaw 需要穩定且快速的網路連線才能流暢運行。VPN07 相比其他 VPN 服務具有以下優勢：
VPN07 加速 OpenClaw API 連線
台灣用戶首選，解決 Claude/GPT API 連線延遲
Windows 11 WSL2 環境下，OpenClaw 呼叫 Claude API 的延遲取決於國際網路品質。VPN07 提供 1000Mbps 千兆頻寬、70+ 國家伺服器、穩定運營超過十年，能將 API 回應速度提升 60-80%，讓 OpenClaw 更快更流暢。