OpenClawのインストールガイド

新しいツールを導入する際、環境構築でつまずくのは一番避けたいことです。依存関係の解決に時間を取られたり、ランタイムのバージョン管理で混乱したりするのは、開発者にとって大きなストレスになります。OpenClawは、そうした手間を最小限に抑え、すぐに開発に取り掛かれるように設計されています。

必要なもの

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

• Node 22+（インストーラースクリプトを使用する場合は、自動でインストールされます）
• macOS, Linux, または Windows
• WSL2（Windows環境で実行する場合は、強く推奨します）
• pnpm（ソースからビルドする場合のみ必要です）

クイックスタート

最もおすすめの方法は、インストーラースクリプトを使用することです。Node.jsの検出からインストール、オンボーディングまでをワンステップで行います。

macOS / Linux / WSL2:

curl -fsSL https://openclaw.ai/install.sh | bash

Windows (PowerShell):

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

これで完了です。スクリプトが自動的に Node.js の確認とセットアップを進めます。もしオンボーディングをスキップしてバイナリのみをインストールしたい場合は、以下のフラグを使用してください。

macOS / Linux / WSL2:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

Windows (PowerShell):

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

トラブルシューティング

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

openclaw コマンドが見つからない

PATHの設定に問題がある可能性があります。以下のコマンドで診断してください。

node -v
npm -v
npm prefix -g
echo "$PATH"

$(npm prefix -g)/bin（macOS/Linux）または $(npm prefix -g)（Windows）が PATH に含まれていない場合は、シェルの設定ファイル（~/.zshrc や ~/.bashrc）に以下を追加します。

export PATH="$(npm prefix -g)/bin:$PATH"

sharp のビルドエラー

macOSなどで libvips が原因で sharp のインストールに失敗する場合は、以下の環境変数を使用してプリビルドされたバイナリの使用を強制してください。

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

インストール後の確認

正常にインストールされたか確認するために、以下のコマンドを実行してみましょう。

• openclaw doctor: 設定の問題をチェックします
• openclaw status: Gateway の状態を確認します
• openclaw dashboard: ブラウザ UI を開きます
• openclaw onboard --install-daemon: 必要に応じてデーモンをインストールします

セットアップで困ったことがあれば、AI Setup Assistant がいつでもサポートします。

次のステップ

さらに詳細な設定や、他のプラットフォームでの運用については以下のドキュメントを参照してください。

• Dockerでのインストール
• Nixでの宣言的インストール
• Ansibleによる自動プロビジョニング
• BunでのCLI利用
• アップデート手順
• データの移行方法
• アンインストール
• インストーラーの内部仕様