在 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. 開啟指令執行權限
為了防止指令被系統阻擋，請輸入：
PowerShellSet-ExecutionPolicy RemoteSigned -Scope CurrentUser
2. 使用一鍵安裝腳本 (推薦)
這是最快速的方式，會自動偵測環境並安裝必要組件：
PowerShelliwr -useb https://openclaw.ai/install.ps1 | iex
3. 手動安裝 (替代方案)
如果你偏好使用 npm 進行管理：
Bashnpm install -g openclaw@latest
⚙️ 第三步：初始化設定 (Onboarding)
安裝完成後，你需要進行一次性的互動式設定，將 AI 連接到你的聊天軟體與模型：
- 執行初始化：Bashopenclaw 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)
問題現象解決方法npm 安裝時報錯 node-gyp請確認已安裝 Visual Studio Build Tools 並重啟電腦。無法開啟 Dashboard手動執行 openclaw gateway 確保後端服務已啟動。指令找不到 openclaw重新開啟 PowerShell，或確認 npm 的路徑已加入系統環境變數 (PATH)。API 連線超時檢查網路是否能存取模型 API，或在設定中加入代理伺服器 (Proxy)。
💡 進階提示：如果你是為了**玩 1997 年的老遊戲《Captain Claw》**而搜尋 OpenClaw，請注意那是另一個開源遊戲引擎專案。你需要下載 OpenClaw (Game Engine) 並將原版的 CLAW.REZ 檔案放入資料夾中即可執行。
