OpenClaw インストールガイド：環境構築を素早く完了させる方法

新しいツールを導入しようとした矢先に、複雑なセットアップ手順に阻まれるのはストレスが溜まります。環境変数の設定や依存関係の解決で時間を浪費せず、すぐに本題の開発に入りたいものです。

OpenClawは、こうしたセットアップの負担を減らすために、OSに合わせた専用のインストールスクリプトを用意しています。自分に合った方法を選んで、すぐに使い始めましょう。

必要なもの

インストールを始める前に、以下の環境を確認してください。

macOS, Linux, または WSL (Windows Subsystem for Linux)
Windows (PowerShell)

クイックスタート

5分以内に OpenClaw を使い始めるための最短ルートです。OSや用途に合わせて、以下のコマンドをターミナルで実行してください。

macOS / Linux / WSL の場合

標準的なインストールには install.sh を使用します。必要に応じて Node.js も一緒にインストールされ、オンボーディングまで実行できます。

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

ローカルディレクトリにインストールする場合（macOS / Linux / WSL）

root 権限を使わず、ローカルの ~/.openclaw に Node.js と OpenClaw をインストールしたい場合は、install-cli.sh が最適です。

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

Windows の場合

PowerShell を使用して install.ps1 を実行します。

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

特定のタグを指定したり、テスト実行（DryRun）をしたりする場合は、以下のようなオプションが利用可能です。

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

トラブルシューティング

セットアップ中に発生する可能性のある一般的な問題です。

問題: インストールは成功したはずなのに、新しいターミナルを開いても openclaw コマンドが見つからない。
解決策: Node.js troubleshooting のドキュメントを確認してください。

不明な点がある場合は、AI Setup Assistant でいつでも質問してください。

次のステップ

Node.js troubleshooting

開発環境のセットアップで、依存関係の解決やツールのバージョン管理に時間を取られてしまうのは非常にもったいないことです。新しいツールを試したいだけなのに、環境構築だけで力尽きてしまう経験は誰にでもあるはずです。

OpenClaw では、こうした面倒な作業を自動化するために `install.sh` を用意しています。このスクリプトを使えば、OS の判定から必要なランタイムの導入まで、すべてお任せで完了します。

## 必要なもの

このスクリプトを使用するには、以下の環境が必要です。

- macOS または Linux（WSL を含む）
- インターネット接続環境

## クイックスタート

最も推奨される方法は、以下のコマンドをターミナルで実行することです。5分もかからずに OpenClaw の利用準備が整います。

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

このスクリプトを実行すると、内部では以下のステップが自動で行われます。

OS の検出: macOS または Linux（WSL 含む）を判別します。macOS で Homebrew がない場合は自動でインストールを試みます。
Node.js 22+ の確認: バージョンをチェックし、必要であれば Node.js 22 をインストールします（macOS は Homebrew、Linux は NodeSource を使用）。
Git の確認: 未インストールの場合は Git を導入します。
OpenClaw のインストール: デフォルトでは npm によるグローバルインストールを行いますが、git メソッド（リポジトリのクローン、pnpm でのビルド、~/.local/bin/openclaw への配置）も選択可能です。
インストール後のタスク: openclaw doctor によるチェックや、必要に応じたオンボーディングの開始が行われます。

実行例とオプション

用途に合わせて、実行コマンドにフラグを渡すことができます。

オンボーディングをスキップする

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

Git 経由でインストールする

ソースコードからビルドしてインストールしたい場合に最適です。

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

実行内容を事前に確認する（Dry run）

実際の変更を加えずに、何が行われるかだけを表示します。

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

トラブルシューティング

インストール中に問題が発生した場合は、以下を確認してください。

メソッド選択のエラー: 無効なインストールメソッドを選択したり、--install-method に不正な値を指定したりすると、終了コード 2 で停止します。
非対話環境での挙動: TTY が利用できず、インストールメソッドも指定されていない場合、スクリプトは警告を表示した上でデフォルトの npm メソッドを選択します。
既存のチェックアウト: すでに OpenClaw のディレクトリ内（package.json と pnpm-workspace.yaml が存在）で実行した場合、既存のコードを使用するかグローバルインストールにするかを選択できます。

