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

WhatsApp 上で AI と会話できれば、普段最も使うチャットアプリから直接 AI アシスタントを呼び出せます。アプリを行き来する必要はありません。WhatsApp 連携は Telegram より少し手順が多いですが、仕組みを理解すれば 5〜10 分で設定できます。

低コスト「ロブスター飼育」ガイド：ArkClaw で AI Agent を本当に身近に

話題の OpenClaw（ロブスター）は便利ですが、設定のハードルが高いと感じていませんか？バイトダンス傘下の火山エンジン（Volcengine）が提供する ArkClaw は、その敷居を大きく下げてくれます。サーバー構築やトークン設定の手間なく、ワンクリックで 24 時間稼働し、ブラウザ操作・スクリプト実行・カレンダー管理までこなす「AI 牛馬（万能アシスタント）」を手に入れられます。

しかも非常に安価です。月額わずか 9.9 元、招待コード ZLKUK54M（登録はこちら）を使えば 8.9 元。プログラマーなら Coding Plan Pro に加入すれば、実質無料で使える場合もあります。

なぜ WhatsApp で AI を使うのか？

始める前に、Telegram や Web 画面ではなく WhatsApp を選ぶ理由を整理しておきましょう。プラットフォームごとに強みがあります。私が WhatsApp を選んだ主な理由は次のとおりです。

• 利用習慣：WhatsApp は私が日常で最も使う連絡ツールで、家族や友人もここにいます
• シームレスな統合：専用 AI アプリを開かず、チャット画面から質問できます
• リンクされたデバイス：WhatsApp のマルチデバイス機能は成熟しており、接続も安定しています
• プライバシー管理：データは自前サーバー上で処理され、サードパーティを経由しません

もちろん Telegram には API の開放性や Bot エコシステムといった強みもあります。どちらを選ぶかは、あなたの利用シーン次第です。

事前準備：環境を確認する

接続を始める前に、次の前提条件を満たしているか確認してください。

必須条件

1. OpenClaw がインストール済みで稼働中 — 未導入なら、先にインストールガイドを参照
2. スマホに WhatsApp アカウントがある — 主アカウントで QR スキャンに使います
3. Gateway が起動している — openclaw gateway が動作中であること
4. 安定したネットワーク — QR 接続時に通信が途切れないこと

技術上の注意点

Bun ランタイムを使っている場合、WhatsApp や Telegram 接続時に互換性問題が出ることがあります。公式は Gateway を Node.js で動かすことを推奨しており、こちらのほうが安定します。

実行環境を確認するコマンド：

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

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

3 つの接続方法

OpenClaw には WhatsApp 接続用の 3 つの方法があります。おすすめ順に紹介します。

方法 1：onboard ウィザード（最も簡単）

初めて設定するなら、これが最も手軽です。

初期設定がまだなら、次を実行します：

openclaw onboard --install-daemon

ウィザードで接続するメッセージチャンネルを聞かれたら WhatsApp を選びます。その後：

1. ターミナルに QR コードが表示される
2. スマホの WhatsApp で「設定」→「リンクされたデバイス」
3. 「デバイスをリンク」をタップして QR コードをスキャン
4. 成功するとターミナルに接続完了の表示

1〜2 分で完了します。初回スキャン時は少し緊張しましたが、一発でつながりました。

方法 2：channels login コマンド

onboard は済んでいて、WhatsApp チャンネルだけ追加したい場合はこちらです。

openclaw channels login

実行後の流れ：

1. ターミナル（または Web 画面）に QR コードが表示される
2. WhatsApp でスキャン
3. 接続が確立し、メッセージ受信が始まる

設定フロー全体を通さず、接続だけしたいときに便利です。

方法 3：Web 画面設定（最も柔軟）

設定を細かく制御したい場合は Web 画面を使います。

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

ステップ 1：設定画面へ

Settings → Config に移動し、右上の RAW ボタンで生設定エディタを開きます。

ステップ 2：WhatsApp 設定を追加

channels セクションに WhatsApp 設定を追加します：

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

各項目の意味：

• dmPolicy：DM ポリシー。allowlist はホワイトリストのみ許可
• allowFrom：許可する電話番号（国際形式、国番号付き）
• groupPolicy：グループメッセージのポリシー。allowlist が安全
• mediaMaxMb：受信可能なメディアの最大サイズ（MB）
• debounceMs：メッセージデバウンス（ミリ秒）。通常は 0

ステップ 3：保存してスキャン

右上の Update で保存し、Channels ページに戻ると QR コードが表示されます。WhatsApp でスキャンすれば完了です。

詳細設定の解説

先ほどの設定項目を、もう少し深く見ていきましょう。

