docs: clarify WhatsApp group allowlist and reply mention behavior

This commit is contained in:
Peter Steinberger
2026-02-19 09:19:27 +01:00
parent ad4c784f20
commit 9c2640a810
2 changed files with 9 additions and 0 deletions

View File

@@ -169,6 +169,7 @@ OpenClaw recommends running WhatsApp on a separate number when possible. (The ch
Sender allowlist fallback:
- if `groupAllowFrom` is unset, runtime falls back to `allowFrom` when available
- sender allowlists are evaluated before mention/reply activation
Note: if no `channels.whatsapp` block exists at all, runtime group-policy fallback is effectively `open`.
@@ -183,6 +184,11 @@ OpenClaw recommends running WhatsApp on a separate number when possible. (The ch
- configured mention regex patterns (`agents.list[].groupChat.mentionPatterns`, fallback `messages.groupChat.mentionPatterns`)
- implicit reply-to-bot detection (reply sender matches bot identity)
Security note:
- quote/reply only satisfies mention gating; it does **not** grant sender authorization
- with `groupPolicy: "allowlist"`, non-allowlisted senders are still blocked even if they reply to an allowlisted user's message
Session-level activation command:
- `/activation mention`
@@ -407,6 +413,7 @@ Behavior notes:
- `groupAllowFrom` / `allowFrom`
- `groups` allowlist entries
- mention gating (`requireMention` + mention patterns)
- duplicate keys in `openclaw.json` (JSON5): later entries override earlier ones, so keep a single `groupPolicy` per scope
</Accordion>