OpenClaw 完全インストールガイド：環境準備から初回実行まで

正直に言うと、最初にOpenClawの話を聞いた時は少し身構えました。「また新しいAIツール？インストール面倒なんじゃないの？環境構築に変な依存関係とか…」ところが実際にやってみると、想像よりも遥かにスムーズでした。

この記事では、コマンドラインにあまり慣れていない方でも、Mac、Linux、Windowsを問わず迷わずに導入できるよう、私のインストール体験に基づいたガイドを共有します。

そもそもOpenClawとは？

インストールの前に少しだけおさらいしましょう。簡単に言うと、ChatGPTやClaudeのような大規模言語モデル（LLM）を、TelegramやWhatsAppのような使い慣れたチャットツールに接続するためのオープンソースプラットフォームです。

なぜWeb版のAIをそのまま使わないのか？
ローカルにインストールするメリットはここにあります：

データとプライバシーを自分で管理できる
独自の機能やスキルを追加・開発できる
AIを自分のワークフローに直接組み込める
（その気になれば）完全ローカルのモデルを使ってクラウド依存をゼロにできる

私にとってのキラー機能は、TelegramにAIを常駐させられることでした。アプリを切り替えずに会話の中でAIを呼び出せるのは本当に便利です。

準備編：システムチェック

OpenClawのシステム要件は比較的緩やかですが、いくつか必須条件があります。

OSの互換性

OpenClawはmacOSとLinuxをネイティブサポートしています。Windowsユーザーの場合は、WSL2（Windows Subsystem for Linux）の導入が必要です。

WSL2はWindows内で軽量なLinux環境を動かす仕組みです。PowerShellを（管理者権限で）開き、以下のコマンド1行でインストールできます：

wsl --install

インストール完了後、PCを再起動し、再度PowerShellで wsl と入力すればLinux環境に入れます。

ハードウェア要件

そこまでハイスペックである必要はありません。

メモリ：8GBあれば足りますが、16GB推奨です。
ストレージ：20GB程度の空き容量（SSD推奨）。

ブラウザが普通に動くPCなら、OpenClawも問題なく動くはずです。私は8GBメモリの古いMacBookでもスムーズに動作しています。

Node.js環境

これが最も重要です。OpenClawはNode.js製なので、バージョン22以上が必須です。

もしカスタムスキルを開発する予定なら、Node.js 24+が推奨されます（最新のJS機能を使うため）。

macOSでのインストール

Homebrewを使うのが一番簡単です：

# Homebrew未導入の場合
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Node.jsをインストール
brew install node

Linux (およびWSL2) でのインストール

バージョン管理が楽な nvm (Node Version Manager) の利用を強くお勧めします：

# nvmのインストール
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# シェル再起動後、Node.js 22をインストール
nvm install 22
nvm use 22

インストール後、バージョンを確認しましょう：

node --version

v22.x.x 以上と表示されればOKです。

パッケージマネージャ：npm vs pnpm

Node.jsを入れると自動でついてくる npm で問題ありません。
もしディスク容量の節約や速度を重視するなら pnpm も良い選択肢です。

pnpm を入れたい場合：

npm install -g pnpm

OpenClawのインストール

準備ができたら、いよいよインストールです。いくつか方法がありますが、推奨順に紹介します。

方法1：公式インストールスクリプト（推奨）

これが一番確実で簡単です。

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

このスクリプトは以下の処理を自動で行います：

システム環境のチェック
必要な依存ライブラリのインストール
OpenClaw CLIのダウンロードと配置
初期設定への誘導

回線速度にもよりますが、1〜2分で終わります。

方法2：npmグローバルインストール

パッケージマネージャ経由で入れたい場合はこちら：

npm install -g openclaw@latest

@latest をつけることで確実に最新版が入ります。インストール後、コマンドラインで openclaw が使えるようになります。

方法3：ソースからビルド（上級者向け）

開発に参加したい場合などはGitHubからクローンします：

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build

通常利用ならここは読み飛ばしてOKです。

初期設定：Onboardウィザード

インストールしただけではまだ使えません。初期設定を行いましょう。

Onboardコマンドの実行

以下のコマンドを入力します：

openclaw onboard --install-daemon

--install-daemon オプションをつけると、OpenClawをシステムサービスとして登録し、PC起動時に自動で立ち上がるようにしてくれます。

ウィザードが始まり、いくつか質問されます：

1. 動作モードの選択

通常はLocal gateway（ローカルモード）を選びます。

2. AIモデルの設定

使用するAIプロバイダーを選びます：

OpenAI (GPT-4等)
Anthropic (Claude等)
Local Models

APIキーを持っている場合はここで入力します。まだキーがない場合はスキップして後で設定も可能です。
（キーの取得は各社公式サイト platform.openai.com / console.anthropic.com から）

