---
title: "WhatsApp Desconecta Sozinho — Solução"
url: "https://openclaw.ia.br/troubleshooting/whatsapp-desconecta/"
markdown_url: "https://openclaw.ia.br/troubleshooting/whatsapp-desconecta.MD"
description: "Como resolver WhatsApp que desconecta do OpenClaw. Causas comuns e soluções permanentes."
date: ""
author: ""
---

# 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ções

### 1. Sessão Expirada

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

**Solução:**
```yaml
# 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:**
```yaml
whatsapp:
  auto_reconnect: true
  reconnect_delay: 5000
  max_reconnect_attempts: 10
```

### 4. Atualização do WhatsApp

**Causa:** Meta atualizou o protocolo.

**Solução:**
```bash
# 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

```yaml
# 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

```bash
# Verificar status
openclaw whatsapp status

# Reconectar manualmente
openclaw whatsapp reconnect
```

## Reconectar Automaticamente

### Via Cron

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

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

- [FAQ WhatsApp](/faq/whatsapp/)
- [Configurar Telegram](/canais/telegram/) como backup
- [Troubleshooting geral](/troubleshooting/)