リファレンス

CLI Flags

Flag	Description
`--install-method npm\|git`	インストール方法の選択 (default: `npm`)。エイリアス: `--method`
`--npm`	npm メソッドを使用するショートカット
`--git`	git メソッドを使用するショートカット。エイリアス: `--github`
`--version <version\|dist-tag>`	npm のバージョンまたは dist-tag (default: `latest`)
`--beta`	利用可能な場合は beta タグを使用（なければ `latest`）
`--git-dir <path>`	クローン先のディレクトリ (default: `~/openclaw`)。エイリアス: `--dir`
`--no-git-update`	既存のチェックアウトに対して `git pull` を行わない
`--no-prompt`	プロンプトを表示しない
`--no-onboard`	オンボーディングをスキップする
`--onboard`	オンボーディングを強制的に有効にする
`--dry-run`	変更を適用せずに実行内容を表示する
`--verbose`	デバッグ出力を有効にする (`set -x`, npm notice-level logs)
`--help`	ヘルプを表示する (`-h`)

Environment Variables

Variable	Description
`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\|1`	git アップデートの切り替え
`OPENCLAW_NO_PROMPT=1`	プロンプトの無効化
`OPENCLAW_NO_ONBOARD=1`	オンボーディングのスキップ
`OPENCLAW_DRY_RUN=1`	Dry run モードの有効化
`OPENCLAW_VERBOSE=1`	デバッグモードの有効化
`OPENCLAW_NPM_LOGLEVEL=error\|warn\|notice`	npm のログレベル
`SHARP_IGNORE_GLOBAL_LIBVIPS=0\|1`	sharp/libvips の挙動制御 (default: `1`)

セットアップ中に不明な点があれば、AI Setup Assistant にいつでも質問してください。

次のステップ

---
title: "install-cli.sh で OpenClaw をスマートにセットアップする"
description: "システム環境を汚さずに OpenClaw CLI をローカルにインストールする方法を解説します。"
---

新しいツールを試すとき、システムの Node.js のバージョンを気にしたり、グローバル環境が散らかったりするのは避けたいものです。環境構築に時間を取られず、すぐに開発に取り掛かりたいと誰もが考えます。

OpenClaw の `install-cli.sh` は、こうしたセットアップの煩わしさを解消するために設計されています。

### What You'll Need

セットアップを始める前に、以下の環境を確認してください。

- `curl` コマンドが利用可能であること
- Linux または macOS の環境
- インストール先のディレクトリ（デフォルトは `~/.openclaw`）への書き込み権限
- インターネット接続

### Quick Start

もっとも簡単な方法は、デフォルト設定でスクリプトを実行することです。この方法は、システム全体の Node.js に依存したくない場合に特におすすめです。

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

このスクリプトを実行すると、以下の 4 つのプロセスが自動で行われます。

Node.js ランタイムのダウンロード: デフォルトでバージョン 22.22.0 を取得します。
整合性の検証: ダウンロードした Node.js の SHA-256 チェックサムを検証します。
Git の確認: Git が未インストールの場合は、OS に応じたツール（apt/dnf/yum/Homebrew）でインストールを試みます。
OpenClaw の配置: 指定された prefix 内にインストールし、bin/openclaw にラッパーを作成します。

カスタマイズ例

特定のディレクトリへのインストールや、自動化のワークフローに組み込む場合は以下の例を参考にしてください。

# カスタムパスと最新バージョンの指定
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix /opt/openclaw --version latest

# 自動化のための JSON 出力モード
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

Reference

Flags

Flag	Description
`--prefix <path>`	インストール先のパス (デフォルト: `~/.openclaw`)
`--version <ver>`	OpenClaw のバージョンまたは dist-tag (デフォルト: `latest`)
`--node-version <ver>`	Node.js のバージョン (デフォルト: `22.22.0`)
`--json`	NDJSON イベントを出力
`--onboard`	インストール後に `openclaw onboard` を実行
`--no-onboard`	オンボーディングをスキップ (デフォルト)
`--set-npm-prefix`	Linux で現在の prefix が書き込み不可の場合、npm prefix を `~/.npm-global` に強制設定
`--help`	ヘルプを表示 (`-h`)

