安裝

推薦：安裝程式腳本

最快的安裝方式。它會偵測您的作業系統，在需要時安裝 Node，安裝 OpenClaw，並啟動入門指引。

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

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

若要不執行入門指引直接安裝：

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

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

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

系統需求

Node 24（推薦）或 Node 22.14+ — 安裝程式腳本會自動處理此項
macOS、Linux 或 Windows — 同時支援原生 Windows 和 WSL2；WSL2 更穩定。請參閱 Windows。
pnpm 僅在您從原始碼建置時需要

其他安裝方法

npm 或 pnpm

如果您已自行管理 Node：

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

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

疑難排解：sharp 建置錯誤 (npm)

如果 sharp 因全域安裝的 libvips 而失敗：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

從原始碼

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

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

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

從 GitHub main 安裝

npm install -g github:openclaw/openclaw#main

容器與套件管理員

Docker

容器化或無介面部署。

Podman

Docker 的無 root 容器替代方案。

Nix

透過 Nix flake 進行宣告式安裝。

Ansible

自動化佈建機群。

Bun

透過 Bun 執行時僅使用 CLI。

驗證安裝

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

託管與部署

將 OpenClaw 部署到雲端伺服器或 VPS：

任何 Linux VPS

共用的 Docker 步驟

K8s

Google Cloud

更新、遷移或解除安裝

Updating

保持 OpenClaw 為最新狀態。

Migrating

移動到新機器。

Uninstall

完全移除 OpenClaw。

故障排除：找不到 `openclaw`

如果安裝成功但在終端機中找不到 openclaw：

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

如果 $(npm prefix -g)/bin 不在您的 $PATH 中，請將其新增至您的 shell 啟動檔案（~/.zshrc 或 ~/.bashrc）：

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

然後開啟一個新的終端機。詳情請參閱 Node 設定。