在 2026 年，OpenClaw（原名 ClawdBot / MoltBot）已成為最受歡迎的開源個人 AI 代理人（AI Agent）架構。它允許你透過 Telegram、WhatsApp 或 Web 介面遠端控制電腦、自動化工作流，並串接多種大語言模型（LLM）。
以下是針對 Windows 環境的完整安裝與配置指南：
📋 第一步：環境預置 (Prerequisites)
OpenClaw 基於 Node.js 運行，且部分組件（如本地模型支持）需要編譯環境。請務必先完成以下安裝：
- Node.js 22 或以上版本：
前往 Node.js 官網 下載 LTS 版本。
安裝後開啟 PowerShell 輸入 node -v 確認版本。 - Visual Studio Build Tools (C++ 編譯工具)：
這是為了支援 node-gyp 和 llama.cpp。
下載 Visual Studio Installer。
安裝時勾選 「使用 C++ 的桌面開發 (Desktop development with C++)」。 - API 金鑰：
準備好你的 OpenAI、Anthropic (Claude) 或 Google Gemini 的 API Key。若想使用本地模型，請先安裝 Ollama。
🚀 第二步：安裝 OpenClaw
在 Windows 上，建議使用 PowerShell (管理員) 執行以下步驟：
1. 開啟指令執行權限
為了防止指令被系統阻擋，請輸入：
PowerShell
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
2. 使用一鍵安裝腳本 (推薦)
這是最快速的方式，會自動偵測環境並安裝必要組件：
PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex
3. 手動安裝 (替代方案)
如果你偏好使用 npm 進行管理：
Bash
npm install -g openclaw@latest
⚙️ 第三步：初始化設定 (Onboarding)
安裝完成後，你需要進行一次性的互動式設定，將 AI 連接到你的聊天軟體與模型：
- 執行初始化：
Bash
openclaw onboard --install-daemon
--install-daemon 會將 OpenClaw 註冊為背景服務，開機自動啟動。 - 設定流程：
選擇模型 (LLM): 選擇你要使用的 AI 供應商並貼上 API Key。
選擇頻道 (Channels): 選擇你想要在哪裡跟 AI 溝通（如 Telegram）。
配對 (Pairing): 依照畫面指示，在 Telegram 搜尋 OpenClaw Bot 並輸入配對碼。
🖥️ 第四步：啟動與管理
設定完成後，你可以透過以下指令操作：
- 啟動服務： openclaw gateway start
- 開啟圖形介面 (Dashboard)： openclaw dashboard
- 查看運行狀態： openclaw gateway status
- 查看日誌 (排錯用)： openclaw logs
⚠️ 常見問題排除 (Troubleshooting)
💡 進階提示：如果你是為了**玩 1997 年的老遊戲《Captain Claw》**而搜尋 OpenClaw，請注意那是另一個開源遊戲引擎專案。你需要下載 OpenClaw (Game Engine) 並將原版的 CLAW.REZ 檔案放入資料夾中即可執行。
