---
title: "Erro de Conexão com WhatsApp — Solução OpenClaw"
url: "https://openclaw.ia.br/troubleshooting/erro-conexao-whatsapp/"
markdown_url: "https://openclaw.ia.br/troubleshooting/erro-conexao-whatsapp.MD"
description: "Como resolver problemas de conexão entre o OpenClaw e o WhatsApp Web. Erros de websocket, reconexão e QR code."
date: ""
author: ""
---

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

### 1. Renovar a Sessão

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

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

```bash
cd ~/.openclaw
npm update @whiskeysockets/baileys
openclaw gateway restart
```

### 5. Verificar Logs

```bash
# Ver logs em tempo real
openclaw logs -f

# Procurar erros específicos
openclaw logs | grep -i "whatsapp\|baileys\|websocket"
```

## Problemas Relacionados

- [QR Code Expirado](#)
- [Sessão Desconectada](#)
- [Gateway Não Inicia](#)

## Prevençã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