🇨🇳 简体中文 🇹🇼 繁體中文 🇯🇵 日本語 🇰🇷 한국어 🇮🇳 हिन्दी 🇧🇩 বাংলা 🇮🇩 Bahasa Indonesia 🇪🇸 Español 🇧🇷 Português 🇫🇷 Français 🇩🇪 Deutsch
ホーム / インストール

インストール

ゼロから OpenClaw をインストールしましょう。実はとても簡単です！以下の手順に沿って進めれば、5〜10 分ほどで完了します。各ステップで何をしているか丁寧に説明しますので、安心してくださいね。

📋 システム要件

インストールを始める前に、お使いのパソコンが以下の基本要件を満たしているか確認しましょう：

  • Node.js 22 以上 — OpenClaw を動かすための基盤環境です（ご安心ください、インストールスクリプトが自動でチェックします）
  • OS — macOS、Linux、または Windows（WSL2 が必要）
  • メモリ — 2GB 以上の空きメモリ
  • ディスク容量 — 500MB 以上の空き容量
  • ネットワーク — ダウンロードや AI モデル API の呼び出しにインターネット接続が必要です
ℹ️ Node.js とは？ 簡単に言うと、Node.js は「翻訳者」のようなもので、JavaScript で書かれたプログラムをパソコンで実行できるようにしてくれます。OpenClaw は JavaScript で書かれているため、Node.js が必要です。JavaScript を勉強する必要はありません。Node.js をインストールするだけで大丈夫です。
ℹ️ WSL2 とは？ Windows ユーザーの方はご注意ください。OpenClaw は Windows 上で直接動作するのではなく、WSL2（Windows Subsystem for Linux 2）が必要です。これは Windows の中にミニ Linux システムをインストールするようなものです。Windows をお使いの場合、インストールスクリプトが自動的に対応してくれます。

🌟 方法 1：ワンラインインストールスクリプト（初心者におすすめ！）

これが最も簡単なインストール方法です。ターミナルにコマンドを 1 行コピー＆ペーストするだけで、スクリプトがすべてを自動で行ってくれます。本当に簡単なので、手順通りに進めてみてください！

💡 「ターミナル」とは？ ターミナルは、テキストコマンドを入力できるウィンドウです。macOS では「ターミナル」（Terminal）、Windows では「PowerShell」や「コマンドプロンプト」と呼ばれています。パソコンで「Terminal」や「ターミナル」と検索すると見つかります。
1

ターミナルを開く

Command + スペース を押して「Terminal」と入力し、Enter を押してください。黒い（または白い）コマンドラインウィンドウが表示されます。

2

インストールコマンドをコピー＆ペースト

以下のコマンドをコピーして、ターミナルウィンドウに貼り付け、Enter を押してください：

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

このコマンドは以下のことを行います：

  • パソコンに Node.js がインストールされているか確認し、なければ自動でインストール
  • OpenClaw の最新版をダウンロードしてインストール
  • 初期設定ウィザード（onboarding）を実行し、基本設定をガイド
3

インストール完了を待つ

インストールには約 2〜5 分かかります（ネットワーク速度によります）。ターミナルにたくさんの文字がスクロールしますが、正常な動作ですので心配しないでください！インストールが完了すると、自動的に設定ウィザードが起動します。

1

ターミナルを開く

Linux では、Ctrl + Alt + T を押してターミナルを開くか、アプリケーションメニューで「Terminal」を検索してください。

2

インストールコマンドをコピー＆ペースト

macOS と同じく、以下のコマンドをコピーしてターミナルに貼り付け、Enter を押してください：

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

スクリプトが自動的に Node.js のチェック、OpenClaw のダウンロード・インストール、設定ウィザードの実行を行います。

3

インストール完了を待つ

数分間お待ちください。設定ウィザードのプロンプトが表示されれば、インストール成功です！

1

PowerShell を管理者として実行

スタートメニューで「PowerShell」を検索し、右クリックして「管理者として実行」を選択してください。インストールには管理者権限が必要なため、このステップは重要です。

2

インストールコマンドをコピー＆ペースト

Windows ユーザーは以下の専用コマンドを使用します：

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

このスクリプトは自動的に以下を行います：

  • WSL2 の確認と設定（未インストールの場合）
  • Node.js のインストール
  • OpenClaw のダウンロードとインストール
  • 初期設定ウィザードの実行
3

インストール完了を待つ

Windows でのインストールは少し時間がかかることがあります（WSL2 のインストールが必要な場合があるため）。約 5〜10 分ほどかかります。完了すると自動的に設定ウィザードが起動します。

⚠️ Windows ユーザーの方へ：WSL2 のインストール後にパソコンの再起動が必要になる場合があります。スクリプトが再起動を促した場合は、先に再起動してから、インストールコマンドを再度実行してください。

📦 方法 2：npm でインストール

Node.js と npm（Node.js のパッケージマネージャー）に慣れている方は、この方法でインストールできます。より細かいコントロールが可能です。

1

Node.js がインストール済みか確認

ターミナルを開いて、以下のコマンドで Node.js のバージョンを確認してください：

node --version

v22.x.x 以上が表示されれば準備完了です。インストールされていない場合やバージョンが古い場合は、まず nodejs.org から最新版をダウンロードしてインストールしてください。

