安裝

# 系統需求

• Node 24（建議）或 Node 22.14+ - 安裝程式腳本會自動處理
• macOS、Linux 或 Windows - 支援原生 Windows 和 WSL2；WSL2 較穩定。請參閱 Windows。
• 只有從原始碼建置時才需要 pnpm

# 建議：安裝程式腳本

最快的安裝方式。它會偵測你的作業系統、視需要安裝 Node、安裝 OpenClaw，並啟動入門設定。

curl -fsSL https://openclaw.ai/install.sh | bash

iwr -useb https://openclaw.ai/install.ps1 | iex

若要安裝但不執行入門設定：

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

如需所有旗標和 CI/自動化選項，請參閱安裝程式內部機制。

# 其他安裝方式

# 本機 prefix 安裝程式（install-cli.sh）

當你想將 OpenClaw 和 Node 保留在本機 prefix（例如 ~/.openclaw）底下，而不依賴系統範圍的 Node 安裝時，請使用此方式：

curl -fsSL https://openclaw.ai/install-cli.sh | bash

它預設支援 npm 安裝，也支援在相同 prefix 流程下進行 git-checkout 安裝。完整參考：安裝程式內部機制。

已經安裝了嗎？使用 openclaw update --channel dev 和 openclaw update --channel stable 在套件安裝與 git 安裝之間切換。請參閱更新。

# npm、pnpm 或 bun

如果你已自行管理 Node：

npm install -g openclaw@latest
openclaw onboard --install-daemon

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

bun add -g openclaw@latest
openclaw onboard --install-daemon

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

# 從原始碼安裝

適用於貢獻者，或任何想從本機 checkout 執行的人：

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon

或者略過 link，並在 repo 內使用 pnpm openclaw ...。完整開發工作流程請參閱設定。

# 從 GitHub main 安裝

npm install -g github:openclaw/openclaw#main

# 容器與套件管理器

# 驗證安裝

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw gateway status # verify the Gateway is running

如果你想在安裝後使用受管理的啟動：

• macOS：透過 openclaw onboard --install-daemon 或 openclaw gateway install 使用 LaunchAgent
• Linux/WSL2：透過相同指令使用 systemd 使用者服務
• 原生 Windows：優先使用排程工作；如果建立工作遭拒，則 fallback 到每位使用者的 Startup 資料夾登入項目

# 託管與部署

在雲端伺服器或 VPS 上部署 OpenClaw：

node -v           # Node installed?
npm prefix -g     # Where are global packages?
echo "$PATH"      # Is the global bin dir in PATH?

export PATH="$(npm prefix -g)/bin:$PATH"