なぜWhatsAppと接続するのか
WhatsApp は世界最大級のメッセージアプリの一つです。OpenClaw を WhatsApp に接続すれば、日常的に使っているチャット画面からそのまま AI アシスタントと会話できます。別のアプリを開く必要も、新しい URL を覚える必要もありません。AI にメッセージを送ることが、友達にメッセージを送るのと同じくらい自然に行えます。
OpenClaw は WhatsApp Web プロトコルを通じて接続します。仕組みは PC で WhatsApp Web にログインするのと同じです。それでは、設定の全手順を進めていきましょう。
前提条件
作業を始める前に、以下を確認してください。
- OpenClaw がインストール済みで正常に動作している（インストールガイドを参照）
- 少なくとも 1 つの AI モデルプロバイダーが設定済み（例：Anthropic Claude）
- WhatsApp のアカウントを持っている
- スマートフォンの WhatsApp アプリが最新版である
Onboardウィザードでチャンネルを追加する
まだ初期設定の段階であれば、openclaw onboard ウィザードで接続するチャンネルを聞かれた際に WhatsApp を選択できます。
すでに初期設定が完了しており、WhatsApp チャンネルだけを追加したい場合は、以下を実行してください。
openclaw channel add whatsapp
このコマンドで WhatsApp チャンネルの設定フローが起動します。
QRコードをスキャンしてペアリングする
チャンネル追加コマンドを実行すると、ターミナルに QR コードが表示されます。スマートフォンの WhatsApp でスキャンしてペアリングを完了させます。
- スマートフォンで WhatsApp を開く
- 設定 > リンク済みデバイス（iOS）または メニュー > リンク済みデバイス（Android）に進む
- デバイスをリンク をタップする
- スマートフォンのカメラをターミナルの QR コードに向ける
スキャンが成功すると、ターミナルに接続成功のメッセージが表示されます。通常、数秒で完了します。
QR コードの有効期限が切れた場合（通常 60 秒後）、Enter キーを押すと新しい QR コードが生成されます。
設定ファイルを確認する
ペアリングが完了すると、OpenClaw が自動的に設定ファイルを更新します。~/.config/openclaw/openclaw.json5 を開いて WhatsApp チャンネルが追加されているか確認できます。
{
channels: {
whatsapp: {
enabled: true,
autoReply: true,
// 会話の設定
allowedNumbers: [], // 空の配列はすべての番号を許可
ignoreGroups: true // デフォルトでグループメッセージを無視
}
}
}
主な設定項目の説明：
autoReply：trueにするとメッセージ受信時に自動返信します。falseにすると特定のプレフィックスでのトリガーが必要になります。allowedNumbers：AI と会話できる電話番号を制限します。空のままだと無制限です。セキュリティ上、自分の番号を設定しておくことをおすすめします。ignoreGroups：グループ内のメッセージを無視するかどうかの設定です。最初はtrueにしておき、グループ内での不要な返信を避けることを推奨します。
メッセージの送受信をテストする
OpenClaw の Gateway が稼働していることを確認します。
openclaw up
別の WhatsApp アカウントから（または友人に頼んで）、自分の WhatsApp 番号にメッセージを送ります。設定が正しければ、OpenClaw が AI モデルで返信を生成し、自動的に送り返します。
自分自身にメッセージを送ってテストすることもできます。WhatsApp の「自分宛て」の会話（自分にメッセージを送る機能）でメッセージを送り、AI の返信が来るか確認してください。
Dashboard でもメッセージの送受信状況を確認できます。
openclaw dashboard
Dashboard にはすべてのチャンネルのメッセージログが表示されるため、メッセージが正しく流れているか確認するのに便利です。
よくある問題の対処法
QRコードをスキャンしても反応がない
- スマートフォンと PC が同じネットワーク環境にあることを確認する
- WhatsApp が最新バージョンか確認する
- OpenClaw サービスを再起動してから再度スキャンしてみる
メッセージを送ったが返信がない
まず Gateway のログを確認します。
openclaw logs
よくある原因：
- AI モデルプロバイダーの API キーが無効、または残高不足
- ネットワークから API エンドポイントにアクセスできない（特定のネットワーク環境の場合）
autoReplyがfalseに設定されている
接続が頻繁に切れる
WhatsApp Web の接続はネットワークの変動により切断されることがあります。OpenClaw には自動再接続の仕組みがありますが、頻繁に切れる場合は以下を確認してください。
- スマートフォンの WhatsApp がオンライン状態を維持しているか
- スマートフォンのネットワーク接続が安定しているか
- 他のデバイスでも WhatsApp Web にログインしていないか（リンク済みデバイスは最大 4 台まで）
診断コマンドで詳細な情報を取得できます。
openclaw doctor
グループで返信させたくない場合
設定ファイルの ignoreGroups が true になっていることを確認してください。特定のグループでのみ AI 返信を有効にしたい場合は、グループのホワイトリストを設定できます。
{
channels: {
whatsapp: {
ignoreGroups: false,
allowedGroups: ["グループID1", "グループID2"]
}
}
}
セキュリティに関する推奨事項
allowedNumbersで AI と会話できる番号を制限し、知らない人に API の利用枠を消費されないようにする- Dashboard のメッセージログを定期的に確認し、異常な使用がないかチェックする
- AI アシスタントとの会話で機密性の高い個人情報を送らない
まとめ
WhatsApp は OpenClaw で最もよく使われるチャンネルの一つであり、設定はそれほど複雑ではありません。ペアリングが完了すれば基本的に追加のメンテナンスは不要で、OpenClaw が接続の維持とメッセージの転送を自動的に処理します。使用中に問題が発生した場合は、OpenClaw公式ドキュメントを参照するか、OpenClaw GitHub リポジトリで関連する Issue を検索してください。その他のチャンネルの接続方法については OpenClaw をご覧ください。