​

WhatsApp（Webチャンネル）

​

インストール（必要時）

• オンボーディング（openclaw onboard）およびopenclaw channels add --channel whatsappでは、初めて選択したときにWhatsApp pluginのインストールを促します。
• openclaw channels login --channel whatsappでも、pluginがまだ存在しない場合はインストールフローが提示されます。
• Devチャンネル + gitチェックアウトでは、デフォルトでローカルpluginパスが使用されます。
• Stable/Betaでは、デフォルトでnpmパッケージ@openclaw/whatsappが使用されます。

openclaw plugins install @openclaw/whatsapp

​

クイックセットアップ

{
  channels: {
    whatsapp: {
      dmPolicy: "pairing",
      allowFrom: ["+15551234567"],
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
    },
  },
}

openclaw channels login --channel whatsapp

openclaw channels login --channel whatsapp --account work

openclaw gateway

openclaw pairing list whatsapp
openclaw pairing approve whatsapp <CODE>

​

デプロイパターン

{
  channels: {
    whatsapp: {
      dmPolicy: "allowlist",
      allowFrom: ["+15551234567"],
    },
  },
}

​

ランタイムモデル

• GatewayがWhatsAppソケットと再接続ループを管理します。
• 送信には、対象アカウントに対するアクティブなWhatsAppリスナーが必要です。
• ステータスチャットとブロードキャストチャットは無視されます（@status、@broadcast）。
• ダイレクトチャットではDMセッションルール（session.dmScope）が使われます。デフォルトのmainではDMはagentのメインセッションに統合されます。
• グループセッションは分離されます（agent:<agentId>:whatsapp:group:<jid>）。

​

アクセス制御と有効化

​

個人番号と自分とのチャット動作

• 自分とのチャットターンでは既読通知をスキップ
• 本来なら自分自身にpingするmention-JID自動トリガー動作を無視
• messages.responsePrefixが未設定の場合、自分とのチャット返信のデフォルトは[{identity.name}]または[openclaw]

​

メッセージ正規化とコンテキスト

[Replying to <sender> id:<stanzaId>]
<quoted body or media placeholder>
[/Replying]

{
  channels: {
    whatsapp: {
      sendReadReceipts: false,
    },
  },
}

{
  channels: {
    whatsapp: {
      accounts: {
        work: {
          sendReadReceipts: false,
        },
      },
    },
  },
}

​

配信、チャンク化、メディア

​

リアクションレベル

{
  channels: {
    whatsapp: {
      reactionLevel: "ack",
    },
  },
}

​

確認応答リアクション

{
  channels: {
    whatsapp: {
      ackReaction: {
        emoji: "👀",
        direct: true,
        group: "mentions", // always | mentions | never
      },
    },
  },
}

• 受信が受理された直後に送信されます（返信前）
• 失敗はログに記録されますが、通常の返信配信は妨げません
• グループモードmentionsでは、mentionトリガーのターンにリアクションします。グループ有効化alwaysはこのチェックをバイパスします
• WhatsAppではchannels.whatsapp.ackReactionを使用します（legacyのmessages.ackReactionはここでは使用しません）

​

マルチアカウントと認証情報

​

ツール、アクション、config書き込み

• AgentツールサポートにはWhatsAppリアクションアクション（react）が含まれます。
• アクションゲート:
  • channels.whatsapp.actions.reactions
  • channels.whatsapp.actions.polls
• チャンネル起点のconfig書き込みはデフォルトで有効です（channels.whatsapp.configWrites=falseで無効化）。

​

トラブルシューティング

openclaw channels login --channel whatsapp
openclaw channels status

openclaw doctor
openclaw logs --follow

​

設定リファレンスへのポインター

• Configuration reference - WhatsApp

• アクセス: dmPolicy、allowFrom、groupPolicy、groupAllowFrom、groups
• 配信: textChunkLimit、chunkMode、mediaMaxMb、sendReadReceipts、ackReaction、reactionLevel
• マルチアカウント: accounts.<id>.enabled、accounts.<id>.authDir、アカウントレベル上書き
• 運用: configWrites、debounceMs、web.enabled、web.heartbeatSeconds、web.reconnect.*
• セッション動作: session.dmScope、historyLimit、dmHistoryLimit、dms.<id>.historyLimit

​

関連

• Pairing
• Groups
• Security
• Channel routing
• Multi-agent routing
• Troubleshooting