2

npm で OpenClaw をグローバルインストール

ターミナルで以下を実行してください：

npm install -g openclaw@latest

コマンドの説明：

  • npm install — npm を使ってソフトウェアをインストール
  • -g — グローバルインストール。これにより、どこからでも openclaw コマンドが使えるようになります
  • openclaw@latest — OpenClaw の最新版をインストール
3

初期設定の実行とバックグラウンドサービスの登録

インストール完了後、以下を実行してください：

openclaw onboard --install-daemon

このコマンドは 2 つのことを行います：

  • onboard — 設定ウィザードを起動し、初期設定（AI モデルの選択、API キーの入力など）をガイドします
  • --install-daemon — OpenClaw をバックグラウンドサービス（daemon）として登録します。これにより、パソコン起動時に自動的に起動し、毎回手動で開く必要がなくなります
💡 daemon（デーモン）とは？ 簡単に言うと、バックグラウンドで静かに動作し続けるプログラムのことです。ウィンドウは表示されませんが、常に動作しています。--install-daemon を付けると、OpenClaw はバックグラウンドで静かに動作し、いつでもあなたのメッセージを待ち受けます。

🐳 方法 3：Docker でインストール

Docker（コンテナ化技術）がお好きな方や、OpenClaw を完全に隔離された環境で実行したい場合は、この方法がおすすめです。

ℹ️ Docker とは？ Docker は「仮想の箱」のようなもので、ソフトウェアをその中で実行できます。ソフトウェアに問題が起きても、パソコン本体には影響しません。Docker をご存知ない場合は、方法 1 か方法 2 でのインストールをおすすめします。
1

Docker がインストール済みか確認

Docker をまだインストールしていない場合は、docker.com から Docker Desktop をダウンロードしてインストールしてください。

2

OpenClaw Docker コンテナを起動

docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  ghcr.io/openclaw/openclaw:latest

このコマンドは OpenClaw の Docker イメージをダウンロードしてコンテナを起動します。-v パラメータで設定ファイルをパソコンにマッピングするため、データが失われることはありません。

✅ インストール後の確認

インストールが完了したら、すべてが正常に動作しているか確認しましょう。以下の手順に沿ってチェックしてください：

1

ヘルスチェックを実行

openclaw doctor

このコマンドは OpenClaw の「健康診断」のようなものです。必要なすべてのコンポーネントが正常に動作しているかチェックします。すべて正常であれば、緑色のチェックマークがたくさん表示されます。

2

実行状態を確認

openclaw status

このコマンドで OpenClaw が実行中かどうかを確認できます。「running」と表示されれば、すべて正常です！

3

Web コントロールパネルを開く

openclaw dashboard

このコマンドは自動的にブラウザを開き、OpenClaw の Web コントロールパネルにアクセスします。アドレスは：

http://127.0.0.1:18789/

このパネルでは、OpenClaw のすべての設定と状態を直感的に確認できます！

🎉 3 つのコマンドすべてでエラーが出なければ、おめでとうございます！OpenClaw のインストールは成功です！次は クイックスタート セクションで、使い方を学びましょう。

🛠️ よくあるインストールの問題

問題が起きても慌てないでください！インストール中によくある問題とその解決方法をまとめました：

問題 1：コマンドが見つからない（command not found: openclaw）

これは通常、PATH 環境変数の問題です。つまり、パソコンが openclaw コマンドの場所を知らないのです。

解決方法：

# openclaw のインストール場所を確認
which openclaw || npm list -g openclaw

# bash を使っている場合、パスを設定ファイルに追加
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# zsh を使っている場合（macOS のデフォルト）
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

問題 2：Node.js のバージョンが古い

「Node.js v18 is not supported」のようなエラーが表示された場合、Node.js のアップグレードが必要です。

解決方法：

# nvm（Node Version Manager）を使って Node.js のバージョンを管理
# まず nvm をインストール
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Node.js 22 をインストール
nvm install 22

# Node.js 22 に切り替え
nvm use 22

# バージョンを確認
node --version

問題 3：ポートの競合（EADDRINUSE）

「EADDRINUSE: address already in use :::18789」と表示された場合、ポート 18789 がすでに他のプログラムに使われています。

解決方法：

# ポート 18789 を使用しているプロセスを確認
lsof -i :18789

# 古い OpenClaw プロセスの場合、まず停止
openclaw stop

# その後、再起動
openclaw start

問題 4：権限不足（EACCES）

Linux/macOS で npm のグローバルインストール時に権限の問題が発生する場合があります。

解決方法：

# 方法 A：npm のグローバルインストールディレクトリを変更
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# その後、再インストール
npm install -g openclaw@latest
⚠️ 絶対に sudo npm install -g を使わないでください！ sudo を付ければ権限の問題は解決しますが、他のセキュリティ上の問題を引き起こす可能性があります。上記の方法で npm のグローバルインストールディレクトリを変更してください。

問題 5：ネットワークタイムアウト

ダウンロード速度が遅い、またはタイムアウトする場合は、ネットワークの問題かもしれません。

解決方法：

# npm のレジストリミラーを設定
npm config set registry https://registry.npmmirror.com

# その後、再インストール
npm install -g openclaw@latest