Skip to main content
OpenClaw には、openclaw.ai から配布される 3 つのインストーラースクリプトがあります。
スクリプトプラットフォーム行うこと
install.shmacOS / Linux / WSL必要に応じて Node をインストールし、npm（デフォルト）または git 経由で OpenClaw をインストール。オンボーディングの実行も可能。
install-cli.shmacOS / Linux / WSLNode + OpenClaw をローカルプレフィックス（~/.openclaw）にインストール。ルート権限は不要。
install.ps1Windows (PowerShell)必要に応じて Node をインストールし、npm（デフォルト）または git 経由で OpenClaw をインストール。オンボーディングの実行も可能。

​
クイックコマンド

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

​
install.sh

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

​
フロー (install.sh)

1

OS の検出

macOS および Linux（WSL を含む）をサポート。macOS が検出され、Homebrew がない場合はインストールします。
2

Node.js 22+ の確保

Node のバージョンを確認し、必要に応じて Node 22 をインストールします（macOS では Homebrew、Linux の apt/dnf/yum では NodeSource セットアップスクリプトを使用）。
3

Git の確保

Git がない場合はインストールします。
4

OpenClaw のインストール

  • npm メソッド（デフォルト）：グローバル npm インストール
  • git メソッド：リポジトリをクローン/アップデートし、pnpm で依存関係をインストールしてビルドし、~/.local/bin/openclaw にラッパーをインストール
5

インストール後のタスク

  • アップグレード時および git インストール時には、openclaw doctor --non-interactive を可能な範囲で実行
  • 適切な場合（TTY が利用可能、オンボーディングが無効化されていない、ブートストラップ/設定チェックに合格した場合）にオンボーディングを試行
  • デフォルトで SHARP_IGNORE_GLOBAL_LIBVIPS=1 を設定

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

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
フラグ説明
--install-method npm|gitインストール方法の選択（デフォルト: npm）。エイリアス: --method
--npmnpm メソッドのショートカット
--gitgit メソッドのショートカット。エイリアス: --github
--version <version|dist-tag>npm バージョンまたは dist-tag（デフォルト: latest）
--beta利用可能な場合は beta dist-tag を使用。なければ latest
--git-dir <path>チェックアウトディレクトリ（デフォルト: ~/openclaw）。エイリアス: --dir
--no-git-update既存のチェックアウトに対する git pull をスキップ
--no-promptプロンプトを無効化
--no-onboardオンボーディングをスキップ
--onboardオンボーディングを有効化
--dry-run変更を適用せずにアクションを表示
--verboseデバッグ出力を有効化（set -x、npm notice レベルのログ）
--help使い方を表示 (-h)
変数説明
OPENCLAW_INSTALL_METHOD=git|npmインストール方法
OPENCLAW_VERSION=latest|next|<semver>npm バージョンまたは dist-tag
OPENCLAW_BETA=0|1利用可能な場合は beta を使用
OPENCLAW_GIT_DIR=<path>チェックアウトディレクトリ
OPENCLAW_GIT_UPDATE=0|1git アップデートの切り替え
OPENCLAW_NO_PROMPT=1プロンプトを無効化
OPENCLAW_NO_ONBOARD=1オンボーディングをスキップ
OPENCLAW_DRY_RUN=1ドライランモード
OPENCLAW_VERBOSE=1デバッグモード
OPENCLAW_NPM_LOGLEVEL=error|warn|noticenpm ログレベル
SHARP_IGNORE_GLOBAL_LIBVIPS=0|1sharp/libvips の動作制御（デフォルト: 1）

​
install-cli.sh

すべてをローカルプレフィックス（デフォルト ~/.openclaw）の下に置き、システム Node への依存を避けたい環境向けに設計されています。

​
フロー (install-cli.sh)

1

ローカル Node ランタイムのインストール

Node の tarball（デフォルト 22.22.0）を <prefix>/tools/node-v<version> にダウンロードし、SHA-256 を検証します。
2

Git の確保

Git がない場合は、Linux では apt/dnf/yum、macOS では Homebrew を介してインストールを試みます。
3

プレフィックス下への OpenClaw のインストール

--prefix <prefix> を使用して npm でインストールし、<prefix>/bin/openclaw にラッパーを書き込みます。