Environment variables

Variable	Description
`OPENCLAW_PREFIX=<path>`	インストール先のパス
`OPENCLAW_VERSION=<ver>`	OpenClaw のバージョンまたは dist-tag
`OPENCLAW_NODE_VERSION=<ver>`	Node.js のバージョン
`OPENCLAW_NO_ONBOARD=1`	オンボーディングをスキップ
`OPENCLAW_NPM_LOGLEVEL=error\|warn\|notice`	npm のログレベル
`OPENCLAW_GIT_DIR=<path>`	以前の `Peekaboo` サブモジュールのチェックアウトを削除するための検索パス
`SHARP_IGNORE_GLOBAL_LIBVIPS=0\|1`	sharp/libvips の挙動を制御 (デフォルト: `1`)

Troubleshooting

インストール中に問題が発生した場合は、以下の解決策を試してください。

書き込み権限エラー: Linux 環境で指定した prefix に書き込めない場合は、--set-npm-prefix フラグを付けて実行してください。
古い構成のクリーンアップ: 以前のバージョンから移行する場合、OPENCLAW_GIT_DIR 環境変数を設定することで、古い Peekaboo サブモジュールの残骸を適切に処理できます。

不明な点がある場合は、AI Setup Assistant でいつでも質問してください。

What’s Next

