インストーラーの内部動作
OpenClawは、openclaw.aiから配信される3つのインストーラスクリプトを提供しています。
| Script | Platform | 役割 |
|---|---|---|
install.sh | macOS / Linux / WSL | 必要に応じてNodeをインストールし、npm（デフォルト）またはgit経由でOpenClawをインストールし、オンボーディングを実行できます。 |
install-cli.sh | macOS / Linux / WSL | Node + OpenClawをローカルprefix（~/.openclaw）にnpmまたはgit checkoutモードでインストールします。rootは不要です。 |
install.ps1 | Windows (PowerShell) | 必要に応じてNodeをインストールし、npm（デフォルト）またはgit経由でOpenClawをインストールし、オンボーディングを実行できます。 |
クイックコマンド
- install.sh
- install-cli.sh
- install.ps1
インストールは成功したが新しいターミナルで
openclawが見つからない場合は、Node.js troubleshootingを参照してください。install.sh
フロー（install.sh）
デフォルトでNode.js 24を確保する
Nodeバージョンを確認し、必要ならNode 24をインストールします（macOSではHomebrew、Linuxではapt/dnf/yum向けNodeSourceセットアップスクリプト）。OpenClawは互換性のため、現在
22.14+のNode 22 LTSも引き続きサポートしています。OpenClawをインストールする
npmメソッド（デフォルト）: グローバルnpmインストールgitメソッド: リポジトリをclone/updateし、pnpmで依存関係をインストールし、ビルドしてから、~/.local/bin/openclawにラッパーをインストール
ソースcheckoutの検出
OpenClaw checkout内（package.json + pnpm-workspace.yaml）で実行した場合、スクリプトは次を提案します:
- checkoutを使う（
git）、または - グローバルインストールを使う（
npm）
npmを使用し、警告を表示します。
スクリプトは、無効なメソッド選択または無効な--install-method値に対して終了コード2で終了します。
例（install.sh）
- デフォルト
- オンボーディングをスキップ
- gitインストール
- npm経由でGitHub main
- ドライラン
フラグリファレンス
フラグリファレンス
| Flag | 説明 |
|---|---|
--install-method npm|git | インストール方法を選択（デフォルト: npm）。別名: --method |
--npm | npmメソッドのショートカット |
--git | gitメソッドのショートカット。別名: --github |
--version <version|dist-tag|spec> | npmバージョン、dist-tag、またはpackage spec（デフォルト: latest） |
--beta | 利用可能ならbeta dist-tagを使用し、なければlatestにフォールバック |
--git-dir <path> | checkoutディレクトリ（デフォルト: ~/openclaw）。別名: --dir |
--no-git-update | 既存checkoutのgit pullをスキップ |
--no-prompt | プロンプトを無効化 |
--no-onboard | オンボーディングをスキップ |
--onboard | オンボーディングを有効化 |
--dry-run | 変更を適用せず、実行内容のみ表示 |
--verbose | デバッグ出力を有効化（set -x、npmのnotice-levelログ） |
--help | 使い方を表示（-h） |
環境変数リファレンス
環境変数リファレンス
| Variable | 説明 |
|---|---|
OPENCLAW_INSTALL_METHOD=git|npm | インストール方法 |
OPENCLAW_VERSION=latest|next|main|<semver>|<spec> | npmバージョン、dist-tag、またはpackage spec |
OPENCLAW_BETA=0|1 | 利用可能ならbetaを使用 |
OPENCLAW_GIT_DIR=<path> | checkoutディレクトリ |
OPENCLAW_GIT_UPDATE=0|1 | git updateの有効/無効 |
OPENCLAW_NO_PROMPT=1 | プロンプトを無効化 |
OPENCLAW_NO_ONBOARD=1 | オンボーディングをスキップ |
OPENCLAW_DRY_RUN=1 | ドライランモード |
OPENCLAW_VERBOSE=1 | デバッグモード |
OPENCLAW_NPM_LOGLEVEL=error|warn|notice | npmログレベル |
SHARP_IGNORE_GLOBAL_LIBVIPS=0|1 | sharp/libvipsの動作を制御（デフォルト: 1） |
install-cli.sh
すべてをローカルprefix
（デフォルト
~/.openclaw）配下に置き、システムNode依存を避けたい環境向けに設計されています。デフォルトでnpmインストールをサポートし、同じprefixフロー内でgit-checkoutインストールもサポートします。フロー（install-cli.sh）
ローカルNodeランタイムをインストールする
固定されたサポート対象のNode LTS tarball（バージョンはスクリプト内に埋め込まれ、独立して更新される）を
<prefix>/tools/node-v<version>へダウンロードし、SHA-256を検証します。prefix配下にOpenClawをインストールする
npmメソッド（デフォルト）: prefix配下にnpmでインストールし、その後<prefix>/bin/openclawにラッパーを書き込むgitメソッド: checkoutをclone/updateし（デフォルト~/openclaw）、やはり<prefix>/bin/openclawにラッパーを書き込む
例（install-cli.sh）
- デフォルト
- カスタムprefix + バージョン
- gitインストール
- 自動化向けJSON出力
- オンボーディングを実行
フラグリファレンス
フラグリファレンス
| Flag | 説明 |
|---|---|
--prefix <path> | インストールprefix（デフォルト: ~/.openclaw） |
--install-method npm|git | インストール方法を選択（デフォルト: npm）。別名: --method |
--npm | npmメソッドのショートカット |
--git, --github | gitメソッドのショートカット |
--git-dir <path> | Git checkoutディレクトリ（デフォルト: ~/openclaw）。別名: --dir |
--version <ver> | OpenClawバージョンまたはdist-tag（デフォルト: latest） |
--node-version <ver> | Nodeバージョン（デフォルト: 22.22.0） |
--json | NDJSONイベントを出力 |
--onboard | インストール後にopenclaw onboardを実行 |
--no-onboard | オンボーディングをスキップ（デフォルト） |
--set-npm-prefix | Linuxで、現在のprefixが書き込み不可ならnpm prefixを~/.npm-globalへ強制設定 |
--help | 使い方を表示（-h） |
環境変数リファレンス
環境変数リファレンス
| Variable | 説明 |
|---|---|
OPENCLAW_PREFIX=<path> | インストールprefix |
OPENCLAW_INSTALL_METHOD=git|npm | インストール方法 |
OPENCLAW_VERSION=<ver> | OpenClawバージョンまたはdist-tag |
OPENCLAW_NODE_VERSION=<ver> | Nodeバージョン |
OPENCLAW_GIT_DIR=<path> | gitインストール時のGit checkoutディレクトリ |
OPENCLAW_GIT_UPDATE=0|1 | 既存checkoutのgit updateの有効/無効 |
OPENCLAW_NO_ONBOARD=1 | オンボーディングをスキップ |
OPENCLAW_NPM_LOGLEVEL=error|warn|notice | npmログレベル |
SHARP_IGNORE_GLOBAL_LIBVIPS=0|1 | sharp/libvipsの動作を制御（デフォルト: 1） |
install.ps1
フロー（install.ps1）
デフォルトでNode.js 24を確保する
存在しない場合、winget、次にChocolatey、次にScoop経由でのインストールを試みます。互換性のため、現在
22.14+のNode 22 LTSも引き続きサポートされています。OpenClawをインストールする
npmメソッド（デフォルト）: 選択した-Tagを使ってグローバルnpmインストールgitメソッド: リポジトリをclone/updateし、pnpmでインストール/ビルドし、%USERPROFILE%\.local\bin\openclaw.cmdにラッパーをインストール
例（install.ps1）
- デフォルト
- gitインストール
- npm経由でGitHub main
- カスタムgitディレクトリ
- ドライラン
- デバッグトレース
フラグリファレンス
フラグリファレンス
| Flag | 説明 |
|---|---|
-InstallMethod npm|git | インストール方法（デフォルト: npm） |
-Tag <tag|version|spec> | npm dist-tag、バージョン、またはpackage spec（デフォルト: latest） |
-GitDir <path> | checkoutディレクトリ（デフォルト: %USERPROFILE%\openclaw） |
-NoOnboard | オンボーディングをスキップ |
-NoGitUpdate | git pullをスキップ |
-DryRun | 実行内容のみ表示 |
環境変数リファレンス
環境変数リファレンス
| Variable | 説明 |
|---|---|
OPENCLAW_INSTALL_METHOD=git|npm | インストール方法 |
OPENCLAW_GIT_DIR=<path> | checkoutディレクトリ |
OPENCLAW_NO_ONBOARD=1 | オンボーディングをスキップ |
OPENCLAW_GIT_UPDATE=0 | git pullを無効化 |
OPENCLAW_DRY_RUN=1 | ドライランモード |
-InstallMethod gitを使用し、かつGitが存在しない場合、スクリプトは終了してGit for Windowsへのリンクを表示します。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のグローバルprefixがroot所有パスを指しています。
install.shは、prefixを~/.npm-globalへ切り替え、シェルrcファイルが存在する場合はPATH exportを追記できます。sharp/libvipsの問題
sharp/libvipsの問題
Windows: "npm error spawn git / ENOENT"
Windows: "npm error spawn git / ENOENT"
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 troubleshootingを参照してください。