教學 Windows WSL2 OpenClaw

在 Windows 上打造專屬 AI 助理：OpenClaw + WSL2 完整安裝指南

👤

David

2026年4月7日

為什麼 Windows 使用者需要這份指南？

雖然 OpenClaw 的設計理念是跨平台的，但對於 Windows 使用者來說，要在原生環境下處理 Node.js 與 Linux 風格的權限管理（尤其是全域套件的路徑問題）時常會遇到阻礙。

為了確保系統的穩定性與安全性，我們強烈建議使用 WSL2 (Windows Subsystem for Linux) 來執行 OpenClaw。這不僅能讓你擁有完整的 Linux 開發體驗，還能完美解決常見的權限衝突（Permission Denied）問題。

這份指南將帶領你從零開始，在 Windows 上一步步建立起屬於你的 OpenClaw AI 助理。

前置準備（Windows 層面，需重開機）

Step 0：建立新使用者

開啟「設定」→「帳戶」→「其他使用者」，新增 test1 帳號，後續步驟在此帳號下執行。

Windows 鍵 → 設定（齒輪）→ 帳戶 → 其他使用者 → 將其他人新增到此電腦
→ 點「我沒有此人的登入資訊」→「新增沒有 Microsoft 帳戶的使用者」
使用者名稱：test1　密碼：輸入 4 字元以上　安全性問題：依序填寫三題

確認：Win + L 切換至 test1 帳號，確認可正常登入。

⚠️ 建立完成後，至「控制中心」→「快速使用者切換」確認帳號出現。

Step 1：安裝 WSL2

以「系統管理員」開啟 PowerShell，執行：

wsl --install

安裝 WSL2 + Ubuntu，安裝完畢需重新開機。重開機後，Ubuntu 會繼續初始化，要求設定 Linux 使用者名稱與密碼。完成後終端機顯示 username@hostname:~$ 即代表進入 WSL 環境。

# 版本驗證
cat /etc/os-release | grep NAME
# 應顯示 Ubuntu

⚠️ 後續所有步驟都在 WSL Ubuntu 終端機中執行，不是 Windows 的命令提示字元。

在 WSL Ubuntu 中安裝

Step 2：安裝 Ollama

curl -fsSL https://ollama.com/install.sh | sh

安裝完成後 Ollama 服務會在背景自動啟動。

# 版本驗證
ollama --version
# 應顯示 ollama version 0.x.x

# 登入 Ollama 帳號（需先在 ollama.com 免費註冊）
ollama signin

⚠️ 登入後瀏覽器顯示「Device Connected Successfully」即代表成功。

Step 3：安裝 Node.js 22

# 加入 Node.js 22 官方套件來源
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# 安裝 Node.js 22 LTS 版本
sudo apt-get install -y nodejs

# 版本驗證
node --version
# 應顯示 v22.x.x

⚠️ 若 apt-get 出現錯誤，先執行 sudo apt-get update 再重試。

Step 4：設定 npm 安全路徑（WSL 必做）

WSL 掛載的 Windows 路徑（/mnt/c/）預設 777 權限，OpenClaw 基於安全考量會封鎖來自該路徑的 plugin，必須把 npm 全域套件改安裝到 Linux 原生路徑。

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

確認安裝路徑：

which openclaw
# 正確路徑應顯示 /home/你的名字/.npm-global/bin/openclaw
# 若顯示 /mnt/c/... 代表設定未生效，請重新執行上方步驟

⚠️ 此步驟是 WSL 特有，Mac 不需要。路徑確認正確才能繼續。

Step 5：安裝 OpenClaw

npm install -g openclaw

啟動互動式設定精靈：

ollama launch openclaw

設定精靈選項：

Select models → 選 minimax-m2.7:cloud，按 Enter
I understand the risks. Continue? → Yes
出現 OpenClaw gateway is running in the background. 代表成功

⚠️ which openclaw 應顯示 /home/.../.npm-global/bin/openclaw。若顯示 /mnt/c/... 請回到 Step 4。

Step 6：設定 Telegram 連線

openclaw configure --section channels

依序選擇：

Where will the Gateway run? → Local (this machine)
Select a channel → Telegram (Bot API)
Enter Telegram bot token → 輸入 BotFather 給的 Token
Configure DM access policies now? → No

完成後將 Telegram 加入 plugins 白名單：

openclaw config set plugins.allow '["openclaw-web-search", "telegram"]'