権限管理：誰が AI にメッセージを送れるか

dmPolicy と groupPolicy は重要なセキュリティ設定です。

dmPolicy（DM ポリシー） には 3 つの選択肢があります：

• allowlist：ホワイトリストの番号のみ許可（推奨）
• denylist：ブラックリスト以外を許可
• open：誰でも送信可能（非推奨。リスクを理解している場合のみ）

私は allowlist を使い、自分と家族の番号だけを登録しています。AI はシステムへのアクセス権を持つため、見知らぬ人からのメッセージは避けたいからです。

allowFrom の電話番号形式

番号は国番号付きの国際形式で指定します：

"allowFrom": [
  "+8613800138000",    // 中国
  "+14155552671",      // アメリカ
  "+447700900000"      // イギリス
]

先頭の + と国番号を忘れないでください。形式が違うと認識されません。

groupPolicy（グループポリシー）

WhatsApp グループで AI を使う場合はグループポリシーも設定します。ただし、完全に信頼できる小さなグループ以外では、グループへの AI 公開は慎重に検討したほうがよいでしょう。

設定例：

"groupPolicy": "allowlist",
"allowFrom": ["グループ ID"]

グループ ID はログから確認するか、一度 open にしてメッセージを送り、ログ上の ID を拾う方法があります。

メッセージルーティング：AI がメッセージをどう処理するか

OpenClaw は WhatsApp メッセージを自動的に AI モデルへルーティングします。流れは次のとおりです。

1. WhatsApp でメッセージを送信
2. OpenClaw Gateway が受信
3. 送信者がホワイトリストにいるか確認
4. 通過すれば AI モデルへ転送
5. AI が返信を生成
6. WhatsApp へ返信

通常 1〜2 秒で完了します（AI モデルの応答速度に依存）。

メディアファイルの処理

mediaMaxMb で受信可能なファイルサイズを決めます。デフォルト 50MB で大抵は足ります。

OpenClaw が対応するメディア：

• 画像（JPG、PNG など）
• 音声ファイル
• ドキュメント（PDF、TXT など）

AI に視覚能力（GPT-4V など）を設定していれば、画像送信で内容を認識できます。

QR コードスキャンの詳細手順

どの方法でも最終的に QR コードをスキャンします。簡単ですが、いくつか注意点があります。

スマホ側の操作

1. WhatsApp アプリを開く
2. 右上の「その他」（三点メニュー）をタップ
3. 「リンクされたデバイス」（Linked Devices）を選択
4. 「デバイスをリンク」（Link a Device）をタップ
5. 必要に応じて生体認証またはパスワード入力
6. カメラが起動したら、PC 画面の QR コードを読み取る

PC 側の注意点

• QR コードの有効期限：通常 1〜2 分で失効。読み取れなければ再生成
• 表示の鮮明さ：QR コードがはっきり見えること。ターミナルフォントが小さすぎないか確認
• ネットワーク：スキャン時にスマホと PC の両方がオンラインであること

初回はターミナルフォントが小さく QR が潰れ、何度も失敗しました。ウィンドウを広げて解決しました。

接続成功のサイン

スキャン成功後、次の変化が見られます：

• スマホ側：「リンクされたデバイス」一覧に OpenClaw が表示
• PC 側：ターミナルに “WhatsApp connected” などの表示
• Web 画面：Channels ページで WhatsApp が緑（接続済み）

テストと検証

接続後はすぐ動作確認しましょう。

最初のメッセージ

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

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

設定が正しければ、数秒以内に AI が返信します。初めて返信が来たときは、思わず笑ってしまいました。

さまざまなメッセージタイプを試す

次も試してみてください：

• テキスト：AI に質問する
• 画像：写真を送り内容を説明してもらう（視覚モデルが必要）
• ドキュメント：PDF や TXT を送る
• 音声：対応していれば音声→文字も試せます

ログを確認する

問題があればログが手がかりになります：

# OpenClaw ログ確認
openclaw gateway --port 18789

受信メッセージ、処理過程、エラー情報が表示されます。

よくあるトラブルと対処

ソフトウェア導入ではつまずきがつきものです。私が踏んだ坑と対処法をまとめます。

問題 1：QR コードをスキャンしても反応がない

考えられる原因：

• QR コードの有効期限切れ
• ネットワーク接続の問題
• WhatsApp のバージョンが古い

対処法：

1. QR コードを再表示してスキャン
2. スマホと PC のネットワークを確認
3. WhatsApp を最新版に更新

問題 2：接続失敗、status=515 エラー

比較的よく見るエラーで、公式ドキュメントにも記載があります。

エラーメッセージ例：

WhatsApp login failed: status=515 Unknown Stream Errored (restart required)

対処法：

