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 をインストールし、オンボーディングを実行できます。 |
クイックコマンド
- install.sh
- install-cli.sh
- install.ps1
インストールが成功したのに新しいターミナルで
openclaw が見つからない場合は、Node.js のトラブルシューティング を参照してください。install.sh
フロー (install.sh)
デフォルトで Node.js 24 を確保
Node バージョンを確認し、必要に応じて Node 24 をインストールします (macOS では Homebrew、Linux apt/dnf/yum では NodeSource セットアップスクリプト)。macOS では、インストーラが Node または Git に必要とする場合にのみ Homebrew がインストールされます。Node 22.19+ と 23.11+ は互換性のために引き続きサポートされます。
Alpine/musl Linux では、インストーラは NodeSource の代わりに apk パッケージを使用します。設定済みの Alpine リポジトリは、サポート対象の Node バージョンを提供している必要があります (執筆時点では Alpine 3.21 以降)。
OpenClaw をインストール
npmメソッド (デフォルト): グローバル npm インストールgitメソッド: リポジトリを clone/update し、pnpm で依存関係をインストールして build した後、~/.local/bin/openclawにラッパーをインストール
ソース checkout の検出
OpenClaw checkout (package.json + pnpm-workspace.yaml) 内で実行された場合、スクリプトは次を提示します。
- checkout (
git) を使用、または - グローバルインストール (
npm) を使用
npm になり警告します。
メソッド選択が無効、または --install-method の値が無効な場合、スクリプトはコード 2 で終了します。
例 (install.sh)
- デフォルト
- オンボーディングをスキップ
- Git インストール
- GitHub main checkout
- Dry run
- インストール後に検証
フラグリファレンス
フラグリファレンス
| フラグ | 説明 |
|---|---|
--install-method | --method npm|git | インストールメソッドを選択します (デフォルト: npm) |
--npm | npm メソッドのショートカット |
--git | --github | git メソッドのショートカット |
--version <version|dist-tag|spec> | npm バージョン、dist-tag、またはパッケージ spec (デフォルト: latest) |
--beta | 利用可能な場合は beta dist-tag を使用し、それ以外は latest にフォールバックします |
--git-dir | --dir <path> | checkout ディレクトリ (デフォルト: ~/openclaw) |
--no-git-update | 既存 checkout の git pull をスキップします |
--no-prompt | プロンプトを無効化します |
--no-onboard | オンボーディングをスキップします |
--onboard | オンボーディングを有効化します |
--verify | インストール後の smoke verify を実行します (--version、読み込まれている場合は Gateway health) |
--dry-run | 変更を適用せずにアクションを出力します |
--verbose | デバッグ出力を有効化します (set -x、npm notice-level ログ) |
--help | -h | 使用方法を表示します |
環境変数リファレンス
環境変数リファレンス
| 変数 | 説明 |
|---|---|
OPENCLAW_INSTALL_METHOD=git|npm | インストールメソッド |
OPENCLAW_VERSION=latest|next|<semver>|<spec> | npm バージョン、dist-tag、またはパッケージ spec |
OPENCLAW_BETA=0|1 | 利用可能な場合は beta を使用します |
OPENCLAW_HOME=<path> | OpenClaw state とデフォルト git/onboarding パスのベースディレクトリ |
OPENCLAW_GIT_DIR=<path> | checkout ディレクトリ |
OPENCLAW_GIT_UPDATE=0|1 | git update を切り替えます |
OPENCLAW_NO_PROMPT=1 | プロンプトを無効化します |
OPENCLAW_VERIFY_INSTALL=1 | インストール後の smoke verify を実行します |
OPENCLAW_NO_ONBOARD=1 | オンボーディングをスキップします |
OPENCLAW_DRY_RUN=1 | Dry run モード |
OPENCLAW_VERBOSE=1 | デバッグモード |
OPENCLAW_NPM_LOGLEVEL=error|warn|notice | npm ログレベル (デフォルト: error、npm の deprecation ノイズを隠します) |
install-cli.sh
すべてをローカルプレフィックス配下 (デフォルト
~/.openclaw) に置き、システム Node 依存関係を持たせたくない環境向けに設計されています。デフォルトでは npm インストールをサポートし、同じプレフィックスフロー配下で git-checkout インストールもサポートします。フロー (install-cli.sh)
ローカル Node runtime をインストール
pin されたサポート対象 Node LTS tarball (バージョンはスクリプトに埋め込まれ、独立して更新されます。デフォルト
22.22.0) を <prefix>/tools/node-v<version> にダウンロードし、SHA-256 を検証します。
Alpine/musl Linux では、Node が pin された runtime 用の互換 tarball を公開していないため、apk で nodejs と npm をインストールし、その runtime をプレフィックスラッパーパスにリンクします。Alpine リポジトリはサポート対象の Node バージョン (22.19+、23.11+、または 24+) を提供している必要があります。古いリポジトリが Node 20 または 21 しか提供していない場合は Alpine 3.21 以降を使用してください。プレフィックス配下に OpenClaw をインストール
npmメソッド (デフォルト): npm でプレフィックス配下にインストールし、その後<prefix>/bin/openclawにラッパーを書き込みますgitメソッド: checkout (デフォルト~/openclaw) を clone/update し、それでも<prefix>/bin/openclawにラッパーを書き込みます
例 (install-cli.sh)
- デフォルト
- カスタムプレフィックス + バージョン
- Git インストール
- 自動化 JSON 出力
- オンボーディングを実行
フラグリファレンス
フラグリファレンス
| フラグ | 説明 |
|---|---|
--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 バージョン（デフォルト: 22.22.0） |
--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）
デフォルトで Node.js 24 を確認
見つからない場合は、winget、Chocolatey、Scoop の順にインストールを試行します。利用可能なパッケージマネージャーがない場合、スクリプトは公式の Node.js 24 Windows zip を
%LOCALAPPDATA%\OpenClaw\deps\portable-node にダウンロードし、現在のプロセスとユーザー PATH に追加します。Node 22.19+ と 23.11+ は互換性のため引き続きサポートされます。OpenClaw をインストール
npm方式（デフォルト）: 選択した-Tagを使用してグローバル npm インストールを実行します。C:\などの保護されたフォルダーで開いたシェルでも動作するように、書き込み可能なインストーラー一時ディレクトリから起動しますgit方式: リポジトリをクローン/更新し、pnpm でインストール/ビルドして、%USERPROFILE%\.local\bin\openclaw.cmdにラッパーをインストールします。Git が見つからない場合、スクリプトは%LOCALAPPDATA%\OpenClaw\deps\portable-git配下にユーザーローカルの MinGit をブートストラップし、現在のプロセスとユーザー PATH に追加します。
インストール後タスク
- 可能な場合、必要な bin ディレクトリをユーザー PATH に追加します
- 読み込まれている gateway サービスをベストエフォートで更新します（
openclaw gateway install --forceの後に再起動） - アップグレードと git インストール時に
openclaw doctor --non-interactiveを実行します（ベストエフォート）
例（install.ps1）
- デフォルト
- Git インストール
- GitHub main チェックアウト
- カスタム git ディレクトリ
- ドライラン
フラグリファレンス
フラグリファレンス
| フラグ | 説明 |
|---|---|
-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（オンボーディングをスキップ）
トラブルシューティング
なぜ Git が必要ですか？
なぜ Git が必要ですか？
Git は
git インストール方式で必要です。npm インストールでも、依存関係が git URL を使用する場合の spawn git ENOENT エラーを避けるため、Git は引き続き確認/インストールされます。Linux で npm が EACCES になるのはなぜですか？
Linux で npm が EACCES になるのはなぜですか？
一部の Linux セットアップでは、npm のグローバルプレフィックスが root 所有のパスを指しています。
install.sh はプレフィックスを ~/.npm-global に切り替え、シェルの rc ファイルに PATH export を追記できます（それらのファイルが存在する場合）。Windows: "npm error spawn git / ENOENT"
Windows: "npm error spawn git / ENOENT"
インストーラーを再実行してユーザーローカルの MinGit をブートストラップするか、Git for Windows をインストールして PowerShell を再度開いてください。
Windows: "openclaw is not recognized"
Windows: "openclaw is not recognized"
npm config get prefix を実行し、そのディレクトリをユーザー PATH に追加してください（Windows では \bin サフィックスは不要です）。その後、PowerShell を再度開いてください。Windows: インストーラーの詳細出力を取得する方法
Windows: インストーラーの詳細出力を取得する方法
install.ps1 は -Verbose スイッチを公開していません。
スクリプトレベルの診断には PowerShell トレースを使用してください。インストール後に openclaw が見つからない
インストール後に openclaw が見つからない
通常は PATH の問題です。Node.js トラブルシューティングを参照してください。