---
title: "QR Code Expirado — Solução WhatsApp"
url: "https://openclaw.ia.br/troubleshooting/qr-code-expirado/"
markdown_url: "https://openclaw.ia.br/troubleshooting/qr-code-expirado.MD"
description: "Como resolver quando o QR Code do WhatsApp expira antes de ser escaneado. Gerar novo QR rapidamente."
date: ""
author: ""
---

# QR Code Expirado — Solução WhatsApp

Como resolver quando o QR Code do WhatsApp expira antes de ser escaneado. Gerar novo QR rapidamente.


# QR Code Expirado

## Descrição do Problema

O QR Code para conectar ao WhatsApp expira antes de você conseguir escanear. Mensagens como:

```
QR Code expired. Please restart to generate a new one.
Timeout waiting for QR scan
Session expired before authentication
```

## Possíveis Causas

1. **Demora para escanear** - QR Code tem validade de ~60 segundos
2. **Problemas de rede** - Conexão lenta impedindo autenticação
3. **WhatsApp no celular sem internet** - Celular offline
4. **Câmera com problema** - QR Code não está sendo lido corretamente
5. **Versão antiga do WhatsApp** - App desatualizado no celular

## Soluções

### 1. Gerar Novo QR Code Rapidamente

```bash
# Reiniciar gateway para novo QR
openclaw gateway restart

# Ou parar e iniciar
openclaw gateway stop
openclaw gateway start
```

### 2. Aumentar Timeout do QR Code

```yaml
# No arquivo de configuração
whatsapp:
  qr_timeout: 120  # 2 minutos
  auto_reconnect: true
```

### 3. Usar QR Code no Terminal

```bash
# Exibir QR Code como ASCII no terminal
openclaw gateway start --qr-terminal

# Isso permite escanear diretamente do terminal
# sem precisar abrir navegador
```

### 4. Verificar Conexão do Celular

1. Abra o WhatsApp no celular
2. Envie uma mensagem para qualquer contato
3. Se funcionar, o celular está online
4. Tente escanear o QR Code novamente

### 5. Limpar Cache e Tentar Novamente

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

# Limpar cache do navegador se usar Web
# Ctrl+Shift+Delete no navegador

# Reiniciar gateway
openclaw gateway restart
```

### 6. Verificar Versão do WhatsApp

No celular:
1. Vá na App Store / Play Store
2. Procure por WhatsApp
3. Atualize se houver versão nova

## Dicas para Escanear Mais Rápido

1. **Prepare o celular antes** - Abra a câmera de QR do WhatsApp
2. **Boa iluminação** - Certifique-se que a tela está visível
3. **Distância correta** - Nem muito perto nem muito longe
4. **Tela limpa** - Limpe a tela do celular e monitor

## Problemas Relacionados

- [Erro de Conexão WhatsApp](#)
- [Sessão Desconectada](#)
- [WhatsApp Bloqueado](#)

## Prevenção

- Configure reconexão automática
- Salve credenciais para não precisar escanear sempre
- Mantenha o celular sempre conectado à internet