OpenClawインストール＆設定完全ガイド2026年版【5分で導入】

OpenClawとは？オープンソースの個人用AIアシスタント

OpenClawは、個人や小規模チームが自分のサーバーでセルフホストできるオープンソースの個人用AIアシスタントです。WhatsApp・Slack・Discord・Telegram・iMessageなど主要なメッセージアプリと連携でき、普段使いのチャットツールからAIに指示を送るだけで、ブラウザ操作・ファイル操作・シェルコマンド実行といった高度なタスクを自動でこなします。

ChatGPTやClaudeといったクラウド型AIとの最大の違いは、完全に自分のインフラ上で動作する点です。データが外部サーバーに送られないため、プライバシーや機密情報の取り扱いに敏感なユーザーにとって理想的な選択肢となっています。また、使用するAIモデルを自由に選択できるため、コストを最適化しながら高性能なAIアシスタントを手に入れられます。

オープンソースであることから、コミュニティによる継続的な改善が行われており、新機能の追加やバグ修正が活発に進んでいます。カスタマイズ性も高く、自分のワークフローに合わせた設定変更が可能です。エンジニアでなくても、基本的なセットアップ手順に従えば比較的容易に導入できる設計になっており、2026年現在、個人向けAIエージェントとして注目度が急上昇しています。

個人利用はもちろん、スタートアップや中小企業が自社の業務自動化ツールとして採用する事例も増えています。既存のSlackやDiscordのワークスペースに追加するだけで、チーム全員がAIアシスタントを共有利用できる点も魅力のひとつです。OpenClawの最大の強みは「普段使いのメッセージアプリから直接AIに仕事を依頼できる」という直感的なインターフェースにあります。

インストール前の必要要件と事前準備

OpenClawをインストールする前に、いくつかの必要要件を満たしているか確認しましょう。システム要件と事前に準備するものを把握しておくことで、インストール作業をスムーズに進めることができます。

システム要件

OpenClawはNode.jsベースのアプリケーションです。動作に必要な最低限のスペックは以下のとおりです。

項目	最低要件	推奨要件
OS	Linux / macOS / Windows 10以上	Ubuntu 22.04 LTS / macOS 14以上
CPU	2コア以上	4コア以上
メモリ	2GB RAM	4GB RAM以上
ストレージ	10GB以上の空き容量	20GB以上
Node.js	v18以上	v20 LTS
npm	npm 9以上	npm 10以上

事前準備リスト

まず、AIモデルのAPIキーを取得しておく必要があります。OpenClawはOpenAIのGPT-4シリーズ、AnthropicのClaudeシリーズ、Google GeminiなどのAPIと連携して動作します。利用したいAIサービスのアカウントを作成し、APIキーを発行しておきましょう。

次に、連携したいメッセージアプリのBot設定が必要です。SlackであればSlack App管理画面、DiscordであればDiscord Developer Portal、TelegramであればBotFatherでのBot作成など、各プラットフォームでのBot設定を事前に済ませておくと効率的です。

また、ブラウザ操作機能を利用する場合は、Playwrightが必要になります。ファイル操作やシェルコマンド実行については特別な追加ソフトウェアは不要ですが、実行環境のセキュリティ設定（サンドボックス化など）についても事前に検討しておくとよいでしょう。Node.jsのインストールはnvmやnodeenvなどのバージョン管理ツールを使うと、将来的なバージョン切り替えが容易になります。

OpenClawのインストール手順（ステップバイステップ）

準備が整ったら、実際にOpenClawをインストールしていきましょう。以下の手順に従って進めてください。環境ごとの違いはありますが、基本的な流れはどのOSでも共通です。

ステップ1：リポジトリのクローン

まず、ターミナル（コマンドプロンプト）を開き、OpenClawの公式リポジトリをクローンします。インストール先として任意のディレクトリに移動してから実行してください。

git clone https://github.com/openclaw/openclaw.git
cd openclaw

ステップ2：依存パッケージのインストール

プロジェクトディレクトリに移動したら、npmを使って必要なパッケージをインストールします。

npm install

インストールには数分かかる場合があります。ネットワーク環境によっては時間がかかることもありますが、正常に完了するまで待ちましょう。node_modulesフォルダが作成されれば成功です。

