インストーラーの内部構造

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
install-cli.sh
install.ps1

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 -- --help

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 -- --help

iwr -useb https://openclaw.ai/install.ps1 | iex

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta -NoOnboard -DryRun

インストールに成功しても、新しいターミナルで openclaw が見つからない場合は、Node.js のトラブルシューティングを参照してください。

install.sh

macOS/Linux/WSL でのほとんどの対話型インストールに推奨されます。

フロー（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-onboard

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

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

すべてをローカルプレフィックス（デフォルトは ~/.openclaw）配下に配置し、システムの Node に依存させたくない環境向けに設計されています。デフォルトでは npm インストールをサポートし、同じプレフィックスフローで git チェックアウトからのインストールにも対応します。

フロー（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）

デフォルト
カスタムプレフィックス + バージョン
Git インストール
自動化用 JSON 出力
オンボーディングを実行

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 latest

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --install-method git --git-dir ~/openclaw

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`）

openclaw@main およびその他の GitHub ソース指定は、npm インストールの有効な --version ターゲットではありません。代わりに --install-method git --version main を使用してください。

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）

デフォルト
Git インストール
GitHub main チェックアウト
カスタム git ディレクトリ
ドライラン

iwr -useb https://openclaw.ai/install.ps1 | iex

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git -Tag main

& ([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`	ドライランモード

-InstallMethod git を使用していて Git が見つからない場合、スクリプトは Git for Windows のリンクを表示する前に、ユーザーローカルの MinGit のブートストラップを試みます。

CI と自動化

予測可能な実行のため、非対話型のフラグ／環境変数を使用してください。

install.sh（非対話型 npm）
install.sh（非対話型 git）
install-cli.sh（JSON）
install.ps1（オンボーディングをスキップ）

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboard

OPENCLAW_INSTALL_METHOD=git OPENCLAW_NO_PROMPT=1 \
  curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw

& ([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))) -NoOnboard
Set-PSDebug -Trace 0

インストール後に openclaw が見つからない

通常は PATH の問題です。Node.js のトラブルシューティングを参照してください。

Install overview

Maintenance

Containers

Hosting

Advanced setup

インストーラーの内部構造

クイックコマンド

install.sh

フロー（install.sh）

ソースチェックアウトの検出

例（install.sh）

install-cli.sh

フロー（install-cli.sh）

例（install-cli.sh）

install.ps1

フロー（install.ps1）

例（install.ps1）

CI と自動化

トラブルシューティング

関連項目

​クイックコマンド

​install.sh

​フロー（install.sh）

​ソースチェックアウトの検出

​例（install.sh）

​install-cli.sh

​フロー（install-cli.sh）

​例（install-cli.sh）

​install.ps1

​フロー（install.ps1）

​例（install.ps1）

​CI と自動化

​トラブルシューティング

​関連項目

クイックコマンド

install.sh

フロー（install.sh）

ソースチェックアウトの検出

例（install.sh）

install-cli.sh

フロー（install-cli.sh）

例（install-cli.sh）

install.ps1

フロー（install.ps1）

例（install.ps1）

CI と自動化

トラブルシューティング

関連項目