OpenClawの導入手順を徹底解説!プログラミング未経験でもOK

セルフホスト型AIゲートウェイ「OpenClaw(オープンクロー)」を、自分のパソコンに導入するためのマニュアルです。
📌 本記事の情報源:
本ガイドは公式ドキュメント(docs.openclaw.ai/ja-JP)および公式GitHubリポジトリ(github.com/openclaw/openclaw)の記載をベースにしています。OpenClawはアップデート頻度が高いため、実際の作業前に必ず最新の公式ドキュメントを併せてご確認ください。

※ 上記から導入資料をダウンロードすることが可能です。
■ 1. OpenClawとは?
「LINEやSlackなどのチャットアプリから、AIアシスタントと会話できるようにしてくれる“橋渡し役”のソフト」 です。
自分のパソコン(またはサーバー)の中にOpenClawをインストールすると、DiscordやSlack、Telegram、WhatsAppなどのメッセージアプリにAIを常駐させられるようになります。
🏠 特徴:「セルフホスト型」である
OpenClawは 「セルフホスト型」 のツールです。
このため、データが外部に送信されない(プライバシーを守れる)という大きなメリットがあります。
✅ 用語解説(セルフホスト)
📘 セルフホスト(Self-host)とは?
サービスを他社のサーバーではなく、自分のパソコンやサーバーの上で動かすこと。
例:クラウドのChatGPTは「他社のサーバー」で動くが、OpenClawは「自分のパソコン」で動く。
📊 何ができるのか(主な機能)
| 機能 | 説明 |
|---|---|
| マルチチャネル接続 | Discord、Slack、Telegram、WhatsApp、iMessage、Signal、Microsoft Teams など複数のチャットアプリに同時接続 |
| AIエージェント機能 | Claude や GPT などのAIモデルを、ツール実行やメモリ付きで利用可能 |
| メディア対応 | 画像・音声・ドキュメントの送受信 |
| Web管理画面 | ブラウザからチャット・設定を管理できるダッシュボードを搭載 |
| モバイル対応 | iOS・Androidのノード(専用アプリ)とペアリング可能 |
■ 2. 導入前に準備するもの
🖥️ システム要件
インストールを始める前に、お使いのパソコンが以下の条件を満たしているか確認してください。
| 項目 | 要件 |
|---|---|
| OS(パソコンの種類) | macOS / Linux / Windows(※WindowsはWSL2推奨) |
| Node.js(必須) | バージョン24(推奨)、または22.14以上 |
| AIのAPIキー | Claude(Anthropic)・GPT(OpenAI)などのAPIキー |
✅ 用語解説(ハードウェア要件、Node.js、WSL2)
💡 ハードウェア要件について:
公式ドキュメントでは特定のRAM・ストレージ容量は指定されていません。一般的なWebブラウザやNode.js製アプリが快適に動作するPCであれば問題なく動きます。
📘 Node.jsとは?
JavaScriptというプログラミング言語をパソコン上で動かすための実行環境。OpenClaw本体はNode.jsで作られているため必須。📘 WSL2(Windows Subsystem for Linux 2)とは?
Windowsの中でLinuxを動かせる仕組み。OpenClawはLinux/macOS向けに作られているため、Windowsでは WSL2を使うと安定動作する。
💡 WindowsユーザーはWSL2の導入を先に
Windowsをお使いの方は、先にWSL2を用意しておくとトラブルが少なくなります。
powershell
# PowerShellを「管理者として実行」して以下を入力
wsl --installインストール後はパソコンを再起動してください。
🔑 APIキーの取得
OpenClawは「AIの頭脳」部分を外部サービスに任せる設計です。事前にAIサービスのAPIキーを取得しておきましょう。
| AIサービス | 取得先 | 料金の目安 |
|---|---|---|
| Anthropic(Claude) | console.anthropic.com | 従量課金 |
| OpenAI(GPT) | platform.openai.com | 従量課金 |
| Ollama(ローカルAI) | ollama.com | 無料 |
⚠️ 注意:
Claude Pro / Max などの消費者向けサブスクリプションプランは、通常はAPI利用を含みません。OpenClawはAPIキー経由で利用するサービスなので、各プロバイダーの管理画面から発行する 従量課金のAPIキー をご用意ください。
✅ 用語解説(APIキー)
📘 APIキーとは?
AIサービスを外部プログラムから呼び出すための「認証用パスワード」のようなもの。第三者に漏れると勝手に使われて課金されるため厳重に管理する。
■ 3. インストール方法の選び方
OpenClawには複数のインストール方法があります。
初心者の方は 「インストーラースクリプト」 が最もかんたんでおすすめです。
🎯 方法の比較表
| 方法 | 難易度 | こんな人におすすめ | 所要時間 |
|---|---|---|---|
| ① インストーラースクリプト ⭐推奨 | ⭐☆☆☆☆ | 初めての方・とにかくすぐ使いたい方 | 約5分 |
| ② npmコマンド | ⭐⭐☆☆☆ | すでにNode.jsを導入済みの方 | 約5分 |
| ③ ローカルプレフィックスインストーラー | ⭐⭐☆☆☆ | システムを汚したくない方 | 約10分 |
| ④ ソースからビルド | ⭐⭐⭐⭐☆ | 開発者・カスタマイズしたい方 | 約15〜30分 |
| ⑤ Docker | ⭐⭐⭐☆☆ | サーバー運用・隔離環境で動かしたい方 | 約10分 |
本ガイドでは、初心者の方が最もスムーズに進められる 「① インストーラースクリプト」 と 「② npmコマンド」 の2つを解説します。
✅ 用語解説(npm、Docker)
📘 npm(エヌピーエム)とは?
Node.js用の「アプリストア」のようなもの。コマンドひとつでライブラリやツールを追加できる。📘 Dockerとは?
アプリケーションを「コンテナ」という独立した箱に入れて動かす仕組み。環境に左右されず、どのパソコンでも同じように動かせる。
■ 4. 【推奨】インストーラースクリプトで導入する
コマンド1行で、必要なもの(Node.jsを含む)をすべて自動インストールしてくれる方法です。
🍎 macOS / 🐧 Linux / 🪟 WSL2 の場合
ステップ1:ターミナルを開く
- macOS:「アプリケーション」→「ユーティリティ」→「ターミナル」
- Linux:
Ctrl + Alt + T - WSL2:スタートメニューから「Ubuntu」など
ステップ2:以下のコマンドをコピーして実行
curl -fsSL https://openclaw.ai/install.sh | bash
ステップ3:画面の指示に従う
コマンドを実行すると、自動で以下が進みます。
✓ OSを検出しています...
✓ Node.jsのバージョンを確認しています...
✓ OpenClawをインストールしています...
✓ オンボーディングを開始します...
🪟 Windows(ネイティブ)の場合
WSL2を使わない場合は、PowerShellから以下を実行します。
ステップ1:PowerShellを「管理者として実行」
スタートメニューから「PowerShell」を右クリック → 「管理者として実行」 を選択。
ステップ2:以下のコマンドを実行
iwr -useb https://openclaw.ai/install.ps1 | iex💡 スクリプトが自動でNode.jsの有無を確認し、必要に応じてインストールを行います。
🛑 オンボーディングを同時に開始したくない場合
インストールのみ行い、セットアップは後から行いたい場合は以下のオプションを付けます。
| OS | コマンド |
|---|---|
| macOS / Linux / WSL2 | curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard |
| Windows | & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard |
5. 【代替】npmコマンドで導入する
すでにNode.jsをインストール済みで、自分で管理したい方向けの手順です。
✅ 事前チェック:Node.jsのバージョン確認
node -vv22.14以上(できればv24)が表示されればOKです。
バージョンが古い場合は、nvm(Node.js用のバージョン管理ツール)で最新LTS版をインストールしてください。
# nvmを使ってNode.jsの最新LTSをインストール
nvm install --lts
nvm use --lts
📦 インストールコマンド
パッケージマネージャー(npm、pnpm、bun)のどれかを選んで実行します。
npmの場合(最も一般的)
npm install -g openclaw@latest
openclaw onboard --install-daemon
pnpmの場合
pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon⚠️ pnpmでは、ビルドスクリプトを含むパッケージに明示的な承認(
pnpm approve-builds -g)が必要です。
bunの場合
bun add -g openclaw@latest
openclaw onboard --install-daemon
💡 BunはCLIのインストールのみサポート。Gatewayの常時実行にはNode.jsが推奨されます。
📘 グローバルインストール(
-g)とは?
パソコン全体のどこからでも使えるように導入すること。-gがないと特定フォルダ内でしか使えない。
■ 6. 初期セットアップ(オンボーディング)
インストールが完了したら、オンボーディング という初期設定ウィザードを実行します。
🚀 オンボーディングの起動
openclaw onboard --install-daemon
📘 デーモン(daemon)とは?
パソコンの裏側で常に動き続けるプログラムのこと。--install-daemonオプションを付けると、パソコン起動時に自動でOpenClawが立ち上がるようになる。
📋 セットアップで聞かれる内容
ウィザードは対話形式で進みます。主に以下の設定を行います。
| 設定項目 | 内容 | 入力例 |
|---|---|---|
| ワークスペース名 | 作業環境の名前を決める | my-workspace |
| AIプロバイダー選択 | 使用するAIサービスを選択 | Anthropic Claude |
| APIキー入力 | 事前に取得したAPIキーを貼り付け | sk-ant-api03-... |
| チャネル設定 | 接続したいチャットアプリを選択 | Telegram、Slack など |
| スキル導入(任意) | 追加機能(プラグイン)の導入可否 | セキュリティ観点から最初は導入しないのがおすすめ |
⚠️ スキルに関する注意
スキル(Skills)はOpenClawの機能を拡張するプラグインです。外部から導入する仕組みのため、信頼できる提供元のもののみを選ぶことをおすすめします。初回セットアップではスキップし、必要になったタイミングで個別に検討するのが安全です。
■ 7. インストールが成功したかを確認する
インストールとセットアップが正しく完了したかを3つのコマンドで確認します。
🔍 確認コマンド
openclaw --version # CLIが利用可能か確認
openclaw doctor # 設定に問題がないか自動診断
openclaw gateway status # Gateway(中核サービス)の動作確認
📊 期待される結果
| コマンド | 正常な結果の例 |
|---|---|
openclaw --version | openclaw v1.x.x のようにバージョン番号が表示 |
openclaw doctor | ✓ All checks passed のように全項目OK表示 |
openclaw gateway status | ✓ OpenClaw Gateway started on http://localhost:18789 |
🛡️ セキュリティ監査(推奨)
企業PoC(概念実証)で利用する場合は、導入直後にセキュリティ監査コマンドを走らせておくと安心です。
openclaw security audit # 標準の監査
openclaw security audit --deep # より詳細な監査📘 PoC(Proof of Concept / 概念実証)とは?
新しい技術を本格導入する前に「本当に使えるか」を小規模で試すこと。
■ 8. Control UI(ダッシュボード)を開く
OpenClawは、ブラウザから操作できる Web管理画面(Control UI) を備えています。
🌐 ダッシュボードを起動
openclaw dashboard
🔗 アクセス先
ブラウザで以下のURLを開きます。
| アクセス先 | URL |
|---|---|
| ローカル(自分のパソコン) | http://127.0.0.1:18789/ |
| リモート(別PC/スマホから) | Tailscale等のVPN経由でアクセス |
📘 localhost / 127.0.0.1 とは?
「自分のパソコン自身」を指すアドレス。外部には公開されず、同じPC内からしかアクセスできない安全な接続方式。
💬 動作テスト
ダッシュボード上のチャット画面で「こんにちは」「自己紹介して」などと送ってみましょう。
AIから返信があれば、導入は完了です 🎉
9. よくあるトラブルと解決方法
❌ トラブル1:openclaw コマンドが見つからない
インストールは成功したのに、ターミナルで openclaw と打つと「command not found」と出る場合。
原因の調査
node -v # Node.jsが入っているか確認
npm prefix -g # グローバルパッケージの場所を確認
echo "$PATH" # PATHが通っているか確認
解決策
~/.zshrc や ~/.bashrc に以下を追記し、新しいターミナルを開き直します。
export PATH="$(npm prefix -g)/bin:$PATH"📘 PATH(パス)とは?
OSがコマンドを探しに行く「場所のリスト」。PATHに登録されていないコマンドは名前だけでは実行できない。
❌ トラブル2:Node.jsのバージョンが古い
「Node version incompatible」というエラーが出る場合。
解決策
# nvmで最新LTSに更新
nvm install --lts
nvm use --lts
❌ トラブル3:ポート18789が使えない
「Address already in use」や「ポートが既に使用中」というエラーが出る場合、他のアプリがポート18789を使っています。
解決策A:ポートを変更する(推奨)
openclaw config set コマンドでポート番号を変更できます。
# ポート番号を変更(例:28789に変更)
openclaw config set gateway.port 28789
# Gatewayを再起動して設定を反映
openclaw gateway restart
# 変更が反映されたか確認
openclaw config get gateway.portポート変更後、ダッシュボードのURLも http://127.0.0.1:28789/ のように変わります。
解決策B:占有しているプロセスを終了する
ポート18789を使っているプロセスを見つけて終了させる方法です(macOS / Linux)。
# ポート18789を使っているプロセスIDを確認
sudo lsof -i :18789
# プロセスを終了(<PID>は上で確認した番号に置き換え)
kill -9 <PID>
📘 設定ファイルの場所:OpenClawの設定は
~/.openclaw/openclaw.jsonに保存されます。直接編集することも可能ですが、openclaw config setコマンド経由が推奨されています(自動でリロードされるため)。
❌ トラブル4:AIが応答しない
チャットを送っても返信が来ない場合。
チェックリスト
| 確認項目 | 対応 |
|---|---|
| APIキーが正しく設定されているか | ~/.openclaw/openclaw.json を確認 |
| APIキーに余計なスペース・改行が入っていないか | 貼り付け直す |
| AIサービス側の残高があるか | 各サービスの管理画面で確認 |
| インターネット接続は正常か | 他のサイトにアクセスできるか確認 |
❌ トラブル5:sharpのビルドエラー(npmインストール時)
「sharp」というライブラリのインストールに失敗する場合。
解決策
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
■ 10. 次のステップ
OpenClawの導入が完了したら、次は以下を試してみましょう。
🎯 やってみたいこと別ロードマップ
| やりたいこと | 参照すべきドキュメント |
|---|---|
| Slackに接続したい | docs.openclaw.ai/ja-JP/channels |
| Telegramに接続したい(最速) | docs.openclaw.ai/ja-JP/channels/telegram |
| スマホから使いたい | モバイルノードのペアリングガイド |
| 外部から安全にアクセスしたい | Tailscale(VPN)連携ガイド |
| 機能を拡張したい | Tools & Plugins のページ |
🛡️ セキュリティの基本方針
企業で利用する場合は、以下を守ると事故を防げます。
- 公開インターネットにバインドしない(127.0.0.1のみで運用)
- SSHトンネルやVPN経由でアクセスする
- スキル(プラグイン)は最小限に
- APIキーは環境変数ファイルで管理し、Gitなどにコミットしない
- 定期的に
openclaw security audit --deepを実行
📚 参考リンク
| リンク | URL |
|---|---|
| 公式サイト | https://openclaw.ai |
| 公式ドキュメント(日本語) | https://docs.openclaw.ai/ja-JP |
| インストールガイド(公式) | https://docs.openclaw.ai/ja-JP/install |
| GitHubリポジトリ | https://github.com/openclaw/openclaw |
✅ まとめ:導入チェックリスト
印刷して使えるチェックリストです。
すべてにチェックが入れば、OpenClawを使い始める準備は完璧です!🦞✨