OpenClaw WhatsApp連携完全ガイド：設定から実践まで

WhatsAppでAIと初めて会話した時の感動は忘れられません。普段使い慣れたチャットアプリで、アプリを切り替えることなくシームレスにAIアシスタントを呼び出せる——これは本当に画期的でした。

もしあなたもWhatsAppでOpenClawを使いたいなら、この記事で設定手順を手取り足取り解説します。Telegramに比べると少しだけ手順が多いですが、仕組みさえ分かれば5〜10分で完了します。

なぜWhatsAppでAIを使うのか？

TelegramやWebインターフェースではなく、あえてWhatsAppを選ぶ理由は何でしょうか？

私がWhatsAppを選んだ主な理由は以下の通りです：

習慣への適合：日常的に最も使う連絡ツールであり、通知を見逃しません。
シームレスな統合：専用アプリを開く必要がなく、会話の流れでAIに質問できます。
リンクされたデバイス：WhatsAppのマルチデバイス機能は非常に安定しています。
プライバシー：データは自前のサーバーで処理され、サードパーティを経由しません。

もちろんTelegramにはBotエコシステムの強みがありますが、普段使いの利便性ではWhatsAppに分があります。

事前準備：環境チェック

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

前提条件

OpenClawがインストール済みで実行中であること
スマホにWhatsAppアカウントがあること（スキャン用）
Gatewayが起動していること（openclaw gateway）
安定したネットワーク環境（接続時のQRスキャンに必須）

技術的な注意点

Bunランタイムを使用している場合、WhatsApp接続時に互換性の問題が発生することがあります。安定性を重視するなら Node.js でGatewayを実行することを公式も推奨しています。

環境確認コマンド：

# Node.jsバージョン確認
node --version

# Gatewayプロセス確認
ps aux | grep openclaw

3つの接続方法

OpenClawはWhatsApp接続用に3つの方法を用意しています。簡単な順に紹介します。

方法1：onboardウィザード（推奨）

最も簡単な「全自動」モードです。初期設定がまだなら、迷わずこれを選びましょう。

openclaw onboard --install-daemon

ウィザードが進むと「接続するチャンネル」を聞かれます。WhatsAppを選択すると：

ターミナルにQRコードが表示されます
スマホのWhatsAppを開き、「設定」→「リンクされたデバイス」へ
「デバイスをリンク」をタップしてQRコードをスキャン
成功するとターミナルに完了メッセージが出ます

所要時間は1〜2分。私は初めてでも一発で繋がりました。

方法2：channels loginコマンド

すでにonboardは完了していて、WhatsAppだけ追加したい場合はこのコマンドが便利です。

openclaw channels login

実行後の流れ：

ターミナル（またはWeb画面）にQRコードが表示される
WhatsAppでスキャン
接続確立

余計な設定をスキップして接続だけしたい場合に最適です。

方法3：Webインターフェース設定（上級者向け）

設定を細かくコントロールしたい場合は、Web管理画面を使います。

OpenClawコントロールパネル（デフォルト http://localhost:18789）にアクセスし：

手順1：設定画面へ

Settings → Config に移動し、右上の RAW ボタンを押してエディタモードに入ります。

手順2：WhatsApp設定の追加

channels オブジェクト内に以下を追加します：

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+819012345678"],
      "groupPolicy": "allowlist",
      "mediaMaxMb": 50,
      "debounceMs": 0
    }
  }
}

各項目の意味：

dmPolicy: 個人チャットのポリシー。allowlist（ホワイトリストのみ許可）が安全です。
allowFrom: 許可する電話番号リスト。必ず**国際形式（国番号付き）**で入力します（例：日本の090-1234-5678なら +819012345678）。
groupPolicy: グループチャットのポリシー。同様にallowlist推奨。
mediaMaxMb: 受信可能なメディアファイルの最大サイズ（MB）。
debounceMs: メッセージのデバウンス（連投防止）時間。通常は0。

手順3：保存とスキャン

Update ボタンで保存後、Channels ページに戻るとQRコードが表示されています。これをスキャンすれば完了です。

詳細設定ガイド

先ほどの設定項目について、セキュリティの観点からもう少し詳しく解説します。

権限管理：誰がAIを使えるか？

dmPolicy と groupPolicy はセキュリティの要です。

dmPolicy（個人チャット）の選択肢：

allowlist：リストにある番号のみ許可（推奨）
denylist：ブラックリスト以外は許可
open：全開放（非推奨。誰でもあなたのAIを使えてしまいます）

私は必ず allowlist にし、自分と家族の番号だけを入れています。

電話番号のフォーマット
必ず「+」から始まる国際形式で記述してください：

"allowFrom": [
  "+819012345678",  // 日本
  "+14155552671"    // アメリカ
]

groupPolicy（グループチャット）
グループでAIを使いたい場合の設定です。グループIDを指定しますが、IDを知るには一度 open にしてメッセージを送り、ログでIDを確認する必要があります。セキュリティリスクがあるため、信頼できるグループ以外では無効化をお勧めします。

メッセージルーティングの仕組み

WhatsAppから送られたメッセージがどう処理されるかの流れです：

WhatsAppでメッセージ送信
OpenClaw Gatewayが受信
ホワイトリスト（allowFrom）チェック
通過すればAIモデルへ転送
AIが回答生成
WhatsAppへ返信

このプロセスは通常1〜2秒で完了します。

メディアファイル処理

mediaMaxMb でサイズ制限を設定します。OpenClawは以下のメディアに対応しています：

