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

はじめに

セルフホスト型AIゲートウェイ「OpenClaw（オープンクロー）」を、自分のパソコンに導入するためのマニュアルです。

📌 本記事の情報源： 本ガイドは公式ドキュメント（docs.openclaw.ai/ja-JP）および公式GitHubリポジトリ（github.com/openclaw/openclaw）の記載をベースにしています。OpenClawはアップデート頻度が高いため、実際の作業前に必ず最新の公式ドキュメントを併せてご確認ください。

 → OpenClaw_導入マニュアル_スライド
※ 上記から導入資料をダウンロードすることが可能です。

1. OpenClawとは？

🏠 特徴：「セルフホスト型」である

OpenClawは 「セルフホスト型」 のツールです。このため、データが外部に送信されない（プライバシーを守れる）という大きなメリットがあります。

✅ 用語解説（セルフホスト）

📘 セルフホスト（Self-host）とは？
サービスを他社のサーバーではなく、自分のパソコンやサーバーの上で動かすこと。
例：クラウドのChatGPTは「他社のサーバー」で動くが、OpenClawは「自分のパソコン」で動く。

📊 何ができるのか（主な機能）

2. 導入前に準備するもの

🖥️ システム要件

インストールを始める前に、お使いのパソコンが以下の条件を満たしているか確認してください。

✅ 用語解説（ハードウェア要件、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を使うと安定動作する。

# PowerShellを「管理者として実行」して以下を入力
wsl --install

🔑 APIキーの取得

OpenClawは「AIの頭脳」部分を外部サービスに任せる設計です。事前にAIサービスのAPIキーを取得しておきましょう。

⚠️ 注意：
Claude Pro / Max などの消費者向けサブスクリプションプランは、通常はAPI利用を含みません。OpenClawはAPIキー経由で利用するサービスなので、各プロバイダーの管理画面から発行する 従量課金のAPIキー をご用意ください。

✅ 用語解説（APIキー）

📘 APIキーとは？
AIサービスを外部プログラムから呼び出すための「認証用パスワード」のようなもの。第三者に漏れると勝手に使われて課金されるため厳重に管理する。

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

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

node -v

# nvmを使ってNode.jsの最新LTSをインストール
nvm install --lts
nvm use --lts

npm install -g openclaw@latest
openclaw onboard --install-daemon

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

bun add -g openclaw@latest
openclaw onboard --install-daemon

openclaw onboard --install-daemon

📋 セットアップで聞かれる内容

ウィザードは対話形式で進みます。主に以下の設定を行います。

⚠️ スキルに関する注意
スキル（Skills）はOpenClawの機能を拡張するプラグインです。外部から導入する仕組みのため、信頼できる提供元のもののみを選ぶことをおすすめします。初回セットアップではスキップし、必要になったタイミングで個別に検討するのが安全です。

openclaw --version      # CLIが利用可能か確認
openclaw doctor         # 設定に問題がないか自動診断
openclaw gateway status # Gateway（中核サービス）の動作確認

openclaw security audit         # 標準の監査
openclaw security audit --deep  # より詳細な監査

8. Control UI（ダッシュボード）を開く

OpenClawは、ブラウザから操作できる Web管理画面（Control UI） を備えています。

🌐 ダッシュボードを起動

openclaw dashboard

🔗 アクセス先

ブラウザで以下のURLを開きます。

📘 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が応答しない

チャットを送っても返信が来ない場合。

チェックリスト

❌ トラブル5：sharpのビルドエラー（npmインストール時）

「sharp」というライブラリのインストールに失敗する場合。

解決策

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

10. 次のステップ

OpenClawの導入が完了したら、次は以下を試してみましょう。

🎯 やってみたいこと別ロードマップ

🛡️ セキュリティの基本方針

企業で利用する場合は、以下を守ると事故を防げます。

1. 公開インターネットにバインドしない（127.0.0.1のみで運用）
2. SSHトンネルやVPN経由でアクセスする
3. スキル（プラグイン）は最小限に
4. APIキーは環境変数ファイルで管理し、Gitなどにコミットしない
5. 定期的に openclaw security audit --deep を実行

📚 参考リンク

まとめ：導入チェックリスト

印刷して使えるチェックリストです。

• [ ] システム要件（OS・メモリ・ストレージ）を満たしているか確認した
• [ ] Node.js 22.14以上（推奨：v24）がインストール済み
• [ ] WindowsならWSL2を有効化した
• [ ] AIサービスのAPIキーを取得した
• [ ] インストーラースクリプトまたはnpmで OpenClaw を導入した
• [ ] openclaw onboard --install-daemon でオンボーディングを完了した
• [ ] openclaw doctor で異常がないことを確認した
• [ ] openclaw gateway status でGatewayの稼働を確認した
• [ ] ブラウザで http://127.0.0.1:18789/ にアクセスできた
• [ ] ダッシュボードでテストメッセージを送り、AIから応答を受けた

すべてにチェックが入れば、OpenClawを使い始める準備は完璧です！🦞

法人向け生成AI研修のご案内

生成AIを「試す」から「実務に活かす」へ。

弊社では、「法人向け生成AI研修」を通じて、AIの基礎理解から、実際の業務で活用できる状態を目指した実践型の研修を提供しています。