​
例 (install-cli.sh)

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash
フラグ説明
--prefix <path>インストールプレフィックス（デフォルト: ~/.openclaw）
--version <ver>OpenClaw バージョンまたは dist-tag（デフォルト: latest）
--node-version <ver>Node バージョン（デフォルト: 22.22.0）
--jsonNDJSON イベントを出力
--onboardインストール後に openclaw onboard を実行
--no-onboardオンボーディングをスキップ（デフォルト）
--set-npm-prefixLinux で、現在のプレフィックスが書き込み不可の場合、npm プレフィックスを ~/.npm-global に強制
--help使い方を表示 (-h)
変数説明
OPENCLAW_PREFIX=<path>インストールプレフィックス
OPENCLAW_VERSION=<ver>OpenClaw バージョンまたは dist-tag
OPENCLAW_NODE_VERSION=<ver>Node バージョン
OPENCLAW_NO_ONBOARD=1オンボーディングをスキップ
OPENCLAW_NPM_LOGLEVEL=error|warn|noticenpm ログレベル
OPENCLAW_GIT_DIR=<path>レガシーなクリーンアップ用検索パス（古い Peekaboo サブモジュールの削除時に使用）
SHARP_IGNORE_GLOBAL_LIBVIPS=0|1sharp/libvips の動作制御（デフォルト: 1）

​
install.ps1

​
フロー (install.ps1)

1

PowerShell + Windows 環境の確保

PowerShell 5 以上が必要。
2

Node.js 22+ の確保

ない場合は、winget、次に Chocolatey、次に Scoop を介してインストールを試みます。
3

OpenClaw のインストール

  • npm メソッド（デフォルト）：選択された -Tag を使用したグローバル npm インストール
  • git メソッド：リポジトリをクローン/アップデートし、pnpm でインストール/ビルド。%USERPROFILE%\.local\bin\openclaw.cmd にラッパーをインストール
4

インストール後のタスク

必要に応じて bin ディレクトリをユーザー PATH へ追加し、アップグレード時および git インストール時には openclaw doctor --non-interactive を可能な範囲で実行します。

​
例 (install.ps1)

iwr -useb https://openclaw.ai/install.ps1 | iex
フラグ説明
-InstallMethod npm|gitインストール方法（デフォルト: npm）
-Tag <tag>npm dist-tag（デフォルト: latest）
-GitDir <path>チェックアウトディレクトリ（デフォルト: %USERPROFILE%\openclaw）
-NoOnboardオンボーディングをスキップ
-NoGitUpdategit pull をスキップ
-DryRunアクションのみを表示
変数説明
OPENCLAW_INSTALL_METHOD=git|npmインストール方法
OPENCLAW_GIT_DIR=<path>チェックアウトディレクトリ
OPENCLAW_NO_ONBOARD=1オンボーディングをスキップ
OPENCLAW_GIT_UPDATE=0git pull を無効化
OPENCLAW_DRY_RUN=1ドライランモード
-InstallMethod git が使用され、Git がない場合、スクリプトは終了し、Git for Windows のリンクを表示します。

​
CI と自動化

予測可能な実行のために、非対話型フラグ/環境変数を使用してください。 
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboard

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

git インストール方法には Git が必要です。npm インストールでも、依存関係が git URL を使用している場合の spawn git ENOENT エラーを避けるために Git がチェック/インストールされます。
一部の Linux セットアップでは、npm のグローバルプレフィックスが root 所有のパスを指しています。install.sh はプレフィックスを ~/.npm-global に切り替え、シェルの rc ファイル（存在する場合）に PATH の export を追記できます。
スクリプトは、sharp がシステムの libvips に対してビルドされるのを避けるため、デフォルトで SHARP_IGNORE_GLOBAL_LIBVIPS=1 を設定します。これを上書きするには：
SHARP_IGNORE_GLOBAL_LIBVIPS=0 curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
Git for Windows をインストールし、PowerShell を開き直し、インストーラーを再実行してください。
npm config get prefix を実行し、そのディレクトリをユーザー PATH に追加し（Windows では \bin サフィックスは不要）、PowerShell を開き直してください。
install.ps1 には現在 -Verbose スイッチはありません。 スクリプトレベルの診断には PowerShell のトレースを使用してください：
Set-PSDebug -Trace 1
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Set-PSDebug -Trace 0
通常は PATH の問題です。Node.js のトラブルシューティング を参照してください。