1. Settings → Config に戻る
2. 右上の Update をクリック（設定を変えなくても可）
3. Channels ページで接続状態を確認
4. それでもダメなら Gateway を再起動

# Gateway 再起動
pkill -f openclaw
openclaw gateway --port 18789

問題 3：メッセージを送っても AI が返信しない

考えられる原因：

• 送信者がホワイトリストにいない
• AI モデル設定の問題
• API キーの失効

確認手順：

1. 電話番号形式（国際形式）が正しいか
2. ログでメッセージが受信されているか
3. Web 画面で AI が正常応答するか
4. API キーが有効か

問題 4：権限拒否

症状：メッセージ送信後に “Permission denied” または無応答

対処：

• 自分の番号が allowFrom に含まれているか
• 国番号を含む形式になっているか
• グループメッセージなら groupPolicy も確認

問題 5：メディアファイルを送れない

考えられる原因：

• mediaMaxMb 制限超過
• 非対応フォーマット
• アップロード時のネットワーク障害

対処：

• mediaMaxMb を増やす
• ファイルを圧縮する
• ネットワーク接続を確認

問題 6：Gateway 再起動後に切断される

症状：PC や Gateway 再起動後、WhatsApp 接続が切れる

対処：

1. 通常は自動再接続される
2. されない場合は openclaw channels login を再実行
3. 再度 QR コードで接続
4. デーモンが正常起動しているか確認

高度なテクニック

基本機能が動いたら、次のような応用設定も試せます。

マルチデバイス管理

WhatsApp は複数デバイス同時接続に対応しています。複数 PC に OpenClaw を入れている場合、それぞれ接続できます。メッセージは全デバイスに同期されます。

ただし、同一 WhatsApp アカウントに OpenClaw を複数リンクすることはできません。複数 PC で使う場合は別アカウントが必要です。

カスタム返信ポリシー

設定で debounceMs を調整し、メッセージデバウンスを制御できます：

"debounceMs": 1000

連続送信したメッセージを 1 秒待ってからまとめて処理するため、API 呼び出しの頻度を抑えられます。

メッセージフィルタリング

特定タイプのメッセージを無視したい場合、Skills 設定でフィルタルールを追加できます。例：「AI」で始まるメッセージだけに反応する、など。

パフォーマンス最適化

メッセージ量が多い場合：

• mediaMaxMb を下げて帯域を節約
• debounceMs を調整してリクエスト頻度を抑制
• 応答の速い AI モデルを選ぶ

セキュリティ上の注意

WhatsApp 連携後は、次の点を必ず意識してください。

1. ホワイトリストを厳格に管理

allowFrom には信頼できる番号だけを登録。これらの番号は、スキルを有効にしていれば AI 経由でシステムコマンドを実行できる可能性があり、権限は大きいです。

2. 接続デバイスを定期的に確認

WhatsApp の「リンクされたデバイス」で、オンラインの端末を定期的に確認。見知らぬデバイスがあればすぐ削除。

3. 敏感操作には確認を入れる

ファイル削除や設定変更など、Skills 側で二次確認を入れ、誤操作を防ぎましょう。

4. 公共端末では接続しない

ネットカフェや図書館など公共 PC では WhatsApp をリンクしないでください。端末が監視されている可能性があります。

5. OpenClaw を定期的に更新

セキュリティパッチを適用するため、最新版を維持します：

npm update -g openclaw
# または
pnpm update -g openclaw

おわりに

ここまでで、WhatsApp を OpenClaw に接続できたはずです。手順を振り返ると：

WhatsApp vs Telegram：どちらを選ぶ？

まだ迷っているなら、次を参考にしてください。

WhatsApp を選ぶなら：

• 日常の連絡が主に WhatsApp
• 家族や友人と AI を共有したい
• リンクされたデバイスの安定性を重視

Telegram を選ぶなら：

• より開放的な API 能力が欲しい
• Bot エコシステムを使いたい
• チャンネルやグループ機能を重視

正直、両方設定しても問題ありません。OpenClaw はマルチチャンネル同時稼働に対応しており、WhatsApp と Telegram を併用し、シーンに応じて使い分けるのもアリです。

次にやること

接続が成功したら：

• OpenClaw の Skills 機能を試し、AI に能力を追加
• 画像やドキュメントを送り、マルチモーダル機能をテスト
• カスタム返信ロジックを調べる
• 興味があれば独自 Skill プラグインを開発

最後に一点：WhatsApp 連携は便利ですが、セキュリティも忘れないでください。ホワイトリストは慎重に管理し、信頼できない相手に AI 権限を渡さないこと。

楽しんで使ってください。困ったらドキュメントやコミュニティも参照してください。

---