Step 7：修正 Gateway 路徑（WSL 特有）

初始設定後，systemd service 可能仍指向 /mnt/c/... 舊路徑，需手動修正：

# 確認 ExecStart 的路徑
cat ~/.config/systemd/user/openclaw-gateway.service
# 若看到 ExecStart=/usr/bin/node /mnt/c/Users/... 需修正

sed -i 's|/mnt/c/.*/openclaw/dist/index.js|/home/$USER/.npm-global/lib/node_modules/openclaw/dist/index.js|g' \
  ~/.config/systemd/user/openclaw-gateway.service

systemctl --user daemon-reload && openclaw gateway start

確認正常：

openclaw gateway status
# RPC probe: ok  ← 代表 Gateway 正常運作

⚠️ 若 openclaw gateway status 已顯示 RPC probe: ok，則跳過此步驟。

Step 8：Telegram 配對

開啟你的 Telegram Bot，傳送 /start，Bot 會回傳配對碼，複製並執行：

openclaw pairing approve telegram <配對碼>
# 例：openclaw pairing approve telegram EMFC74MW

配對成功後在 Telegram 傳訊息測試，Bot 應正常回應。

Step 9：設定 cron 排程（美股晨報範例）

在 WSL Ubuntu 終端機執行（將 <你的ChatID> 換成實際數字）：

openclaw cron add \
  --name "美股晨報" \
  --cron "0 7 * * 1-6" \
  --tz "Asia/Taipei" \
  --session isolated \
  --message "請執行以下任務：
1. 使用 fetch 工具抓取 https://www.slickcharts.com/magnificent7 的頁面內容
2. 使用 web search 搜尋「VIX index close today」
3. 根據以上數據，用以下格式產出繁體中文美股晨報：
📊 美股晨報 YYYY/MM/DD
【大盤概覽】S&P 500/道瓊/Nasdaq 各附價格與漲跌幅，一句話描述今日盤勢走向與主因。
【七雄快照】NVDA/AAPL/MSFT/AMZN/GOOGL/META/TSLA 各附價格與漲跌幅
⭐ 最強：XXX  💀 最弱：XXX
【VIX 恐慌指標】VIX：XX.XX（較前日↑/↓），白話解讀一句
（低於15偏樂觀 / 15-25正常 / 超過25警戒 / 破30極度恐慌）
【總結判斷】用一兩句話綜合研判今日市場氣圍與明日值得關注的事件。
注意：漲用🟢跌用🔴，所有數據必須來自實際抓取，不可憑記憶編造，
繁體中文，20行以內，fetch 失敗改用 web search 搜尋各標的收盤價" \
  --channel telegram \
  --to <你的ChatID> \
  --announce

⚠️ --to 不可省略，否則任務會反覆失敗。Chat ID 可透過 @userinfobot 取得。

執行後記下回傳的 id（UUID 格式），立刻測試：

openclaw cron run <id>
# 等待 2-3 分鐘，查看 Telegram 是否收到晨報

Step 10：設定快捷指令

# 將 <job-id> 換成 Step 9 取得的 UUID
echo 'alias morning="openclaw cron run <job-id>"' >> ~/.bashrc
source ~/.bashrc

之後只需輸入 morning 即可立刻觸發晨報：

morning
# {"ok": true, "enqueued": true, "runId": "manual:..."}

Step 11：設定開機自動啟動

每次 Windows 重開機，WSL 會重新初始化，Ollama 需重新啟動。將啟動指令加入 .bashrc：

echo 'pgrep ollama > /dev/null || ollama serve > /dev/null 2>&1 &' >> ~/.bashrc

確認已加入：

tail -1 ~/.bashrc
# pgrep ollama > /dev/null || ollama serve > /dev/null 2>&1 &

確認 Gateway 正常：

openclaw gateway status
# RPC probe: ok  ← Gateway 已透過 systemd 自動啟動

⚠️ 每次重開機後只需開啟 WSL 終端機，Ollama 就會自動啟動。Gateway 透過 systemd 自動處理。

結語

恭喜你！現在你的 Windows 電腦已經變身成一個強大的 AI 基地。透過 WSL2 與 OpenClaw 的結合，你不僅能擁有自動化的美股晨報，還能隨時開發更多客製化的 AI Agent。

如果你在安裝過程中遇到任何問題，歡迎在下方留言或加入我們的社群討論！