安裝指南

安裝 OpenClaw

多種安裝方式任你選,殊途同歸。

checklist 系統需求

javascript Node.js

Node.js 22 或更高版本(建議使用 LTS)

computer OS

Windows 10+、macOS 12+ 或 Linux(Ubuntu 20.04+、Debian 11+)

memory RAM

最低 2 GB RAM,建議 4 GB

hard_drive Disk

安裝和相依套件約需 ~500 MB 磁碟空間

extension Optional

選用:Python 3.10+(部分技能需要)、Git(從原始碼建置時需要)

wifi Network

AI API 呼叫需要網路連線。透過 Ollama 使用本機模型可離線運作。

複製貼上一行指令就完成。大多數人選這個。 完整說明在文件裡 arrow_forward

Windows (PowerShell)

建議用系統管理員權限執行 PowerShell。

PS> 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 已正確安裝。

1
$ openclaw --version

應顯示已安裝的版本號(例如 v2026.3.12)。

2
$ openclaw doctor

對你的環境執行診斷檢查:Node.js 版本、相依套件、設定檔和連線狀態。

3
$ openclaw onboard

互動式設定精靈,引導你完成 API Key、聊天平台連接和初始設定。

settings 初始設定

安裝完成後,onboard 精靈會引導你完成設定。以下是每個步驟的說明。

1

選擇 AI 供應商

選擇 Anthropic (Claude)、OpenAI (GPT)、Google (Gemini) 或透過 Ollama 使用本機模型。你可以隨時在設定中切換供應商。

2

新增 API Key

從供應商的控制台貼上你的 API Key。Key 儲存在本機的 .env 檔案中——除了 AI 供應商外不會傳送到任何地方。

3

連接聊天平台

連結 WhatsApp(掃描 QR Code)、Telegram(從 @BotFather 貼上機器人 Token)、Discord(貼上機器人 Token)或其他支援的平台。

4

發送測試訊息

透過已連接的聊天應用程式向 OpenClaw 發送訊息。如果收到回覆,就大功告成了。試試:'你能做什麼?'

.env — 所有設定儲存在 ~/.openclaw/.env。你可以直接編輯此檔案來更換供應商、新增 API Key 或調整設定。完整參考請見 docs.openclaw.ai/configuration。

system_update_alt 升級 OpenClaw

保持 OpenClaw 為最新版本,取得最新功能、整合和安全修補。 升級和搬遷教學 arrow_forward

npm
$ npm update -g openclaw@latest
pnpm
$ pnpm update -g openclaw@latest
Git
$ cd openclaw && git pull && pnpm install && pnpm run build
Docker
$ docker pull openclaw/openclaw:latest && docker restart openclaw

在 github.com/openclaw/openclaw/releases 查看更新日誌,了解每個版本的新功能。

delete_forever 移除 OpenClaw

如果需要從系統中卸載 OpenClaw,請依照當初的安裝方式,照步驟操作。 移除的詳細步驟 arrow_forward

npm
$ npm uninstall -g openclaw
pnpm
$ pnpm remove -g openclaw
Git (Source)
$ rm -rf ~/openclaw
Docker
$ docker stop openclaw && docker rm openclaw && docker rmi openclaw/openclaw:latest

刪除使用者資料(選用)

這會清除所有對話紀錄、技能、設定和 API 金鑰。執行前請先備份重要資料。

macOS/Linux $ rm -rf ~/.openclaw
Windows PS> rmdir /s /q %USERPROFILE%\.openclaw

build 疑難排解

常見問題及解決方法。 更多排錯方法 arrow_forward

遇到問題?

來 Discord 問問,總有人能幫到你。

訂閱更新

第一時間收到新功能和整合資訊。不會發垃圾信,隨時可以退訂。