ステップ3：環境変数ファイルの作成

サンプルの環境変数ファイルをコピーして、自分の設定用ファイルを作成します。

cp .env.example .env

ステップ4：環境変数の設定

テキストエディタで.envファイルを開き、必要な情報を入力します。最低限必要な設定は、使用するAIモデルのAPIキーです。

ステップ5：データベースの初期化

OpenClawは会話履歴や設定をローカルのデータベースに保存します。以下のコマンドでデータベースの初期化を行います。

npm run db:migrate

ステップ6：アプリケーションの起動

すべての設定が完了したら、アプリケーションを起動します。

npm run start

正常に起動すると、コンソールに起動ログが表示され、指定したポート（デフォルトは3000番）でサーバーが待機状態になります。本番環境での運用にはpm2などのプロセスマネージャーを使った常時起動設定を推奨します。

初期設定：AIモデルとAPIキーの設定方法

OpenClawを実際に動作させるためには、使用するAIモデルとAPIキーの設定が不可欠です。ここでは主要なAIモデルの設定方法を詳しく解説します。

.envファイルに設定する主要なパラメータは以下のとおりです。使用するAIサービスに応じて適切なキーを設定してください。

設定キー	説明	設定例
OPENAI_API_KEY	OpenAI GPT-4用APIキー	sk-xxxxxxxxxxxx
ANTHROPIC_API_KEY	Claude用APIキー	sk-ant-xxxxxxxxx
GOOGLE_API_KEY	Gemini用APIキー	AIzaxxxxxxxxx
DEFAULT_MODEL	デフォルトで使用するモデル	gpt-4o / claude-3-5-sonnet
MAX_TOKENS	1回の応答の最大トークン数	4096
TEMPERATURE	AIの回答の多様性（0〜1）	0.7

AIモデルの選び方

コストを重視する場合はGPT-4o miniやClaude Haiku、品質を重視する場合はGPT-4oやClaude Sonnetが一般的な選択肢です。タスクの種類によってモデルを使い分ける設定も可能なため、ブラウザ操作などの複雑なタスクには高性能モデル、日常的な質問応答には軽量モデルを割り当てるといった最適化ができます。

APIキーのセキュリティ

APIキーは絶対に公開リポジトリにコミットしないように注意が必要です。.envファイルは必ず.gitignoreに追加されていることを確認してください。本番環境での運用では、環境変数管理サービスや秘密管理ツールの利用を推奨します。

また、APIキーには利用制限（レートリミット）を設定しておくことで、万が一キーが漏洩した場合の被害を最小限に抑えることができます。使用するAIサービスの管理画面で月間の使用量上限を設定しておくことを強くお勧めします。設定完了後はnpm run testで動作確認を行いましょう。

メッセージアプリ連携の設定方法

OpenClawの最大の特徴のひとつが、複数のメッセージアプリとシームレスに連携できる点です。WhatsApp・Slack・Discord・Telegram・iMessageそれぞれの設定方法を解説します。

Slack連携

Slack連携には、Slack Appの作成と必要な権限の付与が必要です。Slack API管理画面で新規Appを作成し、chat:write、im:history、app_mentions:readなどのOAuthスコープを設定します。発行されたBot TokenとSigning Secretを.envファイルに設定することで、SlackのDMやチャンネルからOpenClawに指示を送れるようになります。Slackはビジネス利用での連携が多く、チームでの共有利用に最適です。

Discord連携

Discord Developer Portalで新しいアプリケーションとBotを作成します。必要な権限（Send Messages、Read Message Historyなど）を付与してBotトークンを取得し、.envファイルに設定します。Botをサーバーに招待することで、指定チャンネルでの会話やDMでAIアシスタントとやり取りできるようになります。

Telegram連携

Telegramの場合は、BotFather（公式Bot作成ツール）で新しいBotを作成し、トークンを取得するだけで設定完了です。比較的シンプルな設定手順のため、はじめてOpenClawを試す方にはTelegramからの連携がおすすめです。個人利用でのAIアシスタントとしての活用に最適で、スマートフォンからでも手軽に操作できます。

