popularchannels20 min read• March 2026

$ cat whatsapp-integration.md

export WhatsAppIntegration

/** WhatsAppからOpenClaw AIに、いつでもどこからでもアクセス */

table-of-contents.ts

const sections = [

]

section_01_architecture.md

🏗️## 仕組み：Gatewayアーキテクチャ

WhatsAppは個人向けの無料公式APIを提供していないため、OpenClawはGatewayアーキテクチャを採用しています。openclaw-messenger-gatewayは仮想ブラウザ（Chromium）を作成し、あなたの代わりにWhatsApp Webにログインして、メッセージをOpenClawインスタンスにブリッジします。

▸

あなた → 自分の番号（または専用番号）にWhatsAppメッセージを送信

▸

Gateway → WhatsApp Web経由でメッセージを傍受

▸

OpenClaw → 選択したAIモデルでリクエストを処理

▸

返信 → WhatsAppチャットに返ってくる

// 💡 ヒント：個人番号の代わりに、専用のサブ番号（Google VoiceやコストのかかるSIMカードなど）をAI WhatsApp番号として使用することをお勧めします。

section_02_prerequisites.md

## ✅ 前提条件

☐OpenClawが実行中でアクセス可能（スタートガイドを参照）

☐WhatsAppアカウント（専用サブ番号を推奨）

☐ホストマシンにDockerがインストール済み

☐Node.js 18+（DockerなしでGatewayを実行する場合）

☐24/7稼働サーバー（VPSまたは常時起動マシン）

section_03_install.sh

## 📦 WhatsApp Gatewayのインストール

OpenClawメッセンジャーゲートウェイは、メインのOpenClawインスタンスと並行して実行される独立したサービスです。

Option A: Docker (Recommended)

# Pull and start the gateway

$ docker pull ghcr.io/clawdbot/openclaw-messenger-gateway:latest

$ docker run -d \

--name openclaw-gateway \

-p 3001:3001 \

-e OPENCLAW_URL=http://YOUR_OPENCLAW_IP:18789 \

-v gateway-sessions:/app/sessions \

ghcr.io/clawdbot/openclaw-messenger-gateway:latest

Option B: Node.js

$ git clone https://github.com/clawdbot/openclaw-messenger-gateway

$ cd openclaw-messenger-gateway && npm install

$ cp .env.example .env

# Edit .env with your OpenClaw URL, then:

$ npm start

section_04_pair.md

## 📱 WhatsAppアカウントのペアリング

Gatewayが起動したら、QRコードをスキャンしてWhatsAppアカウントと認証する必要があります。

ステップ1：ペアリングUIを開く

ブラウザで http://YOUR_SERVER_IP:3001 にアクセスします。

ステップ2：QRコードをスキャン

スマートフォンのWhatsAppを開く → 設定 → リンクされたデバイス → デバイスをリンク。ゲートウェイUIに表示されたQRコードをスキャンします。

ステップ3：確認を待つ

10秒以内にUIにConnected ✓が表示されるはずです。セッションはディスクに保存され、再起動後も有効です。

// ⚠️ QRコードは60秒で期限切れになります。期限切れになったらページを更新して新しいコードを取得してください。

section_05_config.yaml

## ⚙️ OpenClawへの接続

OpenClaw設定ファイルにWhatsAppチャンネルを追加します：

# openclaw/config.yaml

channels:

whatsapp:

enabled: true

gateway_url: "http://localhost:3001"

allowed_numbers:

- "+1234567890" # YOUR number

section_06_security.md

🔐## ボットのセキュリティ設定（重要！）

これが最も重要なセクションです。AIにWhatsAppへのアクセスを与えると、あなたの番号にメッセージを送った誰もがAIと対話できる可能性があります。OpenClawはアクセスコントロールリスト（ACL）を使用します — ホワイトリストにない番号からのメッセージはすべて無視されます。

// Finding unauthorized attempt logs:

$ docker logs openclaw 2>&1 | grep "SECURITY"

[SECURITY] Unauthorized message from: +9876543210. Ignoring.

⚠️ 本番サーバーでallowed_numbersを空のままにしたり*に設定したりしないでください。これにより誰でも無制限にAIにアクセスできてしまいます（費用はあなたの負担）。

section_07_test.md

## 🧪 テストと公開

許可されたWhatsApp番号からメッセージを送信し、応答を確認します：

// Your WhatsApp message:

You: "Hello! What's the weather like in Tokyo right now?"

// OpenClaw response (~10 seconds):

OpenClaw: "Currently in Tokyo: 12°C, partly cloudy..."

section_08_troubleshoot.md

## 🔧 トラブルシューティング

再起動後にセッションが切れる

-v gateway-sessions:/app/sessions DockerボリュームにWhatsAppセッションが保存されます。それでもセッションが切れる場合は、QRコードを再スキャンしてください。Dockerコンテナに--restart alwaysを使用することも検討してください。

QRコードが表示されない

ポート3001がアクセス可能か確認してください。ファイアウォールの内側にある場合は、セットアップ中一時的に実行します：sudo ufw allow 3001。後で制限することを忘れないでください。

メッセージがOpenClawに届かない

OPENCLAW_URL環境変数が正しいか確認してください。確認：curl http://YOUR_OPENCLAW_IP:18789/health はOKを返すはずです。

WhatsAppアカウントが禁止される

WhatsAppは非公式ゲートウェイを使用するアカウントを禁止することがあります。個人の低ボリューム利用ではまれですが、専用サブ番号を使用することでこのリスクを大幅に軽減できます。

next_steps.md

## 🚀 次のステップ

OpenClawがWhatsAppに接続されました！さらにチャンネルを探索して、セキュリティを強化しましょう：

export TelegramSetup

// Add Telegram as a second channel

export VPSSecurityGuide

// Lock down your server first