MapleCheng

在浩瀚的網路世界中無限潛水欸少年郎！

0%

在 Windows 上安裝 OpenClaw：從零開始到 PM2 背景運行完整教學

發表於 分類於
寫給完全沒經驗的人看的 OpenClaw Windows 安裝教學。從開啟 PowerShell、安裝 Node.js、跑 Wizard 設定，到用 PM2 讓 AI 助手在背景 24 小時運行，一條龍照著做就好。

這篇寫給「什麼是終端機？」等級的讀者。不會有「方法 A 還是方法 B 自己選」這種東西，就是一條路，從頭到尾照著貼指令就好。

目標：在 Windows 上把 OpenClaw 裝好、設定完、用 PM2 讓它在背景 24 小時跑，關掉視窗也不會斷。

OpenClaw 是什麼？

OpenClaw 是一個跑在你自己電腦上的 AI 助手。你可以把它接上 Discord、Telegram、WhatsApp 這些聊天軟體，然後直接用傳訊息的方式跟 AI 對話。

跟 ChatGPT 網頁版不同的是：資料在你自己的電腦上、模型自己選、它還能幫你讀檔案、跑腳本、瀏覽網頁。設定好之後，用手機傳訊息就能叫它做事。

你需要準備什麼

  • 一台 Windows 10 或 11 的電腦
  • 網路連線
  • AI 模型的使用權（API Key 或 Claude 訂閱都行，等一下會教）

Step 1：打開 Windows Terminal

按鍵盤上的 Win 鍵，打字輸入 terminal，點「以系統管理員身分執行」。

跳出來問你「是否允許此應用程式變更您的裝置」→ 點是。

你會看到一個深色背景的視窗，上面寫著 PS C:\Users\你的名字>。這就是 PowerShell。接下來所有指令都在這裡打——複製、貼上、按 Enter。

第一件事，允許執行腳本：

1
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force

Step 2：安裝 Node.js

OpenClaw 需要 Node.js 這個東西才能跑。貼上這行：

1
winget install OpenJS.NodeJS.LTS --accept-source-agreements --accept-package-agreements

等它跑完。

⚠️ 裝完之後，關掉 Windows Terminal，重新打開一個新的。 這次不用系統管理員了，直接打開就好。

舊的視窗不會知道你裝了新東西。很多人卡在這一步——裝了 Node 但打指令說找不到，就是因為沒開新的 Terminal。

開新的 Terminal 之後，確認一下：

1
node -v

看到 v22.x.x 或更高的版號就對了。

Step 3：安裝 OpenClaw

1
npm install -g openclaw

等它跑完（大約 1-2 分鐘），確認裝好了：

1
openclaw --version

有版號出來就行。

如果跳出紅字說找不到 openclaw——跑這行看你的 npm 裝東西的路徑在哪：

1
npm prefix -g

它會吐出一個路徑，像是 C:\Users\你的名字\AppData\Roaming\npm。把這串加到系統的 PATH 裡：

  1. 按 Win 鍵，搜尋「環境變數」
  2. 點「編輯系統環境變數」→ 點「環境變數」按鈕
  3. 在使用者變數裡找到 Path，雙擊它
  4. 點「新增」，貼上剛才那串路徑
  5. 一路確定關掉
  6. 重新打開 Terminal

Step 4：跑 Onboarding Wizard

1
openclaw onboard

它會一步一步問你問題。照著回答：

QuickStart 還是 Advanced？ → 選 QuickStart。

AI Provider？ → 看你有什麼訂閱：

如果你有 ChatGPT Plus / Pro / Codex 訂閱（大多數人應該有），選 OpenAI (Codex subscription)。Wizard 會跳出瀏覽器叫你登入 ChatGPT 帳號，授權完就搞定了。你的 OpenClaw 會直接用你的訂閱額度，不用額外花錢。

如果你有 Claude Pro / Max 訂閱，選 Anthropic token (paste setup-token)。你需要先裝 Claude Code CLI 來產生 token：

1
2
npm install -g @anthropic-ai/claude-code
claude setup-token

它會跳出瀏覽器叫你登入 Anthropic 帳號，授權完會吐出一串 token，複製貼到 Wizard 裡。

兩個都沒有？去 OpenAI Platform 或 Anthropic Console 申請 API Key，選對應的 API key 選項貼上。用多少付多少，沒有月費。

Workspace 位置？ → 直接按 Enter（用預設的）。

Gateway Port？ → 直接按 Enter（預設 18789）。

