openclaw - 💡(How to fix) Fix WhatsApp group inbound silently fails if group not in channels.whatsapp.groups

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

WhatsApp groups only receive inbound messages if they are explicitly listed in channels.whatsapp.groups in the config. Having the group in groupAllowFrom is NOT sufficient. There is no warning or error when messages are dropped.

Error Message

WhatsApp groups only receive inbound messages if they are explicitly listed in channels.whatsapp.groups in the config. Having the group in groupAllowFrom is NOT sufficient. There is no warning or error when messages are dropped.

  • No warning, no error — completely silent failure

Root Cause

WhatsApp groups only receive inbound messages if they are explicitly listed in channels.whatsapp.groups in the config. Having the group in groupAllowFrom is NOT sufficient. There is no warning or error when messages are dropped.

Fix Action

Workaround

Add the group to channels.whatsapp.groups with an empty config:

"groups": {
  "<group-id>@g.us": {}
}

Code Example

"groups": {
  "<group-id>@g.us": {}
}
RAW_BUFFERClick to expand / collapse

Summary

WhatsApp groups only receive inbound messages if they are explicitly listed in channels.whatsapp.groups in the config. Having the group in groupAllowFrom is NOT sufficient. There is no warning or error when messages are dropped.

Steps to Reproduce

  1. Configure channels.whatsapp.groupPolicy: "open"
  2. Add a group to channels.whatsapp.groupAllowFrom
  3. Do NOT add the group to channels.whatsapp.groups
  4. Send a message in that group mentioning the bot

Expected Behavior

  • Messages are received and routed to the agent, OR
  • A warning log is emitted: "Inbound message from group X dropped: group not in channels.whatsapp.groups"

Actual Behavior

  • Messages appear in web-inbound logs (the monitor sees them)
  • Messages are never dispatched to the agent session
  • directory groups list --channel whatsapp does not show the group
  • No warning, no error — completely silent failure
  • Outbound (message send, cron announce) works fine to the same group

Workaround

Add the group to channels.whatsapp.groups with an empty config:

"groups": {
  "<group-id>@g.us": {}
}

Impact

Silent message loss. The bot appears to work (sends messages via cron/announce) but never processes replies. Users assume the bot is ignoring them.

Environment

  • OpenClaw: 2026.5.18 / 2026.5.12 (both affected)
  • WhatsApp provider: web bridge

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING