Solução de Problemas

Encontrou um erro? Soluções rápidas e testadas abaixo.

resolver um problema

Qual é o problema?

Escolha o sintoma e receba o comando de diagnóstico para copiar e os guias certos para resolver.

Não achou seu caso? Veja todos os guias de troubleshooting ou rode openclaw doctor para um diagnóstico completo.

Diagnóstico Rápido

# Verificar status geral
openclaw doctor

# Ver logs em tempo real
openclaw gateway logs -f

# Reiniciar gateway
openclaw gateway restart

WhatsApp

ProblemaSolução
Não conectaVerificar internet, reiniciar
QR code expiraLimpar cache, tentar novamente
Desconecta sozinhoManter celular online
Sessão desconectadaReconectar dispositivo

Telegram

ProblemaSolução
Token inválidoGerar novo token no BotFather
Bot não respondeVerificar webhook

Gateway

ProblemaSolução
Não iniciaVerificar Node.js, permissões
Porta em usoMatar processo ou mudar porta
Config inválidaValidar YAML

Bot

ProblemaSolução
Não respondeVerificar API key, logs
Respostas lentasVerificar modelo, rede
Mensagens duplicadasUma instância apenas
Não enviaVerificar canal, rate limit

Autenticação

ProblemaSolução
API key inválidaVerificar chave, provider
Erro SSL/TLSAtualizar certificados
Permissão negadaVerificar sudo, chmod

Performance

ProblemaSolução
Alto uso RAMLimitar histórico, reiniciar
Memória cheiaLimpar logs, aumentar swap
Atualização falhouLimpar cache npm

🆘 Ainda com Problemas?

  1. Logs detalhados: openclaw gateway logs -f
  2. Discord: discord.gg/clawd
  3. GitHub Issues: github.com/openclaw/openclaw