Install overview
インストール
システム要件
- Node 22.19+、23.11+、または 24+ - 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 を使用した宣言的インストール。
フリートの自動プロビジョニング。
Bun ランタイムを使用した CLI のみの利用。
インストールの確認
openclaw --version # CLI が利用可能であることを確認openclaw doctor # 設定の問題を確認openclaw gateway status # Gateway が実行中であることを確認インストール後に管理された自動起動を使用する場合:
- macOS:
openclaw onboard --install-daemonまたはopenclaw gateway installによる LaunchAgent - Linux/WSL2: 同じコマンドによる systemd ユーザーサービス
- ネイティブ Windows: まずスケジュールされたタスクを使用し、タスクの作成が拒否された場合は、ユーザーごとの 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 に含まれているか?