
安裝 OpenClaw 大約需要 5 分鐘你需要 Node.js 版本 22 或更高、Git,以及至少 8GB 的記憶體最快的方式是透過一條命令全域安裝:npm install -g openclaw@latest。然後運行引導精靈完成設定如果你不想在本地安裝任何東西,也可以使用 OpenClawTool 的託管版本,幾秒鐘內即可獲得可用的 OpenClaw 實例
開始之前
請確認你的系統符合以下要求:
記憶體 (RAM):最少 8GB,建議 16GB 或以上
存儲空間:至少 10GB 空餘空間,建議 20GB 或以上
Node.js:版本 22 或更新(建議最新 LTS)
作業系統:Windows 10(強烈建議使用 WSL2)、macOS 12 或更新
選項 1:使用 OpenClawTool(推薦給初學者)
最簡單的方法是完全跳過本地安裝,使用 OpenClawTool 的託管服務
無需配置
24/7 運行,不需要一直開著電腦
永遠使用最新版本的 OpenClaw

選項 2:本地自建安裝
本地安裝有兩種主要方式:全域安裝(大部分用戶推薦)和從源碼編譯(開發者想完全控制的情況使用)
推薦:全域安裝
在終端機中運行以下命令:
npm install -g openclaw@latest
openclaw onboard --install-daemon
--install-daemon 會將 OpenClaw 設置為背景服務,即使關閉終端機也能持續運行
安裝完成後,檢查是否運行正常:
openclaw doctor
引導精靈會引導你設定 gateways、workspaces、channels 和 skills

從源碼編譯(開發者用)
如果你想貢獻或需要最大化自定義,可從 GitHub 倉庫編譯:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
安裝依賴並編譯:
pnpm install
pnpm ui:build
pnpm build
運行引導精靈:
pnpm openclaw onboard --install-daemon

平台特定安裝指引
Windows
強烈建議使用 WSL2
若必須在原生 Windows 安裝:
從 nodejs.org 安裝 Node.js v22+ LTS
安裝 Git for Windows
安裝 pnpm
重啟終端機
然後 clone 倉庫,運行 pnpm install、pnpm ui:build、pnpm build,最後啟動引導精靈

macOS
最簡單的方法是使用 Homebrew:
若尚未安裝 Homebrew,先執行:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
然後安裝所需工具:
brew install node git pnpm
之後 clone 倉庫、安裝依賴、編譯,並運行引導精靈,如上所示
注意:OpenClaw 可能需要螢幕錄製與輔助功能權限
請前往 系統設定 > 隱私與安全性 > 輔助功能,並將你的終端機應用程式加入允許列表(若系統提示)

常見問題排查
pnpm 權限錯誤:避免使用 sudo,建議使用 nvm 管理 Node.js 版本
Node.js 版本過舊:切換版本:
nvm install 22 && nvm use 22
埠口已被佔用:可指定不同埠口:
openclaw gateway --port 18790
安裝完成後,可隨時運行診斷:
openclaw doctor