---
title: "OpenClaw Não Funciona em Grupos do WhatsApp"
url: "https://openclaw.ia.br/troubleshooting/whatsapp-grupo-nao-funciona/"
markdown_url: "https://openclaw.ia.br/troubleshooting/whatsapp-grupo-nao-funciona.MD"
description: "Configure o OpenClaw para funcionar corretamente em grupos do WhatsApp."
date: "2026-02-22"
author: ""
---

# OpenClaw Não Funciona em Grupos do WhatsApp

Configure o OpenClaw para funcionar corretamente 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:

```bash
# 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:

1. **Colete logs detalhados**: `openclaw logs --level debug --tail 200 > debug.log`
2. **Verifique a versão**: `openclaw --version` — considere atualizar para a última versão
3. **Busque na comunidade**: [Discord do OpenClaw](https://discord.gg/clawd) — outros usuários podem ter resolvido
4. **Abra uma issue**: [GitHub Issues](https://github.com/openclaw/openclaw/issues) com logs e passos para reproduzir

## Artigos Relacionados

- [Troubleshooting Geral](/troubleshooting/) — índice de todos os problemas
- [Guia de Instalação](/instalacao/) — reinstalar pode resolver problemas persistentes
- [FAQ Técnico](/faq/tecnico/) — perguntas frequentes técnicas
- [Guia de Segurança](/seguranca/) — configurações de segurança