Install overview
インストーラーの内部構造
OpenClaw には、openclaw.ai から配信される3つのインストーラースクリプトが付属しています。
| スクリプト | プラットフォーム | 実行内容 |
|---|---|---|
install.sh |
macOS / Linux / WSL | 必要に応じて Node をインストールし、npm（デフォルト）または git で OpenClaw をインストールします。オンボーディングも実行できます。 |
install-cli.sh |
macOS / Linux / WSL | npm または git を使用して、Node と OpenClaw をローカルプレフィックス（~/.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 を実行します。アップグレード時は可能であれば Plugin を更新し、プロンプトが有効なヘッドレス実行では手動コマンドを表示します。
--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 を検証します。
Linux ARMv7 では、公式の Node 24+ 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、続いて openclaw gateway restart を実行し、
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 のトラブルシューティングを参照してください。
