WhatsApp Desconecta Sozinho — Solução
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ções
1. 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
Monitoramento
Alertas de Desconexão
"Me avise por Telegram se WhatsApp desconectar"
Health Check
# Verificar status
openclaw whatsapp status
# Reconectar manualmente
openclaw whatsapp reconnect
Reconectar Automaticamente
Via 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:
- Telegram - Mais estável, API oficial
- Signal - Privado, menos problemas
- 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