```mdx
---
title: "Windows環境へのOpenClawインストール：install.ps1 の活用ガイド"
description: "PowerShellスクリプトを使用して、Windows環境にOpenClawを素早く、確実にセットアップする方法を解説します。"
---

Windowsでの開発環境のセットアップは、時に煩雑になりがちです。新しいツールを導入しようとするたびに、依存関係の確認や環境変数のパス設定を手動で行うのは、開発者にとって共通の悩みと言えるでしょう。

特に Node.js のバージョン管理や、グローバルパッケージのインストール先を気にするのは面倒な作業です。OpenClaw では、これらの工程を自動化し、数行のコマンドで環境を整えるための専用スクリプト `install.ps1` を用意しています。

## 必要なもの

セットアップを始める前に、以下の条件を確認してください。

- PowerShell 5以上
- Windows 環境
- Node.js 22以上（未インストールの場合は、スクリプトが winget、Chocolatey、Scoop の順でインストールを試行します）
- Git（`-InstallMethod git` を使用する場合のみ必須）

## クイックスタート

最も素早く OpenClaw を使い始めるには、デフォルトの `npm` 方式がおすすめです。PowerShell を開き、以下のコマンドを実行してください。

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

このスクリプトは以下のステップを自動で実行します。

環境チェック: PowerShell 5+ および Windows 環境であることを確認します。
Node.js の準備: Node.js 22以上がインストールされているか確認し、不足していれば自動インストールを試みます。
OpenClaw のインストール: デフォルトでは npm を使用してグローバルにインストールします。
事後設定: 必要に応じて PATH を追加し、アップグレード時には openclaw doctor --non-interactive を実行して状態を確認します。

Git を使用したインストール

ソースからビルドしたい場合や、最新のコードを追いたい場合は git 方式を選択できます。以下のコマンドでは、カスタムディレクトリを指定してインストールを行います。

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

この方法では、リポジトリがクローン（または更新）され、pnpm によるビルドが行われた後、%USERPROFILE%\.local\bin\openclaw.cmd にラッパーが作成されます。

その他の実行例

事前に実行内容を確認したい場合は、-DryRun フラグが便利です。

# 実行内容のシミュレーション
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -DryRun

オプション・設定リファレンス

CLI Flags

スクリプト実行時に指定できる引数の一覧です。

Flag	Description
`-InstallMethod npm\|git`	インストール方法 (デフォルト: `npm`)
`-Tag <tag>`	npm のディストリビューションタグ (デフォルト: `latest`)
`-GitDir <path>`	チェックアウト先ディレクトリ (デフォルト: `%USERPROFILE%\openclaw`)
`-NoOnboard`	オンボーディングをスキップ
`-NoGitUpdate`	`git pull` をスキップ
`-DryRun`	実際のインストールは行わず、アクションの表示のみ行う

環境変数

フラグの代わりに環境変数で動作を制御することも可能です。

Variable	Description
`OPENCLAW_INSTALL_METHOD=git\|npm`	インストール方法
`OPENCLAW_GIT_DIR=<path>`	チェックアウト先ディレクトリ
`OPENCLAW_NO_ONBOARD=1`	オンボーディングをスキップ
`OPENCLAW_GIT_UPDATE=0`	git pull を無効化
`OPENCLAW_DRY_RUN=1`	ドライランモード

トラブルシューティング

インストール中に問題が発生した場合は、以下の点を確認してください。

Git が見つからない: -InstallMethod git を指定しているにもかかわらず Git がインストールされていない場合、スクリプトは終了し、Git for Windows のダウンロードリンクを表示します。
Node.js のインストール失敗: 自動インストールが失敗した場合は、手動で Node.js 22 以上の環境を構築してから再試行してください。

セットアップに関する不明点がある場合は、こちらのツールも活用してください。 AI Setup Assistant

次のステップ

CI 環境でツールを動かすとき、対話型のプロンプトでビルドが止まってしまうのは避けたいですよね。手動でのセットアップはローカル開発では便利ですが、自動化ワークフローでは再現性と予測可能性が何よりも重要です。

パイプラインが入力待ちでハングアップしたり、環境によって挙動が変わったりする問題を防ぐために、非対話モードのフラグや環境変数を使うのがベストな方法です。

## 必要なもの

- Git（`git` インストール方式、または依存関係の解決に必要）
- npm（`npm` インストール方式を使用する場合）
- Linux または Windows 環境

## クイックスタート

OpenClaw を自動化環境でセットアップするための、5 分で終わる最小限の手順です。用途に合わせて以下のコマンドを選択してください。

### 1. npm を使用した非対話インストール
プロンプトとオンボーディングをスキップします。

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

2. Git を使用した非対話インストール

環境変数を使用してインストール方法を指定します。

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

3. CLI インストール（JSON 出力）

特定のディレクトリを指定し、結果を JSON で取得します。

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

4. Windows (PowerShell) でのセットアップ

オンボーディングをスキップして実行します。

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

トラブルシューティング

よくある問題と解決策をまとめました。

なぜ Git が必要なのですか？ git インストール方式では必須です。また npm インストールの場合も、依存関係に git URL が含まれている際の spawn git ENOENT エラーを避けるため、Git の有無をチェックし、必要に応じてインストールを行います。
Linux で npm が EACCES エラーになります 一部の Linux 設定では、npm のグローバルプレフィックスが root 所有のパスを指しています。install.sh は、プレフィックスを ~/.npm-global に切り替え、シェル設定ファイルに PATH のエクスポートを追記することで解決できます。
sharp/libvips の問題が発生します スクリプトはデフォルトで SHARP_IGNORE_GLOBAL_LIBVIPS=1 を設定し、システム上の libvips に対して sharp がビルドされるのを避けます。これを上書きするには以下のコマンドを使用してください。
Terminal window
```
SHARP_IGNORE_GLOBAL_LIBVIPS=0 curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
```
Windows で “npm error spawn git / ENOENT” と表示されます Git for Windows をインストールしてください。その後、PowerShell を開き直し、インストーラーを再実行してください。
Windows で “openclaw is not recognized” と表示されます npm config get prefix を実行してパスを確認し、末尾に \bin を追加したものをユーザーの PATH 環境変数に加えてください。設定後、PowerShell を再起動します。
インストール後に openclaw が見つかりません ほとんどの場合、PATH の設定に問題があります。Node.js troubleshooting を確認してください。

不明な点がある場合は、AI Setup Assistant に質問してください。

次のステップ

OpenClaw Expert

まだ解決しませんか？

このページで解決しない場合は、OpenClaw Expertに直接質問してください。