ワッツアップ

​

クイックセットアップ

{
  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"],
    },
  },
}

​

ランタイムモデル

• ゲートウェイは WhatsApp ソケットと再接続ループを所有します。
• アウトバウンド送信には、ターゲット アカウントのアクティブな WhatsApp リスナーが必要です。
• ステータス チャットとブロードキャスト チャットは無視されます (@status、@broadcast)。
• ダイレクト チャットは DM セッション ルールを使用します (session.dmScope、デフォルトの main はエージェントのメイン セッションへの DM を折りたたみます)。
• グループ セッションは分離されています (agent:<agentId>:whatsapp:group:<jid>)。

​

アクセス制御とアクティベーション

​

個人番号とセルフチャットの動作

• セルフチャットターンの開封確認をスキップします
• 自分自身に ping を実行するメンション JID 自動トリガー動作を無視します
• messages.responsePrefix が設定されていない場合、セルフチャットの返信はデフォルトで [{identity.name}] または [openclaw] になります。

​

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

[Replying to <sender> id:<stanzaId>]
<quoted body or media placeholder>
[/Replying]
```利用可能な場合は、返信メタデータ フィールドも入力されます (`ReplyToId`、`ReplyToBody`、`ReplyToSender`、送信者 JID/E.164)。

</Accordion>

<Accordion title="Media placeholders and location/contact extraction">
メディアのみの受信メッセージは、次のようなプレースホルダーを使用して正規化されます。

- `<media:image>`
- `<media:video>`
- `<media:audio>`
- `<media:document>`
- `<media:sticker>`

場所と連絡先のペイロードは、ルーティング前にテキスト コンテキストに正規化されます。

</Accordion>

<Accordion title="保留中のグループ履歴の挿入">
グループの場合、未処理のメッセージをバッファリングし、ボットが最終的にトリガーされたときにコンテキストとして挿入できます。

- デフォルトの制限: `50`
- 構成: `channels.whatsapp.historyLimit`
- フォールバック: `messages.groupChat.historyLimit`
- `0` を無効にします

注射マーカー:

- `[Chat messages since your last reply - for context]`
- `[Current message - respond to this]`

</Accordion>

<Accordion title="開封確認">
開封確認は、受信された WhatsApp メッセージに対してデフォルトで有効になっています。

グローバルに無効にする:

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

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

​

配信、チャンキング、およびメディア

​

肯定応答

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

• 受信が受け入れられた後すぐに送信されます (事前応答)
• 失敗はログに記録されますが、通常の応答配信はブロックされません
• グループモード mentions は言及によって引き起こされたターンに反応します。グループのアクティブ化 always は、このチェックのバイパスとして機能します
• WhatsApp は channels.whatsapp.ackReaction を使用します (従来の messages.ackReaction はここでは使用されません)

​

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

​

ツール、アクション、構成の書き込み

• エージェント ツールのサポートには、WhatsApp 反応アクション (react) が含まれます。
• アクションゲート:
  • channels.whatsapp.actions.reactions
  • channels.whatsapp.actions.polls
• チャネル開始の設定書き込みはデフォルトで有効になっています (channels.whatsapp.configWrites=false で無効にします)。

​

トラブルシューティング

openclaw channels login --channel whatsapp
openclaw channels status

openclaw doctor
openclaw logs --follow

​

構成参照ポインタ

• 設定リファレンス - WhatsApp

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

​

関連- ペアリング

• チャンネルルーティング
• マルチエージェントルーティング
• トラブルシューティング