WhatsApp Desconecta Sozinho — Solução

Como resolver WhatsApp que desconecta do OpenClaw. Causas comuns e soluções permanentes.

WhatsApp Desconecta Sozinho

Seu WhatsApp fica desconectando do OpenClaw? Veja as causas e soluções.

Sintomas
  • Bot para de responder
  • Mensagem “WhatsApp disconnected” nos logs
  • Precisa escanear QR code repetidamente
  • Funciona por algumas horas e para
Causas e Soluções1. Sessão Expirada

Causa: WhatsApp Web expira sessões inativas ou por segurança.

Solução:

# config.yaml
whatsapp:
  keepalive: true
  keepalive_interval: 300000  # 5 minutos
2. Múltiplos Dispositivos

Causa: Usando mesmo número em outro lugar.

Solução:

  • Use número dedicado para o bot
  • Não abra WhatsApp Web no navegador
  • Desconecte outros dispositivos vinculados

Verificar dispositivos: WhatsApp (celular) > Dispositivos vinculados > Remova os extras

3. Instabilidade de Rede

Causa: Conexão cai e não reconecta.

Solução:

whatsapp:
  auto_reconnect: true
  reconnect_delay: 5000
  max_reconnect_attempts: 10
4. Atualização do WhatsApp

Causa: Meta atualizou o protocolo.

Solução:

# Atualizar dependências
npm update -g openclaw
openclaw gateway restart
5. Rate Limiting do WhatsApp

Causa: Muitas mensagens em pouco tempo.

Solução:

  • Reduza frequência de mensagens
  • Adicione delay entre mensagens
  • Não use para spam
6. Problema no Celular

Causa: WhatsApp no celular sem internet/bateria.

Solução:

  • Mantenha celular conectado ao WiFi
  • Celular sempre carregando
  • Desative economia de bateria para WhatsApp
Configuração Robusta
# config.yaml completo para estabilidade
whatsapp:
  enabled: true
  keepalive: true
  keepalive_interval: 300000
  auto_reconnect: true
  reconnect_delay: 5000
  max_reconnect_attempts: 10
  connection_timeout: 30000
  
  # Logging para debug
  log_level: info
MonitoramentoAlertas de Desconexão
"Me avise por Telegram se WhatsApp desconectar"
Health Check
# Verificar status
openclaw whatsapp status

# Reconectar manualmente
openclaw whatsapp reconnect
Reconectar AutomaticamenteVia Cron
# Verificar e reconectar a cada hora
0 * * * * openclaw whatsapp check || openclaw whatsapp reconnect
Via Heartbeat
Durante heartbeat:
Se WhatsApp desconectado há mais de 5 minutos,
tente reconectar automaticamente
Logs de Debug
# Ver eventos de conexão
openclaw logs | grep -i "whatsapp\|connect\|disconnect"

# Modo verbose
DEBUG=whatsapp* openclaw gateway start
Alternativas

Se WhatsApp continuar problemático:

  1. Telegram - Mais estável, API oficial
  2. Signal - Privado, menos problemas
  3. Discord - Bom para comunidades
Quando é o WhatsApp, Não o OpenClaw
  • Meta faz manutenção (verifique status.whatsapp.com)
  • Conta bloqueada por spam
  • Verificação de segurança ativada
Próximos Passos