QR Code Expirado — Solução WhatsApp
Como resolver quando o QR Code do WhatsApp expira antes de ser escaneado. Gerar novo QR rapidamente.
⏱️ 2 min de leitura
QR Code Expirado
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
- Demora para escanear - QR Code tem validade de ~60 segundos
- Problemas de rede - Conexão lenta impedindo autenticação
- WhatsApp no celular sem internet - Celular offline
- Câmera com problema - QR Code não está sendo lido corretamente
- Versão antiga do WhatsApp - App desatualizado no celular
# Reiniciar gateway para novo QR
openclaw gateway restart
# Ou parar e iniciar
openclaw gateway stop
openclaw gateway start
# No arquivo de configuração
whatsapp:
qr_timeout: 120 # 2 minutos
auto_reconnect: true
# Exibir QR Code como ASCII no terminal
openclaw gateway start --qr-terminal
# Isso permite escanear diretamente do terminal
# sem precisar abrir navegador
- Abra o WhatsApp no celular
- Envie uma mensagem para qualquer contato
- Se funcionar, o celular está online
- Tente escanear o QR Code novamente
# 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
No celular:
- Vá na App Store / Play Store
- Procure por WhatsApp
- Atualize se houver versão nova
- Prepare o celular antes - Abra a câmera de QR do WhatsApp
- Boa iluminação - Certifique-se que a tela está visível
- Distância correta - Nem muito perto nem muito longe
- Tela limpa - Limpe a tela do celular e monitor
- Configure reconexão automática
- Salve credenciais para não precisar escanear sempre
- Mantenha o celular sempre conectado à internet