要不要裝聊天通道？ → 先跳過，按 Enter。

要不要安裝背景服務？ → 選不要。我們等一下用 PM2，比較好管。

跑完之後，先試一下 Gateway 能不能動：

1
openclaw gateway

看到 Gateway running on http://127.0.0.1:18789 → 成功。按 Ctrl + C 停掉它。

接著打開 OpenClaw 的 Control UI：

1
openclaw dashboard

它會自動幫你開瀏覽器。看到 OpenClaw 的畫面就代表你的 AI 助手已經活了。

Step 5：安裝 PM2，讓 OpenClaw 不會斷

到上一步，OpenClaw 已經能用了。但你一關掉 Terminal，它就斷了。

PM2 是一個專門讓程式在背景跑的工具。裝上之後，關掉視窗、登出帳號，OpenClaw 都還是繼續跑。

安裝 PM2：

1
npm install -g pm2

用 PM2 啟動 OpenClaw：

1
pm2 start openclaw --name "openclaw" -- gateway

跑完之後，看一下狀態：

1
pm2 list

看到 openclaw 狀態是 online → 正在跑了。

存檔 + 開機自啟動：

1
2
pm2 save
pm2-startup install

如果它吐出一行叫你複製貼上的指令，照做。

驗證： 關掉 Terminal，重新打開一個，跑 openclaw dashboard。畫面正常打開 → PM2 在背景跑著，成功。

以後會用到的 PM2 指令：

  • pm2 list → 看狀態
  • pm2 logs openclaw → 看 log（出問題時用）
  • pm2 restart openclaw → 重啟
  • pm2 stop openclaw → 停掉

Step 6：接上 Discord

到這裡你已經可以在瀏覽器裡跟 AI 聊天了。如果你想用 Discord 來操作，繼續往下。

去 Discord Developer Portal，點 New Application，取個名字。

左邊選 Bot，設定 Username（它在 Discord 裡顯示的名字）。

往下捲到 Privileged Gateway Intents，打開這兩個：

  • ✅ Message Content Intent
  • ✅ Server Members Intent

捲回上面，點 Reset Token。複製那串 Token，存好，它只顯示一次。

左邊選 OAuth2，往下捲到 OAuth2 URL Generator，勾 bot 和 applications.commands。

下面的 Bot Permissions 勾這幾個：View Channels、Send Messages、Read Message History、Embed Links、Attach Files。

最下面會產生一個 URL，複製它，貼到瀏覽器，選你的 Server，確認邀請。

回到 Windows Terminal，把 Token 設進 OpenClaw：

1
2
3
openclaw config set channels.discord.token '"貼上你的TOKEN"' --json
openclaw config set channels.discord.enabled true --json
pm2 restart openclaw

注意 Token 外面是單引號包雙引號（'"像這樣"'）。不是打錯，PowerShell 要這樣寫。

打開 Discord，私訊你的 Bot。它會回一個 pairing code。

回到 Terminal：

1
openclaw pairing approve discord 那串CODE

完成。現在你在 Discord 裡傳訊息給 Bot，AI 就會回你了。

常見問題

指令打了說找不到？

關掉 Terminal 重開一個新的。還是不行的話，回去看 Step 3 加 PATH 那段。

Gateway 起不來？

1
openclaw doctor

想換 AI 模型？

1
openclaw configure --section auth

API Key / Token 安全嗎？

不管是 API Key 還是訂閱的 OAuth token，都存在你自己電腦的設定檔裡。OpenClaw 直接拿它去呼叫 AI Provider 的 API，沒有中間人，不會經過 OpenClaw 的伺服器。

訂閱的 Token 過期了怎麼辦？

OpenAI Codex 的 token 通常會自動刷新。如果 Claude 的 token 過期了，重新跑一次 claude setup-token，然後：

1
2
openclaw models auth paste-token --provider anthropic
pm2 restart openclaw

回顧

你剛剛做了這些事：

  1. 裝了 Node.js
  2. 裝了 OpenClaw
  3. 跑了 Wizard（設定 API Key）
  4. 用 PM2 讓它在背景 24 小時跑
  5. 接上了 Discord

現在你有一個跑在自己電腦上的 AI 助手。關掉視窗不會斷、重開機會自動啟動、資料全在自己手上。

打開 Discord，傳個訊息給你的 Bot 吧。比起在網頁上用 ChatGPT，從自己平常用的聊天軟體叫出 AI、而且它跑在自己的電腦上——那種「這東西是我的」的感覺，真的不一樣。