Erro de Conexão com WhatsApp — Solução OpenClaw

Como resolver problemas de conexão entre o OpenClaw e o WhatsApp Web. Erros de websocket, reconexão e QR code.

Erro de Conexão com WhatsApp

Descrição do Problema

O OpenClaw não consegue se conectar ao WhatsApp ou a conexão cai frequentemente. Você pode ver erros como:

Error: Connection closed
WebSocket connection failed
Unable to connect to WhatsApp servers
Possíveis Causas
  1. Sessão expirada - O QR Code foi escaneado há muito tempo
  2. WhatsApp Web aberto em outro lugar - Conflito de sessões
  3. Firewall bloqueando - Portas necessárias estão bloqueadas
  4. Versão desatualizada - Baileys ou dependências antigas
  5. IP bloqueado - Muitas tentativas de conexão
Soluções1. Renovar a Sessão
# Parar o gateway
openclaw gateway stop

# Limpar sessão antiga
rm -rf ~/.openclaw/whatsapp-session/

# Reiniciar e escanear novo QR Code
openclaw gateway start
2. Verificar Outras Sessões
  1. Abra o WhatsApp no celular
  2. Vá em Configurações > Aparelhos conectados
  3. Desconecte todas as sessões antigas
  4. Escaneie o QR Code novamente
3. Verificar Firewall
# Verificar se as portas estão abertas
sudo ufw status

# Liberar portas necessárias
sudo ufw allow 443/tcp
sudo ufw allow 5222/tcp
4. Atualizar Dependências
cd ~/.openclaw
npm update @whiskeysockets/baileys
openclaw gateway restart
5. Verificar Logs
# Ver logs em tempo real
openclaw logs -f

# Procurar erros específicos
openclaw logs | grep -i "whatsapp\|baileys\|websocket"
Problemas RelacionadosPrevenção
  • Mantenha o WhatsApp do celular sempre conectado à internet
  • Não abra o WhatsApp Web em navegadores enquanto usa o OpenClaw
  • Configure reconexão automática no arquivo de configuração