画像（JPG, PNG）
音声
ドキュメント（PDF, TXT）

画像認識モデル（GPT-4Vなど）を設定していれば、画像を送って「これは何？」と聞くことも可能です。

QRコードスキャンのコツ

簡単なステップですが、いくつか注意点があります。

スマホ側の操作

WhatsAppを開く
メニュー（Androidは「︙」、iOSは「設定」）
「リンクされたデバイス」→「デバイスをリンク」
生体認証後、カメラが起動したらスキャン

PC側の注意点

有効期限：QRコードは短時間（数十秒〜分）で変わります。スキャンできない場合は更新してください。
表示サイズ：ターミナルで表示する場合、フォントサイズによってはQRコードが崩れることがあります。その場合はウィンドウを広げるか文字サイズを調整してください。
ネットワーク：スマホとPC両方がネットに繋がっている必要があります（同一Wi-Fiである必要はありません）。

接続成功のサイン

スマホ側：「リンクされたデバイス」一覧にOpenClawが表示される。
PC側：ターミナルに “WhatsApp connected” と表示される。
Web画面：WhatsAppアイコンが緑色になる。

テストと検証

接続できたら、すぐに動作確認しましょう。

最初のメッセージ

自分宛てに（AI宛てに）メッセージを送ってみます：

こんにちは、聞こえますか？

数秒で返事が来れば成功です。

多機能テスト

質問：普通の会話をする
画像：写真を送って内容を尋ねる
ファイル：PDFを送って要約を頼む

ログ確認

反応がない場合はログを見ます：

openclaw gateway --port 18789

トラブルシューティング

私が実際に遭遇した問題とその解決策です。

Q1: QRコードをスキャンしても反応がない

原因：QRコードの期限切れ、またはネットワーク遅延。
解決：QRコードを再表示させてスキャンし直す。WhatsAppアプリを最新にする。

Q2: 接続失敗エラー status=515

エラーログ：WhatsApp login failed: status=515 Unknown Stream Errored
これは公式ドキュメントにも載っている既知の問題です。

解決：Web設定画面（Config）で何も変更せずに Update ボタンを押す。それでもダメならGatewayを再起動（pkill -f openclaw してから起動）。

Q3: メッセージを送っても無視される

原因：送信元がホワイトリストに入っていない。
解決：電話番号が allowFrom に含まれているか、形式（+81…）が正しいか確認。

Q4: メディアが送れない

原因：ファイルサイズ超過。
解決：mediaMaxMb を増やすか、ファイルを圧縮する。

Q5: 再起動後に切断される

解決：通常は自動再接続されますが、されない場合は openclaw channels login で再認証してください。

高度な使い方

マルチデバイス管理

WhatsApp自体がマルチデバイス対応なので、OpenClawもその一つとして振る舞います。ただし、1つのWhatsAppアカウントに対して1つのOpenClawインスタンスしかリンクできません。

カスタム応答設定

debounceMs を1000（1秒）などに設定すると、連投したメッセージをまとめて処理してくれるため、API呼び出し回数を節約できます。

セキュリティのベストプラクティス

信頼できる番号のみ許可：システムコマンドを実行できるスキルを入れている場合、AIへのアクセス権＝サーバー操作権です。
定期的なセッション確認：WhatsApp上で不明なデバイスがリンクされていないか時々確認しましょう。
公共Wi-Fiでの設定回避：QRスキャン時は盗聴リスクを避けるため、安全なネットワークで行ってください。
OpenClawの更新：セキュリティパッチを受け取るため、定期的に npm update -g openclaw しましょう。

まとめ

WhatsApp連携の手順を振り返ります：

OpenClaw WhatsApp連携フロー

AIアシスタントをWhatsAppに接続するまでのステップバイステップガイド

⏱️ Estimated time: 15 min

1
Step1: 準備
Gatewayが稼働中か確認。Node.js環境推奨。
2
Step2: 接続開始
コマンド openclaw channels login またはWeb画面を使用。
3
Step3: 権限設定
dmPolicy: "allowlist" に設定し、allowFrom に自分の電話番号（国際形式）を追加。
4
Step4: QRスキャン
スマホのWhatsApp「リンクされたデバイス」から画面のQRコードを読み取る。
5
Step5: テスト
メッセージを送り、Web画面でステータスが緑色になるか確認。

WhatsApp vs Telegram

WhatsApp：家族や友人との共有、日常使いの利便性を重視する人向け。安定したマルチデバイス接続。
Telegram：Bot APIの柔軟性、チャンネル機能、開発者向け機能を重視する人向け。

両方同時に使うことも可能です。「仕事はTelegram、プライベートはWhatsApp」と使い分けるのも良いでしょう。

次にやるべきこと？まずは接続して、AIとチャットを楽しんでください。慣れてきたら、カスタムスキルを追加して、WhatsAppから家の電気を消したり、サーバーの状態を確認したりできるようにしてみましょう。

FAQ

スキャンしても反応しません

QRコードの有効期限は短いです。再表示して試してください。また、ネットワーク接続を確認してください。

Status 515エラーが出ます

Web設定画面で「Update」を押して設定をリロードするか、Gatewayを再起動してください。

AIが返信してくれません

あなたの電話番号が allowFrom リストに正しい国際形式（+81...）で含まれているか確認してください。

グループチャットでも使えますか？

はい、groupPolicy を設定すれば可能です。ただしセキュリティリスクを考慮し、慎重に運用してください。

5 min read · 公開日: 2026年2月5日 · 更新日: 2026年2月5日

Easton

AI・インテリジェンス