Install overview
インストール
システム要件
- Node 24(推奨)または Node 22.16+ - インストーラースクリプトがこれを自動的に処理します
- macOS、Linux、または Windows - ネイティブ Windows と WSL2 の両方に対応しています。WSL2 のほうが安定しています。Windows を参照してください。
- ソースからビルドする場合のみ
pnpmが必要です
推奨: インストーラースクリプト
最速のインストール方法です。OS を検出し、必要に応じて Node をインストールし、OpenClaw をインストールして、オンボーディングを起動します。
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bashWindows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iexオンボーディングを実行せずにインストールするには:
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboardWindows (PowerShell)
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboardすべてのフラグと CI/自動化オプションについては、インストーラー内部 を参照してください。
代替インストール方法
ローカルプレフィックスインストーラー (install-cli.sh)
システム全体の Node インストールに依存せず、OpenClaw と Node を
~/.openclaw のようなローカルプレフィックスの下に保持したい場合に使用します:
curl -fsSL https://openclaw.ai/install-cli.sh | bashデフォルトで npm インストールに対応し、同じプレフィックスフローの下での git チェックアウトインストールにも対応しています。完全なリファレンス: インストーラー内部。
すでにインストール済みですか? openclaw update --channel dev と openclaw update --channel stable でパッケージインストールと git インストールを切り替えられます。
更新 を参照してください。
npm、pnpm、または bun
Node を自分で管理している場合:
npm
npm install -g openclaw@latestopenclaw onboard --install-daemonpnpm
pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemonbun
bun add -g openclaw@latestopenclaw onboard --install-daemonTroubleshooting: sharp build errors (npm)
グローバルにインストールされた libvips が原因で sharp が失敗する場合:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latestソースから
コントリビューター、またはローカルチェックアウトから実行したい場合:
git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemonまたはリンクを省略し、リポジトリ内から pnpm openclaw ... を使用します。完全な開発ワークフローについては セットアップ を参照してください。
GitHub main からインストール
npm install -g github:openclaw/openclaw#mainコンテナとパッケージマネージャー
コンテナ化された、またはヘッドレスなデプロイ。
Docker に代わるルートレスコンテナ。
Nix flake による宣言的インストール。
自動化されたフリートプロビジョニング。
Bun ランタイムによる CLI のみの使用。
インストールを確認する
openclaw --version # confirm the CLI is availableopenclaw doctor # check for config issuesopenclaw gateway status # verify the Gateway is runningインストール後に管理された起動を使いたい場合:
- macOS:
openclaw onboard --install-daemonまたはopenclaw gateway installによる LaunchAgent - Linux/WSL2: 同じコマンドによる systemd ユーザーサービス
- ネイティブ Windows: まず Scheduled Task を使用し、タスク作成が拒否された場合はユーザーごとの Startup フォルダーのログイン項目にフォールバック
ホスティングとデプロイ
OpenClaw をクラウドサーバーまたは VPS にデプロイします:
更新、移行、またはアンインストール
トラブルシューティング: 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 に含まれていない場合は、シェル起動ファイル(~/.zshrc または ~/.bashrc)に追加してください:
export PATH="$(npm prefix -g)/bin:$PATH"その後、新しいターミナルを開きます。詳細については Node セットアップ を参照してください。