Windows 上安裝與移除 OpenClaw

 在 Windows 上安裝與移除 OpenClaw，主要都是透過 Node.js 的 npm（或 pnpm/yarn）與 PowerShell 命令操作，下面是給你的「實務版」步驟，用繁體中文說明。

在 Windows 安裝 OpenClaw

1. 前置準備

確保已安裝 Node.js（建議 18.x 或 20.x 以上版本），可從 https://nodejs.org 下載安裝。

安裝完後，用 PowerShell 驗證：

powershell

node -v

npm -v

有版本號就代表 OK。

2. 一鍵安裝（npm 全域安裝）

用 PowerShell（以「一般使用者」身分執行）執行：

powershell

npm install -g openclaw@latest

等待安裝完成即可。

3. 初始化與配置

安裝完成後，執行：

powershell

openclaw onboard

會啟動互動式設定精靈，讓你設定：

Telegram bot token（如果你要串 Telegram）

選擇 Gateway 模式（例如是否在背景常駐啟動）

其他基本參數（例如 OpenAI / Gemini API Key 等）

設定完之後，可以用：

powershell

openclaw gateway start

啟動 Gateway 服務，以後會在背景運作。

在 Windows 移除 OpenClaw（完全清除）

OpenClaw 若是用 npm -g 裝的，會在以下幾個地方留下東西：

全域 npm 套件

排程任務（OpenClaw Gateway 等）

設定與狀態目錄（~/.openclaw 或自訂路徑）

下面是「完全移除」流程，以 Windows 11 為例：

1. 停止 Gateway 服務

先在 PowerShell 停止常駐服務：

powershell

openclaw gateway stop

如果提示有服務在跑，順便解除註冊：

powershell

openclaw gateway uninstall

這會把 Windows 排程任務（Task Scheduler 裡的 OpenClaw Gateway）移除。

2. 用 npm 全域卸載

執行：

powershell

npm uninstall -g openclaw

驗證是否已卸載：

powershell

npm -g ls --depth=0

清單裡不應再看到 openclaw 或 open-claw。

3. 刪除 ~/.openclaw 設定目錄

在 PowerShell 執行：

powershell

Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"

如果曾用 --profile xxx 啟動，會多一個 ~/.openclaw-xxx 目錄，一起刪除：

powershell

Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw-xxx"

（把 xxx 換成你實際用的 profile 名稱）

4. 檢查並刪除殘留排程任務（手動保險）

如果前面 uninstall 沒有完全清除，可以手動檢查排程任務：

開啟搜尋「排程工作」或「工作排程器」（Task Scheduler）

查找任務名稱為 OpenClaw Gateway 或 OpenClaw Gateway (xxx) 的任務

右鍵刪除，避免開機時出現錯誤事件。

5. 確認是否已完全移除

確認：

npm -g ls 沒有 openclaw

~/.openclaw（與 ~/.openclaw-xxx）目錄已刪除

任務排程器裡沒有 OpenClaw Gateway

用 ps 或資源管理員確認沒有 openclaw / gateway 相關的 Node.js 進程。

若以上都沒有了，就代表 OpenClaw 已從你的 Windows 系統完全移除。

如果你是用 pnpm 或 yarn 安裝的，對應移除指令是：

pnpm：

powershell

pnpm remove -g openclaw

yarn：

powershell

yarn global remove openclaw

==================================================

程式安裝在 C 槽（npm 全域預設），workspace 放在 D 槽，用永久環境變數控制，這是最實用的配置方案。

完整安裝步驟

1. 建立 D 槽 workspace（PowerShell 管理員）

powershell
mkdir D:\openclaw-workspace
mkdir D:\openclaw-workspace\config
mkdir D:\openclaw-workspace\state

2. 設定永久環境變數（PowerShell）

powershell
# 臨時設定（立即生效）
$env:OPENCLAW_WORKSPACE="D:\openclaw-workspace"
$env:OPENCLAW_CONFIG_PATH="D:\openclaw-workspace\config"
$env:OPENCLAW_STATE_DIR="D:\openclaw-workspace\state"

# 永久設定（User 範圍，重啟後生效）
[Environment]::SetEnvironmentVariable("OPENCLAW_WORKSPACE", "D:\openclaw-workspace", "User")
[Environment]::SetEnvironmentVariable("OPENCLAW_CONFIG_PATH", "D:\openclaw-workspace\config", "User")
[Environment]::SetEnvironmentVariable("OPENCLAW_STATE_DIR", "D:\openclaw-workspace\state", "User")

3. 安裝 Node.js（允許 C 槽）

下載 Node.js 22+ 官方安裝檔，使用預設 C 槽安裝。

4. 安裝 OpenClaw（程式在 C 槽）

powershell
npm install -g openclaw@latest

程式安裝位置：C:\Users\[使用者]\AppData\Roaming\npm\node_modules\openclaw

5. 重要：重新啟動 PowerShell 載入環境變數

6. 初始設定（使用 D 槽 workspace）

powershell
openclaw onboard --install-daemon

資料儲存位置：D:\openclaw-workspace\

最終檔案分佈

text
C: 槽（僅程式，約 200MB）
└── C:\Users\[使用者]\AppData\Roaming\npm\
    └── node_modules\openclaw\          # 程式碼

D: 槽（所有資料，依使用成長）
└── D:\openclaw-workspace\
    ├── config\openclaw.json            # 設定檔
    ├── state\                          # 對話記錄、快取
    └── .env                            # API 金鑰

驗證檢查清單

powershell
# 1. 環境變數
echo $env:OPENCLAW_WORKSPACE    # D:\openclaw-workspace ✓

# 2. 程式位置  
npm prefix -g                   # C:\Users\... ✓

# 3. 健康檢查
openclaw doctor                 # 所有路徑顯示 D:\openclaw-workspace ✓