Install overview
インストーラーの内部構造
OpenClaw には、openclaw.ai から配信される 3 つのインストーラースクリプトが付属しています。
| スクリプト | プラットフォーム | 機能 |
|---|---|---|
install.sh |
macOS / Linux / WSL | 必要に応じて Node をインストールし、npm（デフォルト）または git 経由で OpenClaw をインストールします。オンボーディングも実行できます。 |
install-cli.sh |
macOS / Linux / WSL | Node と OpenClaw を npm または git 経由でローカルプレフィックス（~/.openclaw）にインストールします。root 権限は不要です。 |
install.ps1 |
Windows (PowerShell) | 必要に応じて Node をインストールし、npm（デフォルト）または git 経由で OpenClaw をインストールします。オンボーディングも実行できます。 |
3 つすべてが Node 22.22.3+、24.15+、または 25.9+ をサポートしています。新規インストールでは Node 24 がデフォルトの対象です。
クイックコマンド
install.sh
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bashcurl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --helpinstall-cli.sh
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bashcurl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --helpinstall.ps1
iwr -useb https://openclaw.ai/install.ps1 | iex& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta -NoOnboard -DryRuninstall.sh
フロー（install.sh）
OS を検出
macOS と Linux（WSL を含む）をサポートします。
デフォルトで Node.js 24 を確保
Node のバージョンを確認し、必要に応じて Node 24 をインストールします（macOS では Homebrew、Linux では NodeSource の apt/dnf/yum セットアップスクリプト）。macOS では、インストーラーが Node または Git のために必要とする場合に限り Homebrew をインストールします。Node 22.22.3+、Node 24.15+、Node 25.9+ がサポートされ、Node 23 はサポートされません。
Alpine/musl Linux では、インストーラーは NodeSource の代わりに apk パッケージを使用し、実際にリンクされている SQLite のバージョンを検証します。現在の安定版 Alpine パッケージストリームでは、十分に新しい Node が提供されていても、脆弱なシステム SQLite が使用される場合があります。その場合は、代わりに公式の node:24-alpine コンテナまたは glibc ベースのホストを使用してください。
Git を確保
Git がない場合、検出されたパッケージマネージャーを使用してインストールします。これには macOS の Homebrew と Alpine の apk が含まれます。
OpenClaw をインストール
npm方式（デフォルト）：グローバル npm インストールgit方式：リポジトリをクローンまたは更新し、pnpm で依存関係をインストールしてビルドした後、~/.local/bin/openclawにラッパーをインストール
インストール後のタスク
- 後続コマンド用に、インストールされたばかりの
openclawバイナリを解決します - 未構成のインストールでは、doctor または gateway のプローブより先にオンボーディングを開始します。
--no-onboardが指定されている場合、または TTY がない場合は、後でセットアップを完了するためのコマンドを出力します。 - 構成済みのインストールでは、読み込まれている gateway サービスをベストエフォートで更新して再起動し、doctor を実行します。アップグレードでは可能な場合に plugins を更新し、プロンプトが有効なヘッドレス実行では手動コマンドを出力します。
--verifyの実行時は、インストール済みバージョンを確認し、構成が存在する場合にのみ gateway の正常性を確認します。
ソースチェックアウトの検出
OpenClaw のチェックアウト内（package.json + pnpm-workspace.yaml）で実行すると、スクリプトは次の選択肢を提示します。
- チェックアウトを使用（
git）、または - グローバルインストールを使用（
npm）
TTY が利用できず、インストール方式も設定されていない場合は、デフォルトで npm を使用し、警告を表示します。
無効な方式を選択した場合、または --install-method の値が無効な場合、スクリプトはコード 2 で終了します。
例（install.sh）
デフォルト
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bashオンボーディングをスキップ
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-onboardGit インストール
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method gitGitHub main チェックアウト
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version mainドライラン
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --dry-runインストール後に検証
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-onboard --verifyフラグのリファレンス
| フラグ | 説明 |
|---|---|
--install-method | --method npm|git |
インストール方式を選択（デフォルト：npm） |
--npm |
npm 方式のショートカット |
--git | --github |
git 方式のショートカット |
--version <version|dist-tag|spec> |
npm のバージョン、dist-tag、またはパッケージ仕様（デフォルト：latest） |
--beta |
利用可能な場合は beta dist-tag を使用し、それ以外の場合は latest にフォールバック |
--git-dir | --dir <path> |
チェックアウトディレクトリ（デフォルト：~/openclaw） |
--no-git-update |
既存のチェックアウトに対する git pull をスキップ |
--no-prompt |
プロンプトを無効化 |
--no-onboard |
オンボーディングをスキップ |
--onboard |
オンボーディングを有効化 |
--verify |
インストール後のスモーク検証を実行（--version、読み込まれている場合は gateway の正常性） |
--dry-run |
変更を適用せずに操作内容を出力 |
--verbose |
デバッグ出力を有効化（set -x、npm の notice レベルのログ） |
--help | -h |
使用方法を表示 |
環境変数のリファレンス
| 変数 | 説明 |
|---|---|
OPENCLAW_INSTALL_METHOD=git|npm |
インストール方式 |
OPENCLAW_VERSION=latest|next|<semver>|<spec> |
npm のバージョン、dist-tag、またはパッケージ仕様 |
OPENCLAW_BETA=0|1 |
利用可能な場合は beta を使用 |
OPENCLAW_HOME=<path> |
OpenClaw の状態およびデフォルトの git/オンボーディングパスのベースディレクトリ |
OPENCLAW_GIT_DIR=<path> |
チェックアウトディレクトリ |
OPENCLAW_GIT_UPDATE=0|1 |
git 更新を切り替え |
OPENCLAW_NO_PROMPT=1 |
プロンプトを無効化 |
OPENCLAW_VERIFY_INSTALL=1 |
インストール後のスモーク検証を実行 |
OPENCLAW_NO_ONBOARD=1 |
オンボーディングをスキップ |
OPENCLAW_DRY_RUN=1 |
ドライランモード |
OPENCLAW_VERBOSE=1 |
デバッグモード |
OPENCLAW_NPM_LOGLEVEL=error|warn|notice |
npm のログレベル（デフォルト：error、npm の非推奨警告ノイズを非表示） |
install-cli.sh
フロー（install-cli.sh）
ローカル Node ランタイムをインストール
固定されたサポート対象の Node LTS tarball（バージョンはスクリプトに埋め込まれ、個別に更新されます。デフォルトは 24.15.0）を <prefix>/tools/node-v<version> にダウンロードし、SHA-256 を検証します。
公式の Node 24+ ARMv7 バイナリが利用できないため、Linux ARMv7 では Node 22.22.3 を使用します。
固定ランタイム用の互換性のある tarball が Node から公開されていない Alpine/musl Linux では、apk を使用して nodejs と npm をインストールし、Node と実際にリンクされている SQLite ライブラリの両方を検証します。現在の安定版 Alpine パッケージストリームでは、十分に新しい Node でも脆弱な SQLite がリンクされる場合があります。安全性チェックによってパッケージが拒否された場合は、公式の node:24-alpine コンテナまたは glibc ベースのホストを使用してください。
Git を確保
Git がない場合、Linux では apt/dnf/yum/apk、macOS では Homebrew を使用してインストールを試みます。
プレフィックス配下に OpenClaw をインストール
npm方式（デフォルト）：npm を使用してプレフィックス配下にインストールし、<prefix>/bin/openclawにラッパーを書き込みますgit方式：チェックアウト（デフォルトは~/openclaw）をクローンまたは更新し、引き続き<prefix>/bin/openclawにラッパーを書き込みます
読み込まれている gateway サービスを更新
同じプレフィックスから gateway サービスがすでに読み込まれている場合、スクリプトは
openclaw gateway install --force を実行して置換後のサービスを有効化し、
その後、gateway の正常性をベストエフォートでプローブします。
例（install-cli.sh）
デフォルト
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bashカスタムプレフィックス + バージョン
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix /opt/openclaw --version latestGit インストール
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --install-method git --git-dir ~/openclaw自動化用 JSON 出力
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclawオンボーディングを実行
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --onboardフラグのリファレンス
| フラグ | 説明 |
|---|---|
--prefix <path> |
インストールプレフィックス（デフォルト: ~/.openclaw） |
--install-method | --method npm|git |
インストール方法を選択（デフォルト: npm） |
--npm |
npm 方式のショートカット |
--git | --github |
git 方式のショートカット |
--git-dir | --dir <path> |
Git チェックアウトディレクトリ（デフォルト: ~/openclaw） |
--version <ver> |
OpenClaw のバージョンまたは dist-tag（デフォルト: latest） |
--node-version <ver> |
Node のバージョン（デフォルト: 24.15.0、Linux ARMv7 では 22.22.3） |
--json |
NDJSON イベントを出力 |
--onboard |
インストール後に openclaw onboard を実行 |
--no-onboard |
オンボーディングをスキップ（デフォルト） |
--set-npm-prefix |
Linux で、現在のプレフィックスが書き込み不可の場合、npm プレフィックスを ~/.npm-global に強制設定 |
--help | -h |
使用方法を表示 |
環境変数リファレンス
| 変数 | 説明 |
|---|---|
OPENCLAW_PREFIX=<path> |
インストールプレフィックス |
OPENCLAW_INSTALL_METHOD=git|npm |
インストール方法 |
OPENCLAW_VERSION=<ver> |
OpenClaw のバージョンまたは dist-tag |
OPENCLAW_NODE_VERSION=<ver> |
Node のバージョン |
OPENCLAW_HOME=<path> |
OpenClaw の状態とデフォルトの git／オンボーディングパスのベースディレクトリ |
OPENCLAW_GIT_DIR=<path> |
git インストール用の Git チェックアウトディレクトリ |
OPENCLAW_GIT_UPDATE=0|1 |
既存のチェックアウトに対する git 更新を切り替え |
OPENCLAW_NO_ONBOARD=1 |
オンボーディングをスキップ |
OPENCLAW_NPM_LOGLEVEL=error|warn|notice |
npm ログレベル（デフォルト: error） |
install.ps1
フロー（install.ps1）
PowerShell と Windows 環境を確保
PowerShell 5 以降が必要です。
デフォルトで Node.js 24 を確保
見つからない場合、winget、Chocolatey、Scoop の順にインストールを試みます。利用可能なパッケージマネージャーがない場合、スクリプトは公式の Node.js 24 Windows zip を %LOCALAPPDATA%\OpenClaw\deps\portable-node にダウンロードし、現在のプロセスとユーザーの PATH に追加します。Node 22.22.3 以降、Node 24.15 以降、Node 25.9 以降がサポートされます。Node 23 はサポートされません。
OpenClaw をインストール
npm方式（デフォルト）: 選択した-Tagを使用したグローバル npm インストール。書き込み可能なインストーラーの一時ディレクトリから起動するため、C:\などの保護されたフォルダーで開いたシェルでも動作しますgit方式: リポジトリをクローンまたは更新し、pnpm でインストールおよびビルドして、%USERPROFILE%\.local\bin\openclaw.cmdにラッパーをインストールします。Git が見つからない場合、スクリプトはユーザーローカルの MinGit を%LOCALAPPDATA%\OpenClaw\deps\portable-gitにブートストラップし、現在のプロセスとユーザーの PATH に追加します。
インストール後のタスク
- 可能な場合、必要な bin ディレクトリをユーザーの PATH に追加します
- 読み込まれている Gateway サービスをベストエフォートで更新します（
openclaw gateway install --force、続いて再起動） - アップグレード時と git インストール時に
openclaw doctor --non-interactiveを実行します（ベストエフォート）
失敗を処理
iwr ... | iex およびスクリプトブロックによるインストールでは、現在の PowerShell セッションを閉じずに終了エラーを報告します。直接の powershell -File／pwsh -File インストールは、自動化のために引き続きゼロ以外の終了コードで終了します。
例（install.ps1）
デフォルト
iwr -useb https://openclaw.ai/install.ps1 | iexGit インストール
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod gitGitHub main チェックアウト
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git -Tag mainカスタム git ディレクトリ
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git -GitDir "C:\openclaw"ドライラン
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -DryRunフラグリファレンス
| フラグ | 説明 |
|---|---|
-InstallMethod npm|git |
インストール方法（デフォルト: npm） |
-Tag <tag|version|spec> |
npm の dist-tag、バージョン、またはパッケージ指定（デフォルト: latest） |
-GitDir <path> |
チェックアウトディレクトリ（デフォルト: %USERPROFILE%\openclaw） |
-NoOnboard |
オンボーディングをスキップ |
-NoGitUpdate |
git pull をスキップ |
-DryRun |
アクションのみを出力 |
環境変数リファレンス
| 変数 | 説明 |
|---|---|
OPENCLAW_INSTALL_METHOD=git|npm |
インストール方法 |
OPENCLAW_GIT_DIR=<path> |
チェックアウトディレクトリ |
OPENCLAW_NO_ONBOARD=1 |
オンボーディングをスキップ |
OPENCLAW_GIT_UPDATE=0 |
git pull を無効化 |
OPENCLAW_DRY_RUN=1 |
ドライランモード |
CI と自動化
予測可能な実行のため、非対話型のフラグ／環境変数を使用してください。
install.sh（非対話型 npm）
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboardinstall.sh（非対話型 git）
OPENCLAW_INSTALL_METHOD=git OPENCLAW_NO_PROMPT=1 \ curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bashinstall-cli.sh（JSON）
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclawinstall.ps1（オンボーディングをスキップ）
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboardトラブルシューティング
なぜ Git が必要なのですか？
Git は git インストール方式に必要です。npm インストールでも、依存関係が git URL を使用する場合の spawn git ENOENT エラーを回避するため、Git の確認とインストールが行われます。
Linux で npm に EACCES が発生するのはなぜですか？
一部の Linux 環境では、npm のグローバルプレフィックスが root 所有のパスを指しています。install.sh はプレフィックスを ~/.npm-global に切り替え、シェルの rc ファイルが存在する場合は PATH の export を追記できます。
Windows: 「npm error spawn git / ENOENT」
インストーラーを再実行してユーザーローカルの MinGit をブートストラップするか、Git for Windows をインストールして PowerShell を開き直してください。
Windows: 「openclaw is not recognized」
npm config get prefix を実行し、そのディレクトリをユーザーの PATH に追加して（Windows では \bin サフィックスは不要）、PowerShell を開き直してください。
Windows: インストーラーの詳細出力を取得する方法
install.ps1 は -Verbose スイッチを提供していません。
スクリプトレベルの診断には PowerShell トレースを使用してください。
Set-PSDebug -Trace 1& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboardSet-PSDebug -Trace 0インストール後に openclaw が見つからない
通常は PATH の問題です。Node.js のトラブルシューティングを参照してください。
