OpenClawのインストール方法

OpenClawとは

OpenClaw は、オープンソースでセルフホスト可能な個人向け AI アシスタントプラットフォームです。WhatsApp、Telegram、Discord、Slack、iMessage など、普段使い慣れたチャットツールと各種 AI モデルを接続し、どのチャット画面からでも直接 AI と会話できるようにしてくれます。GitHub では10万以上のスターを獲得しており、コミュニティも非常に活発です。

自分専用の AI アシスタントがほしいけれど、特定のプラットフォームに縛られたくない――そんな方にとって、OpenClaw は現時点で最も試す価値のあるソリューションの一つです。この記事では、ゼロから使える状態にするまでのインストール手順をすべてご案内します。

システム要件

作業を始める前に、以下の条件を満たしていることを確認してください。

Node.js 22 以上：OpenClaw は比較的新しい Node.js の機能に依存しており、22 が最低バージョンです。
OS：macOS、Linux、または Windows（macOS か Linux を推奨）。
ネットワーク接続：インストール時に npm リポジトリから依存パッケージをダウンロードします。

現在の Node.js バージョンを確認するには、以下を実行します。

node -v

バージョンが 22 未満の場合は、nvm を使ってアップグレードしてください。

nvm install 22
nvm use 22

nvm をまだインストールしていない場合は、nvm 公式リポジトリの手順を参照してください。Windows ユーザーは nvm-windows が利用できます。

npmでOpenClawをインストールする

Node.js の準備が整ったら、npm でグローバルインストールします。

npm install -g openclaw@latest

インストールが完了したら、正しく入ったか確認しましょう。

openclaw --version

バージョン番号が表示されれば、インストールは完了です。

macOS ユーザーは Homebrew でもインストールできます。

brew install openclaw

初期設定ウィザードを実行する

OpenClaw には、初回セットアップを素早く完了するためのインタラクティブな onboard ウィザードが用意されています。以下のコマンドで起動してください。

openclaw onboard

ウィザードでは次のステップが案内されます。

AI モデルプロバイダーの選択：Anthropic Claude、OpenAI、Ollama（ローカルモデル）、Gemini、OpenRouter などから選べます。API キーをまだ持っていない場合は、ひとまず Ollama を選んでローカルでモデルを動かすこともできます。
API キーの設定：選択したプロバイダーに応じて、対応する API キーを入力します。
チャットチャンネルの選択：接続したいチャットプラットフォーム（WhatsApp、Telegram など）を選びます。初回はスキップして、あとから設定するのがおすすめです。
設定の確認：ウィザードが設定内容のサマリーを表示し、確認後に設定ファイルへ書き込みます。

すべての設定は ~/.config/openclaw/openclaw.json5 ファイルに保存されます。このファイルは手動でいつでも編集できます。

Gatewayサービスを起動する

設定が完了したら、OpenClaw の Gateway サービスを起動しましょう。

openclaw up

Gateway はデフォルトで 18789 ポートで動作します。ブラウザで http://localhost:18789 にアクセスすれば、サービスの状態を確認できます。

バックグラウンドで実行したい場合は以下のようにします。

openclaw up -d

Dashboardで動作テストをする

OpenClaw には Web Dashboard が組み込まれており、ブラウザ上で直接 AI と会話できます。設定が正しく行われたか確認するのに便利です。

openclaw dashboard

このコマンドを実行すると、ブラウザが自動的に開いて Dashboard 画面が表示されます。入力欄に何かメッセージを送ってみましょう。たとえば「こんにちは、自己紹介をお願いします」と入力して AI から返答があれば、一連の接続が正常に動作しています。

よくある問題のトラブルシューティング

問題が発生した場合は、OpenClaw の診断ツールを使ってください。

openclaw doctor

このコマンドは、環境設定・依存バージョン・API 接続状態などをチェックし、修正のアドバイスを表示してくれます。

よくある問題と対処法：

command not found: openclaw：npm のグローバル bin ディレクトリが PATH に含まれているか確認してください。npm config get prefix でパスを確認し、PATH に追加しましょう。
Node.js のバージョンが古い：nvm install 22 && nvm use 22 でアップグレードしてください。
API 接続に失敗する：API キーが正しいか、またネットワークから対象の API エンドポイントにアクセスできるかを確認してください。curl で手動テストすることもできます。
ポートの競合：18789 ポートが使用中の場合は、設定ファイルの gateway.port フィールドを変更してください。

次のステップ

インストールが完了したら、以下の機能もぜひ試してみてください。

他のチャットプラットフォーム（WhatsApp、Telegram、Discord など）への接続
複数の AI モデルプロバイダーを設定して切り替え
カスタム Skill を作成してアシスタントの能力を拡張
MCP Server を設定してさらに多くのツールを統合

詳しくは OpenClaw をご覧いただくか、OpenClaw公式ドキュメントを参照してください。ソースコードや Issue の追跡は OpenClaw GitHub リポジトリからどうぞ。