3. 作業ディレクトリ

設定ファイルやデータの保存場所です。デフォルトの ~/.openclaw/ で問題ありません。

4. メッセージチャンネルの接続

TelegramやWhatsAppと連携するか聞かれます。

Telegram：Telegramアプリで @BotFather を検索し、/newbot でボットを作成してトークンを取得します。
Webのみ：とりあえずWeb画面だけで試したい場合はスキップできます。

5. デーモンのインストール

最後に確認されます。「はい」を選ぶとバックグラウンドで常駐するようになります。

全部で5〜10分程度で完了します。

手動設定（オプション）

もし後から設定を変えたい場合は、設定ファイルを直接編集できます：

nano ~/.openclaw/openclaw.json

初回起動と確認

Gatewayの起動

デーモンとしてインストールしなかった場合は、手動で起動します：

openclaw gateway --port 18789

成功すると以下のように表示されます：

✓ OpenClaw Gateway started on http://localhost:18789

Webインターフェースへアクセス

ブラウザで http://localhost:18789 を開いてみてください。

管理画面が表示されれば成功です！

Chat：動作テスト用チャット
Agents：AIエージェントの管理
Skills：機能（スキル）の追加・設定
Settings：全体設定

会話テスト

Chat画面で「こんにちは」「自己紹介して」と送ってみましょう。返信が来れば、あなた専用のAIアシスタントの誕生です！

トラブルシューティング

よくあるトラブルと解決策です。

Node.jsバージョンエラー

症状：Node version incompatible といったエラーが出る。
解決：node -v で確認。22未満ならアップグレードしてください。

Windows (WSL2) でのエラー

症状：インストールが進まない。
解決：wsl --update でWSL自体を更新してみてください。必ずWindows側ではなくWSL側（Ubuntuなどのターミナル）でコマンドを実行してください。

APIキーエラー

症状：AIが応答しない、エラーログが出る。
解決：キーのコピペミス（余計なスペースなど）がないか、残高があるか（OpenAIなどはプリペイドの場合があります）確認してください。

ポート競合

症状：起動時に Port 18789 is already in use と言われる。
解決：別のアプリが使っている可能性があります。ポートを変えて起動しましょう：

openclaw gateway --port 18790

セキュリティに関する注意

ポート開放厳禁：デフォルトの18789ポートはローカルホスト（あなたのPC）からのみアクセスできるようにしてください。ルーター等でポート開放してしまうと、誰でもあなたのAIを使えてしまいます。
APIキー管理：openclaw.json や .env ファイルにはAPIキーが含まれます。絶対に他人に渡したり、公開リポジトリにアップしないでください。
リモートアクセス：外出先から使いたい場合は、SSHトンネルやVPNを使用してください。

最後に

ここまでの手順をまとめます。

OpenClaw クイックインストール

ゼロからOpenClawをセットアップする手順

⏱️ Estimated time: 10 min

1
Step1: 環境準備
Node.js 22+ をインストール (MacはBrew, Linux/Winはnvm推奨)。システム要件を確認。
2
Step2: コアインストール
公式スクリプトを実行：
curl -fsSL https://openclaw.ai/install.sh | bash
3
Step3: 初期設定
onboardウィザードを実行：
openclaw onboard --install-daemon
4
Step4: サービス起動
デーモン未インストールの場合は手動起動：
openclaw gateway
http://localhost:18789 にアクセスして確認。

次は、Skillストアから機能を追加したり、Telegram連携を試してみたりして、自分好みにカスタマイズしていきましょう。最初は難しく感じるかもしれませんが、一度動けばとても強力な相棒になってくれます。

困ったときはGitHubのIssuesを覗いてみてください。コミュニティが助けになるはずです。それでは、良いAIライフを！

参考リンク

FAQ

Node.jsのバージョンが合わない場合は？

node -v コマンドで確認し、必ずバージョン22以上が必要です。nvmを使って nvm install 22 && nvm use 22 とするのが最も簡単な解決策です。

Windowsでインストールエラーが出ます。

必ずWSL2（wsl --install）環境下で実行してください。PowerShellやコマンドプロンプトではなく、WSL（Ubuntu）のターミナルで作業する必要があります。

API Keyを設定したのに動きません。

1. キーの前後にスペースが入っていないか確認。
2. APIアカウントの残高（クレジット）があるか確認（OpenAIなどは有料です）。
3. キーを再生成して再設定を試してください。

ポート18789が使われていると言われます。

lsof -i :18789 で占有しているプロセスを探して終了するか、openclaw gateway --port 18790 のように別のポートを指定して起動してください。

4 min read · 公開日: 2026年2月5日 · 更新日: 2026年2月5日

Easton

AI・インテリジェンス