安裝 OpenClaw
多種安裝方式任你選,殊途同歸。
checklist 系統需求
Node.js 22 或更高版本(建議使用 LTS)
Windows 10+、macOS 12+ 或 Linux(Ubuntu 20.04+、Debian 11+)
最低 2 GB RAM,建議 4 GB
安裝和相依套件約需 ~500 MB 磁碟空間
選用:Python 3.10+(部分技能需要)、Git(從原始碼建置時需要)
AI API 呼叫需要網路連線。透過 Ollama 使用本機模型可離線運作。
複製貼上一行指令就完成。大多數人選這個。 完整說明在文件裡 arrow_forward
Windows (PowerShell)
建議用系統管理員權限執行 PowerShell。
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd --tag beta && del install.cmd macOS / Linux
macOS 和主流 Linux 發行版都能用。
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git verified 驗證安裝
執行以下指令確認 OpenClaw 已正確安裝。
openclaw --version 應顯示已安裝的版本號(例如 v2026.3.12)。
openclaw doctor 對你的環境執行診斷檢查:Node.js 版本、相依套件、設定檔和連線狀態。
openclaw onboard 互動式設定精靈,引導你完成 API Key、聊天平台連接和初始設定。
settings 初始設定
安裝完成後,onboard 精靈會引導你完成設定。以下是每個步驟的說明。
選擇 AI 供應商
選擇 Anthropic (Claude)、OpenAI (GPT)、Google (Gemini) 或透過 Ollama 使用本機模型。你可以隨時在設定中切換供應商。
新增 API Key
從供應商的控制台貼上你的 API Key。Key 儲存在本機的 .env 檔案中——除了 AI 供應商外不會傳送到任何地方。
連接聊天平台
連結 WhatsApp(掃描 QR Code)、Telegram(從 @BotFather 貼上機器人 Token)、Discord(貼上機器人 Token)或其他支援的平台。
發送測試訊息
透過已連接的聊天應用程式向 OpenClaw 發送訊息。如果收到回覆,就大功告成了。試試:'你能做什麼?'
.env — 所有設定儲存在 ~/.openclaw/.env。你可以直接編輯此檔案來更換供應商、新增 API Key 或調整設定。完整參考請見 docs.openclaw.ai/configuration。
system_update_alt 升級 OpenClaw
保持 OpenClaw 為最新版本,取得最新功能、整合和安全修補。 升級和搬遷教學 arrow_forward
npm update -g openclaw@latest pnpm update -g openclaw@latest cd openclaw && git pull && pnpm install && pnpm run build docker pull openclaw/openclaw:latest && docker restart openclaw 在 github.com/openclaw/openclaw/releases 查看更新日誌,了解每個版本的新功能。
delete_forever 移除 OpenClaw
如果需要從系統中卸載 OpenClaw,請依照當初的安裝方式,照步驟操作。 移除的詳細步驟 arrow_forward
npm uninstall -g openclaw pnpm remove -g openclaw rm -rf ~/openclaw docker stop openclaw && docker rm openclaw && docker rmi openclaw/openclaw:latest 刪除使用者資料(選用)
這會清除所有對話紀錄、技能、設定和 API 金鑰。執行前請先備份重要資料。
rm -rf ~/.openclaw rmdir /s /q %USERPROFILE%\.openclaw