OpenClaw Não Funciona em Grupos do WhatsApp

Sintomas

O bot não responde em grupos do WhatsApp, ou responde a toda mensagem causando spam.

Se você está enfrentando esse problema, siga as soluções abaixo em ordem de probabilidade.

Diagnóstico Rápido

Antes de tentar as soluções, colete informações:

# Status geral do OpenClaw
openclaw status

# Logs recentes
openclaw logs --tail 50

# Versão atual
openclaw --version

Soluções🔴 Responder apenas quando mencionado

Prioridade: Alta

Configure whatsapp_group_mode: mention_only. Bot só responde quando @mencionado.

🔴 Prefixo de comando

Prioridade: Alta

Configure whatsapp_group_prefix: '!'. Bot só responde a mensagens que começam com !.

🟡 Rate limiting em grupos

Prioridade: Média

Configure whatsapp_group_rate_limit: 5 (máximo 5 respostas/minuto/grupo).

🟢 Ignorar grupos específicos

Prioridade: Baixa

Configure whatsapp_group_blacklist: ['ID_GRUPO'] para ignorar grupos indesejados.

Ainda Com Problemas?

Se nenhuma solução acima resolveu:

Colete logs detalhados: openclaw logs --level debug --tail 200 > debug.log
Verifique a versão: openclaw --version — considere atualizar para a última versão
Busque na comunidade: Discord do OpenClaw — outros usuários podem ter resolvido
Abra uma issue: GitHub Issues com logs e passos para reproduzir

📄 Mais em Troubleshooting