---
title: "Sessão Desconectada — Reconexão OpenClaw"
url: "https://openclaw.ia.br/troubleshooting/sessao-desconectada/"
markdown_url: "https://openclaw.ia.br/troubleshooting/sessao-desconectada.MD"
description: "Como resolver quando a sessão do WhatsApp ou Telegram desconecta inesperadamente. Reconexão automática."
date: ""
author: ""
---

# Sessão Desconectada — Reconexão OpenClaw

Como resolver quando a sessão do WhatsApp ou Telegram desconecta inesperadamente. Reconexão automática.


# Sessão Desconectada

## Descrição do Problema

A conexão com WhatsApp ou Telegram cai inesperadamente e não reconecta automaticamente:

```
Session disconnected
Connection lost
Logged out from another device
Stream ended unexpectedly
```

## Possíveis Causas

1. **Logout manual** - Alguém desconectou pelo app principal
2. **Conflito de sessões** - Muitos dispositivos conectados
3. **Inatividade prolongada** - Sessão expirou por tempo
4. **Atualização do app** - WhatsApp/Telegram atualizou e invalidou sessão
5. **Problema de rede** - Conexão instável

## Soluções

### 1. Reconectar Manualmente

```bash
# Verificar status atual
openclaw gateway status

# Tentar reconexão
openclaw gateway reconnect

# Se não funcionar, reiniciar
openclaw gateway restart
```

### 2. Verificar Dispositivos Conectados

**WhatsApp:**
1. Abra WhatsApp no celular
2. Vá em Configurações > Aparelhos conectados
3. Verifique se há muitos dispositivos
4. Remova dispositivos antigos

**Telegram:**
1. Abra Telegram
2. Vá em Configurações > Dispositivos
3. Encerre sessões desconhecidas

### 3. Configurar Reconexão Automática

```yaml
# No arquivo de configuração
connection:
  auto_reconnect: true
  reconnect_interval: 5000  # 5 segundos
  max_reconnect_attempts: 10
  backoff_multiplier: 1.5
```

### 4. Verificar Logs de Desconexão

```bash
# Ver motivo da desconexão
openclaw logs | grep -i "disconnect\|logout\|closed"

# Ver últimos eventos
openclaw logs --tail 50
```

### 5. Renovar Credenciais

```bash
# Limpar sessão antiga
openclaw session clear --channel whatsapp

# Ou manualmente
rm -rf ~/.openclaw/sessions/whatsapp/

# Reconectar
openclaw gateway restart
```

### 6. Manter Sessão Ativa

```yaml
# Configurar heartbeat para manter conexão viva
keepalive:
  enabled: true
  interval: 30000  # 30 segundos
  timeout: 10000
```

## Monitoramento

```bash
# Criar script de monitoramento
#!/bin/bash
while true; do
  status=$(openclaw gateway status)
  if [[ $status != *"running"* ]]; then
    echo "Gateway desconectado! Reconectando..."
    openclaw gateway restart
  fi
  sleep 60
done
```

## Problemas Relacionados

- [QR Code Expirado](#)
- [Erro de Conexão WhatsApp](#)
- [Token Telegram Inválido](#)

## Prevenção

- Configure reconexão automática
- Não faça logout no app principal enquanto usa o bot
- Mantenha o dispositivo principal sempre online
- Use um dispositivo dedicado se possível