Install overview
インストール
システム要件
- Node 22.22.3+、24.15+、または 25.9+ - Node 24 がデフォルトの対象です。インストーラースクリプトがこれを自動的に処理します。
- macOS、Linux、または Windows - Windows ユーザーは、ネイティブ Windows Hub アプリ、PowerShell CLI インストーラー、または WSL2 Gateway から始められます。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-daemonソースから
コントリビューター、またはローカルチェックアウトから実行したい場合:
git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemonまたはリンクを省略し、リポジトリ内から pnpm openclaw ... を使用します。開発ワークフローの詳細については、セットアップを参照してください。
GitHub の main チェックアウトからインストール
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version mainコンテナとパッケージマネージャー
コンテナ化またはヘッドレスデプロイ。
Docker に代わるルートレスコンテナ。
Nix flake による宣言的インストール。
フリートの自動プロビジョニング。
オプションの依存関係インストーラーおよびパッケージスクリプトランナー。
インストールの確認
openclaw --version # CLI が利用可能であることを確認openclaw doctor # 設定の問題を確認openclaw gateway status # Gateway が実行中であることを確認インストール後に管理された自動起動を使用する場合:
- macOS:
openclaw onboard --install-daemonまたはopenclaw gateway installによる LaunchAgent - Linux/WSL2:同じコマンドによる systemd ユーザーサービス
- ネイティブ Windows:最初に Scheduled Task を使用し、タスクの作成が拒否された場合はユーザーごとの Startup フォルダーのログイン項目へフォールバック
ホスティングとデプロイ
OpenClaw をクラウドサーバーまたは VPS にデプロイします。プロバイダー選択の全一覧 (DigitalOcean、Hetzner、Hostinger、Fly.io、GCP、Azure、Railway、 Northflank、Oracle Cloud、Raspberry Pi など)については Linux サーバーを参照するか、 Render に宣言的にデプロイしてください。
更新、移行、またはアンインストール
トラブルシューティング:openclaw が見つからない
ほとんどの場合は PATH の問題です。npm のグローバル bin ディレクトリがシェルの PATH に含まれていません。Windows のパスを含む完全な修正方法については、Node.js のトラブルシューティングを参照してください。
node -v # Node はインストール済み?npm prefix -g # グローバルパッケージの場所は?echo "$PATH" # グローバル bin ディレクトリは PATH に含まれている?