インストーラー内部詳細

OpenClaw は、openclaw.ai から提供される3つのインストーラースクリプトを同梱しています。

クイックコマンド

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

ℹ️ インストールが成功しても新しいターミナルで 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-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

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 git が使用され、Git がない場合、スクリプトは終了し、Git for Windows のリンクを表示します。

CI と自動化

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

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

トラブルシューティング

インストールDocker