WhatsApp・iMessage連携

WhatsApp連携にはWhatsApp Business APIへのアクセスが必要となり、設定の難易度はやや高めです。iMessage連携はmacOS環境でのみ利用可能で、Appleの制限により機能に制約があります。まずはSlack、Discord、Telegramのいずれかで試してから、必要に応じてこれらの連携を検討するとよいでしょう。

ブラウザ操作・ファイル操作機能の有効化

OpenClawのコア機能であるブラウザ操作とファイル操作を有効にする手順を解説します。これらの機能を使うことで、単なるQ&Aを超えた実際のタスク実行が可能になり、OpenClawの真価を発揮できます。

ブラウザ操作の設定

ブラウザ操作機能にはPlaywrightライブラリが必要です。以下のコマンドでPlaywrightとChromiumブラウザをインストールします。

npx playwright install chromium

インストール後、.envファイルでENABLE_BROWSER=trueを設定することでブラウザ操作機能が有効になります。ヘッドレスモード（画面なし）での動作がデフォルトですが、デバッグ時はBROWSER_HEADLESS=falseに変更してヘッドフルモードに切り替えることもできます。

ファイル操作の設定

ファイル操作機能は標準で有効になっていますが、アクセスを許可するディレクトリを明示的に設定することを強く推奨します。.envファイルでALLOWED_DIRECTORIESに操作を許可するパスをカンマ区切りで指定することで、意図しないファイルへのアクセスを防止できます。例えばALLOWED_DIRECTORIES=/home/user/documents,/home/user/downloadsのように設定します。

シェルコマンドの設定

シェルコマンド実行機能は、強力な反面、セキュリティリスクも伴います。ENABLE_SHELL=trueで有効化できますが、ALLOWED_COMMANDSで実行を許可するコマンドをホワイトリスト形式で指定することを強く推奨します。本番環境での有効化は慎重に検討し、必要最小限のコマンドのみを許可してください。

よくあるインストールエラーと対処法

OpenClawのインストール・設定時に遭遇しやすいエラーとその対処法をまとめました。エラーが発生した場合は慌てず、まずエラーメッセージを確認してから対処しましょう。

エラー内容	原因	対処法
Cannot find module	依存パッケージ未インストール	npm installを再実行する
API key invalid	APIキーの誤り	.envのAPIキーを確認・再設定する
Port already in use	ポートの競合	別ポートを指定するか競合プロセスを終了する
Database connection failed	DB未初期化	npm run db:migrateを実行する
Browser not found	Playwright未インストール	npx playwright install chromiumを実行する
Permission denied	ファイル権限の問題	chmod +xで実行権限を付与する
EADDRINUSE	ポート使用中	PORT=3001で別ポートを指定する

エラーが解決しない場合は、Node.jsのバージョンが要件（v18以上）を満たしているか確認してください。node -vコマンドでバージョンを確認できます。また、ログファイル（logs/ディレクトリ）に詳細なエラー情報が記録されているため、問題解析に役立てることができます。GitHubのIssueページでも同様の問題への対処法が共有されていることが多いため、検索してみることをお勧めします。

AI導入・自動化支援は日本AI/DX総合研究所へ

OpenClawのようなオープンソースAIツールを業務に活用したい、でも技術的なハードルが高いと感じている方も多いのではないでしょうか。日本AI/DX総合研究所（aidx-soken.com） では、OpenClawをはじめとしたAIツールの導入・設定から、社内業務への組み込みまでをトータルサポートしています。

サーバーの準備からインストール、メッセージアプリ連携、業務フローへの組み込みまで、技術的な作業をすべて代行することが可能です。「自分でセットアップする時間がない」「設定の途中でつまずいた」といった場合でも、専門スタッフが対応します。

また、Claude Codeを活用したAI駆動のホームページ制作・SEO対策サービスも提供しています。従来の制作会社では数週間かかる案件も、AIの力で大幅に短縮しながら高品質なWebサイトを実現します。SEOに強いコンテンツ設計からサイト構築まで一貫して対応可能です。AI導入を検討している企業・個人事業主の方、まずはお気軽にご相談ください。初回相談は無料で承っています。