グループメッセージ

WhatsApp グループメッセージ処理の挙動と設定。mentionPatterns はすべてのインターフェース（CLI、TUI、Web UI）で共有されます。

このページでは、WhatsApp 固有のグループメッセージ処理の挙動（アクティベーションモード、履歴コンテキスト注入、mention gating）に焦点を当てます。

WhatsApp グループは 2 つのアクティベーションモードをサポートしています：

- ''mention''（デフォルト）：@mention または mentionPatterns に一致した場合のみ返信をトリガーします。

- ''always''：すべてのグループメッセージに返信します（公開グループには推奨されません）。

Configuration:

- グローバル：''channels.whatsapp.groupPolicy = mention|always''

- Per-group: ''channels.whatsapp.groups.<jid>.requireMention = false'' (set to false for always mode)

mentionPatterns は正規表現の配列で、グループメッセージ内のテキストに一致させるために使用されます。@mention がなくても返信をトリガーできます。

{ "messages": { "groupChat": { "mentionPatterns": [ "^(?i)\\b(bot|assistant|help|ai)\\b", "^@openclaw", "^(?i)\\b(hey|hello|hi)\\s+openclaw" ] } } }

agent ごとにオーバーライドも可能：

''agents.list[].groupChat.mentionPatterns''

グループメッセージが返信をトリガーしない場合（mention なし / allowlist でブロック）、OpenClaw はこれらのメッセージを pending として保存します。

次回トリガー時に、これらの pending メッセージがコンテキストとして prompt に注入され、モデルが会話履歴を理解するのに役立ちます。

これにより、ボットがすべてのメッセージに返信しなくても、グループ内の最新の議論を把握できるようになります。

グループメッセージが返信をトリガーすると、OpenClaw は最近の履歴メッセージを prompt に注入します。

履歴メッセージは 2 つの部分に分かれます：

- Pending メッセージ：前回の返信以降に処理されなかったメッセージ（historyLimit まで）。

- Transcript メッセージ：セッション記録に書き込まれた履歴メッセージ。

WhatsApp グループメッセージ処理の主要な設定オプション：

- ''channels.whatsapp.groupPolicy''：グローバルアクティベーションモード（mention/always）。

- ''channels.whatsapp.groups.<jid>.requireMention'': Override activation mode per group.

- ''channels.whatsapp.historyLimit''：pending 履歴メッセージの最大数（デフォルト 50）。

一部のチャンネルは ''/activation'' コマンドをサポートしています（現在のセッションのみに影響）：

- ''/activation mention''：mention が必要（デフォルト）。

- ''/activation always''：すべてのメッセージに返信。

注意：このコマンドは通常、認証された送信者（owner/allowlist）に対してのみ機能します。動作を永続化するには、セッションコマンドに依存せずに設定を記述してください。