建立 2026-09-15 更新 2026-09-15

安裝

安裝目標是讓終端機能跑 openclaw 這個 CLI。閘道（Gateway）與模型金鑰是下一步新手引導才設定的；這裡先把執行檔與 Node 備齊。

你需要什麼

Node.js 24.16+ 或 26.1+（官方建議 26；安裝腳本在 macOS 缺 Node 時會幫你裝 26，Linux 則偏 Node 24 LTS）
macOS、Linux、Windows，或 WSL2
稍後會用到的模型登入：現成的 Claude Code／Codex CLI，或 Anthropic、OpenAI、Google 等 API 金鑰

用 node --version 確認版本。Windows 桌面若不想碰終端機，可改下載 Windows Hub 安裝程式。

腳本會偵測作業系統、必要時安裝 Node、裝上 OpenClaw，並啟動新手引導。

macOS／Linux／WSL2：

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

Windows PowerShell：

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

只想安裝、暫時不跑引導：

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

npx openclaw@latest

全新安裝時選 Quick start：若已偵測到可用的模型登入，它會做一次真正的 completion 驗證、寫入設定，並打開網頁儀表板。閘道會佔著這個終端機，Ctrl+C 停止後設定仍會保留。之後再執行 openclaw gateway install 改成背景服務。

方式	何時用
npm / pnpm / bun	你自己管 Node 版本
`install-cli.sh`	希望 Node 與 OpenClaw 都住在 `~/.openclaw`，不碰系統 Node
Docker / Nix / 原始碼	容器、宣告式環境、或要改專案本身

npm 12 預設會擋套件生命週期腳本，全域安裝需加 --allow-scripts=openclaw。細節見 Install。

npm install -g openclaw@latest --allow-scripts=openclaw

openclaw --version
openclaw doctor
openclaw gateway status

openclaw 找不到，幾乎都是 npm 全域 bin 不在 PATH。查：

node -v
npm prefix -g
echo "$PATH"