Windows 用戶第一次安裝 OpenClaw 就上手！WSL2 懶人包

不用雙系統、不用虛擬機，一個指令讓你的 Windows 瞬間變成 AI 開發利器

前言：為什麼要裝 WSL2？

WSL2（Windows Subsystem for Linux 2）是 Windows 內建的 Linux 環境，速度快、占用資源少，而且跟 Windows 本來的東西完全不相沖。簡單來說：

• ✅ 不需要雙系統開機
• ✅ 不需要 VMware / VirtualBox
• ✅ 效能接近原生 Linux
• ✅ OpenClaw 就是為 Linux 環境設計的

所以啦，想在 Windows 上好好用 OpenClaw，WSL2 是標配，不是選配 😎

Step 1｜啟用 WSL2，安裝 Ubuntu

這是最關鍵的一步，但意外地超級簡單。

在終端機裡輸入這行指令，然後按 Enter：

wsl --install

接下來就是等著。WSL2 會自動幫你：

• 啟用相關的 Windows 功能
• 下載 WSL2 核心更新
• 安裝 Ubuntu（最新 LTS 版本）

Step 2｜設定 Ubuntu 使用者帳號密碼

第一次啟動 Ubuntu，系統會要求你建立一個使用者帳號和密碼：

Enter new UNIX username:（輸入你的使用者名稱）
Enter new password:（輸入密碼，畫面不會顯示，放心輸入）
Confirm password:（再輸入一次密碼確認）

Step 3｜設定 systemd（讓系統更穩定）

Ubuntu 24.04 雖然預設有 systemd，但 WSL2 環境有時候需要手動開啟。我們來設定一下：

sudo nano /etc/wsl.conf

進到編輯器之後，輸入以下內容：

[boot]
systemd=true

編輯完成後，按 Ctrl + X → 按 Y → 按 Enter 儲存離開。

Step 4｜安裝 Node.js（v24.x LTS）

OpenClaw 是用 Node.js 跑的，所以必須先裝好。我們用 NodeSource 提供的官方來源，安裝目前最推薦的 v24.x LTS 版本。

先新增 Node.js 來源：

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo bash -

來源設定好之後，安裝 Node.js：

sudo apt-get install -y nodejs

等個一兩分鐘，安裝完成之後確認一下版本：

node --version

如果看到 v24.14.1（或類似的 24.x 版本），代表安裝成功！🎉

Step 5｜安裝 OpenClaw

Node.js 準備好了，現在輪到主角登場。用一行指令把 OpenClaw 裝起來：

curl -fsSL https://openclaw.ai/install.sh | bash

跑完之後，終端機可能會請你設定一下路徑（PATH）。

設定 PATH（讓系統找得到 OpenClaw）

先把路徑寫進設定檔，這樣每次開 Ubuntu 不用重新設定：

export PATH="/home/你的使用者名稱/.npm-global/bin:$PATH"

把「你的使用者名稱」置換成你在 Step 2 設定的名字喔！

Step 6｜執行設定精靈（onboard）

萬事俱備，開工！啟動 OpenClaw 的設定精靈：

openclaw onboard --install-daemon

執行之後，你的終端機會跑出一個很帥的 ASCII 龍蝦 logo，然後是一連串的問題，一個一個回答就好。以下是各個步驟的詳細說明：

① 安全警告

第一個跳出來的是安全警告，說明 OpenClaw 的安全邊界。

◆ I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
│ ○ Yes / ● No

→ 選擇「Yes」繼續。

② 選擇設定模式

◆ Setup mode
│ ● QuickStart (Configure details later via openclaw configure.)
│ ○ Manual

→ 選擇「QuickStart」，用預設配置快速啟動。

③ 選擇 AI 模型

◆ Model/auth provider
│ ○ Anthropic
│ ○ BytePlus
│ ○ DeepSeek
│ ○ Google
│ ● MiniMax (M2.7 (recommended))  ← 移動鍵選這個
│ ○ Mistral AI
│ ○ Moonshot AI
│ ○ OpenAI
...

→ 移動鍵移到「MiniMax (M2.7)」，按空白鍵或 Enter 選它。

④ 選擇 API 區域

◆ MiniMax auth method
│ ○ MiniMax API key (CN)
│ ● MiniMax API key (Global) ← 這個，國際板
│ ○ MiniMax OAuth (CN)
│ ○ MiniMax OAuth (Global)

→ 選擇「MiniMax API key (Global)」。

⑤ 填入 API Key

Enter MiniMax API key (sk-api- or sk-cp-)
https://platform.minimax.io/user-center/basic-information/interface-key
│ _

終端機會顯示提示網址，並等待你輸入。

→ 先去這個網址申請 API Key，複製回來貼上。

格式長這樣：sk-api-xxxxxxxxxxxxxxxx

