如何安裝 OpenClaw

使用官方安裝程序並完成入門嚮導,以獲得最快、最安全的設置。

簡短回答

Confirm system requirements (Node.js 22+, macOS or Linux or Windows via WSL2), run the official install script, then complete openclaw onboard to connect channels and models.

步驟 1:先檢查要求

OpenClaw 依賴於現代 Node 功能,因此需要 Node.js 22 或更高版本。在 Windows 上,支援的路徑是 WSL2。在舊版 Node 上安裝是導致失敗的最常見原因。

步驟 2:使用官方安裝腳本

推薦的方法安裝 CLI 並準備運行環境:

curl -fsSL https://openclaw.bot/install.sh | bash
openclaw onboard --install-daemon

步驟 3:完成入門設置

嚮導將引導您完成配對訊息頻道、選擇模型提供者以及啟用技能的過程。在這裡,您可以設定初始權限並確認 OpenClaw 可以存取哪些內容。

安裝後的實用命令

Use openclaw doctor to validate dependencies, openclaw status or openclaw health to check the gateway, and openclaw update to stay current.

在生產環境使用前驗證安裝

入門設置後,運行一個使用低風險技能的小型測試任務,例如在臨時文件夾中創建文件或總結本地文本文件。這將確認您的頻道、模型和技能已正確連接。如果您在伺服器上部署,請驗證僅開啟了必要的連接埠,並強制執行管理員配對。

常見的安裝陷阱

Most failures come from an outdated Node version, missing build tools, or running the script under the wrong user account. Another frequent issue is partial installs caused by network errors during package download. If the CLI behaves inconsistently, re-run the install script and check logs with openclaw doctor .

安全提醒

請勿將管理員端點暴露給公共互聯網,並避免安裝不受信任的技能。如果您在伺服器上運行 OpenClaw,請鎖定連接埠並使用最低權限存取。

官方參考資料

For exact instructions, see the official install and wizard pages: Install and Onboard .