安裝
已經完成快速入門了嗎？那你已經準備好了——這頁是替代安裝方式、各平台說明和維護指南。
系統需求
- Node 24（推薦）（Node 22 LTS，目前
22.16+，仍支援以確保相容性；安裝腳本會在缺少時自動安裝 Node 24） - macOS、Linux 或 Windows
pnpm僅在從原始碼建置時需要
注意： 在 Windows 上，我們強烈建議透過 WSL2 執行 OpenClaw。
安裝方式
提示： 安裝腳本是安裝 OpenClaw 的推薦方式。它會偵測 Node、在需要時安裝，並一步完成初始設定。
警告： 對於 VPS/雲端主機，盡量避免使用第三方「一鍵」市集映像。建議使用乾淨的基礎作業系統映像（例如 Ubuntu LTS），然後自行透過安裝腳本安裝 OpenClaw。
安裝腳本
下載 CLI，透過 npm 全域安裝，並啟動初始設定精靈。
#### macOS / Linux / WSL2
```bash
curl -fsSL https://openclaw.ai/install.sh | bash
```
#### Windows (PowerShell)
```powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
```
就這樣——腳本會處理 Node 偵測、安裝和初始設定。
如果要跳過初始設定，只安裝二進位檔：
#### macOS / Linux / WSL2
```bash
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
```
#### Windows (PowerShell)
```powershell
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
```
所有旗標、環境變數和 CI/自動化選項，請參閱[安裝程式內部機制](/docs/install/installer)。npm / pnpm
如果你自行管理 Node，推薦 Node 24。OpenClaw 仍支援 Node 22 LTS，目前 `22.16+`：
#### npm
```bash
npm install -g openclaw@latest
openclaw onboard --install-daemon
```
<details>sharp 建置錯誤？
如果你有全域安裝的 libvips（macOS 透過 Homebrew 常見）且 `sharp` 建置失敗，強制使用預建二進位檔：
```bash
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
```
如果看到 `sharp: Please add node-gyp to your dependencies`，請安裝建置工具（macOS: Xcode CLT + `npm install -g node-gyp`）或使用上述環境變數。
</details>
#### pnpm
```bash
pnpm add -g openclaw@latest
pnpm approve-builds -g # 核准 openclaw、node-llama-cpp、sharp 等
openclaw onboard --install-daemon
```
> **注意：** pnpm 要求明確核准含有建置腳本的套件。首次安裝出現「Ignored build scripts」警告後，執行 `pnpm approve-builds -g` 並選擇列出的套件。從原始碼安裝
適合貢獻者或想從本機 checkout 執行的人。
### 步驟 1：複製並建置
複製 [OpenClaw 儲存庫](https://github.com/openclaw/openclaw)並建置：
```bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
```
### 步驟 2：建立 CLI 全域連結
讓 `openclaw` 指令可全域使用：
```bash
pnpm link --global
```
或者跳過連結，在儲存庫目錄內透過 `pnpm openclaw ...` 執行指令。
### 步驟 3：執行初始設定
```bash
openclaw onboard --install-daemon
```
更深入的開發流程，請參閱[設定](/docs/start/setup)。其他安裝方式
- Docker — 容器化或 headless 部署。
- Podman — Rootless 容器：執行一次
setup-podman.sh，然後使用啟動腳本。 - Nix — 透過 Nix 宣告式安裝。
- Ansible — 自動化伺服器群組佈建。
- Bun — 透過 Bun runtime 執行 CLI。
安裝後
確認一切正常：
openclaw doctor # 檢查設定問題
openclaw status # 閘道狀態
openclaw dashboard # 開啟瀏覽器介面如需自訂路徑，使用：
OPENCLAW_HOME用於內部路徑的基礎目錄OPENCLAW_STATE_DIR用於可變狀態位置OPENCLAW_CONFIG_PATH用於設定檔位置
優先順序與完整說明請參閱環境變數。
疑難排解：找不到 openclaw
PATH 診斷與修復
快速診斷：
node -v
npm -v
npm prefix -g
echo "$PATH"如果 $(npm prefix -g)/bin（macOS/Linux）或 $(npm prefix -g)（Windows）不在 $PATH 中，shell 找不到全域 npm 二進位檔（包含 openclaw）。
修復——加入 shell 啟動檔（~/.zshrc 或 ~/.bashrc）：
export PATH="$(npm prefix -g)/bin:$PATH"在 Windows 上，將 npm prefix -g 的輸出加入系統 PATH。
然後開啟新終端（或在 zsh 中執行 rehash / 在 bash 中執行 hash -r）。