⑥ 選擇模型版本

◆ Default model
│ ● Keep current (minimax/MiniMax-M2.7) ← 一般用途選這個
│ ○ Enter model manually
│ ○ minimax/MiniMax-M2.7-highspeed ← 有高速配額的選這個

→ 直接 Enter 確認 M2.7。

⑦ 選擇聊天頻道

Select channel (QuickStart)
│ ● Telegram (Bot API) (recommended)
│ ○ WhatsApp (QR link)
│ ○ Discord (Bot API)
│ ○ Skip for now

→ 想先跳過就選「Skip for now」。

⑧ 選擇搜尋引擎

◆ Search provider
│ ○ Brave Search
│ ● DuckDuckGo Search (experimental) ← 免費、不用 API Key
│ ○ Skip for now

→ 選 DuckDuckGo 或 Skip。

⑨ 安裝 Skills

◆ Configure skills now? (recommended)
│ ● Yes / ○ No

→ 選「Yes」繼續。

 Install missing skill dependencies
 │ ◻ Skip for now
 │ ◻ 🔐 1password
 │ ◻ 📰 blogwatcher
 │ ◻ 🧩 clawhub ← 建議一定要選這個
 │ ◻ 📧 himalaya
 │ ◻ 🐙 github
 │ ...

→ 移動到底下，用空白鍵勾選「clawhub」，其餘全部 Skip。

⑩ 選擇 Node 版本管理工具

◆ Preferred node manager for skill installs
│ ● npm
│ ○ pnpm
│ ○ bun

→ 選「npm」。

⑪ 設定額外 API Key

◇ Set GOOGLE_PLACES_API_KEY for goplaces? → No
◇ Set NOTION_API_KEY for notion? → No
◇ Set OPENAI_API_KEY for openai-whisper-api? → No
◇ Set ELEVENLABS_API_KEY for sag? → No

→ 全部選「No」跳過。

⑫ 設定 Hooks（自動化腳本）

◆ Enable hooks?
│ ◻ Skip for now
│ ◻ 🚀 boot-md
│ ◻ 📎 bootstrap-extra-files
│ ◻ 📝 command-logger
│ ◻ 💾 session-memory

→ 建議全部勾選。

⑬ 完成！

看到這些輸出代表設定完成：

Config written: ~/.openclaw/openclaw.json
Systemd lingering enabled.
Gateway service installed.
Agents: main (default)
Heartbeat interval: 30m (main)

⑭ 開啟控制台

◆ How do you want to hatch your bot?
│ ● Open the Web UI
│ ○ Hatch in TUI
│ ○ Do this later

→ 選「Open the Web UI」。

系統會回覆一個連結：

Dashboard ready
http://127.0.0.1:18789/#token=你的Token

把那個完整網址（包含 #token=xxx）複製，貼進瀏覽器。

看到控制台介面出現，就代表一切完成了！🎉

Step 7｜從 Windows 瀏覽器存取 Web UI

預設情況下，OpenClaw 的 Web UI 是綁定在 Linux 內部的 localhost。如果你想從 Windows 的瀏覽器存取，需要建立 SSH tunnel。

在Windows 端（新開一個 PowerShell 或 CMD 視窗）執行：

ssh -L 18789:localhost:18789 你的使用者名稱@localhost -p 22

輸入 Ubuntu 的密碼之後，SSH tunnel 就建立完成了。這時候打開 Windows 的瀏覽器，輸入：

http://localhost:18789

就能看到 OpenClaw 的 Web UI 啦！

常見問題

Q1：輸入 node --version 沒反應怎麼辦？

可能是 PATH 沒有設定好。重新執行：
export PATH="/home/你的使用者名稱/.npm-global/bin:$PATH"
然後確認路徑是否出現在 echo $PATH 裡面。

Q2：安裝 OpenClaw 時顯示找不到指令？

確認 Node.js 安裝成功了：node --version 和 npm --version 都要有輸出。如果都正常，重新執行安裝指令。

Q3：WSL2 安裝失敗怎麼處理？

先確認 Windows 版本：winver。WSL2 需要 Windows 10 2004 以上，或 Windows 11。如果版本太舊，先更新 Windows。

Q4：SSH tunnel 連不上？

檢查兩件事：① WSL2 裡的 SSH 服務是否啟動（sudo service ssh status）；② Windows 端的 SSH 用戶端是否已啟用（可在 Windows 功能裡開啟「OpenSSH 用戶端」）。

結語

從零到跑起來就是這 14 個步驟，沒有那麼難對吧？WSL2 讓 Windows 用戶不需要放棄熟悉的環境，就能無痛使用 Linux 生態系的工具。OpenClaw 安裝好之後，你的電腦就等於多了一個 24 小時全年無休假勤的 AI 助理。

有問題歡迎留言，我們都會看 😊