Troubleshooting OpenClaw — Soluções para Erros Comuns
Resolva problemas do OpenClaw: erros de conexão WhatsApp, QR code expirado, bot não responde, gateway não inicia. Soluções testadas pela comunidade.
Solução de Problemas
Encontrou um erro? Soluções rápidas e testadas abaixo.
Diagnóstico Rápido
# Verificar status geral
openclaw doctor
# Ver logs em tempo real
openclaw gateway logs -f
# Reiniciar gateway
openclaw gateway restart
| Problema | Solução |
|---|---|
| Não conecta | Verificar internet, reiniciar |
| QR code expira | Limpar cache, tentar novamente |
| Desconecta sozinho | Manter celular online |
| Sessão desconectada | Reconectar dispositivo |
Telegram
| Problema | Solução |
|---|---|
| Token inválido | Gerar novo token no BotFather |
| Bot não responde | Verificar webhook |
🔌 Gateway
| Problema | Solução |
|---|---|
| Não inicia | Verificar Node.js, permissões |
| Porta em uso | Matar processo ou mudar porta |
| Config inválida | Validar YAML |
Bot
| Problema | Solução |
|---|---|
| Não responde | Verificar API key, logs |
| Respostas lentas | Verificar modelo, rede |
| Mensagens duplicadas | Uma instância apenas |
| Não envia | Verificar canal, rate limit |
🔐 Autenticação
| Problema | Solução |
|---|---|
| API key inválida | Verificar chave, provider |
| Erro SSL/TLS | Atualizar certificados |
| Permissão negada | Verificar sudo, chmod |
Performance
| Problema | Solução |
|---|---|
| Alto uso RAM | Limitar histórico, reiniciar |
| Memória cheia | Limpar logs, aumentar swap |
| Atualização falhou | Limpar cache npm |
🆘 Ainda com Problemas?
- Logs detalhados:
openclaw gateway logs -f - Discord: discord.gg/clawd
- GitHub Issues: github.com/openclaw/openclaw
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 API Key Inválida no OpenClaw
Corrija erros de autenticação 'Invalid API key' com Anthropic ou OpenAI. Aprenda a verificar, reconfigurar e testar sua …
QR Code Expirado — Solução WhatsApp
Como resolver quando o QR Code do WhatsApp expira antes de ser escaneado. Gerar novo QR rapidamente.
Sessão Desconectada — Reconexão OpenClaw
Como resolver quando a sessão do WhatsApp ou Telegram desconecta inesperadamente. Reconexão automática.
Porta em Uso (EADDRINUSE) — Solução
Como resolver erro EADDRINUSE quando a porta já está sendo usada. Liberar porta ocupada.
Erro de Permissão — EACCES OpenClaw
Como resolver erros de permissão ao executar o OpenClaw. Sudo, chmod e configuração Linux.
Token Telegram Inválido — Solução
Como resolver erro de token inválido ou expirado do bot Telegram. Gerar novo token no BotFather.
Webhook Não Funciona — Solução OpenClaw
Como resolver problemas com webhooks que não estão recebendo ou enviando dados. Debug de endpoints.
Mensagens Não Enviadas — Solução OpenClaw
Como resolver quando as mensagens não estão sendo enviadas pelo bot. Fila, rate limit e debug.
Erro SSL/TLS — Certificado OpenClaw
Como resolver erros de certificado SSL e conexões TLS. Validação, expiração e configuração HTTPS.
OpenClaw Consumindo Muita Memória RAM
Resolva o alto consumo de memória do OpenClaw. Aprenda a monitorar, limitar cache e otimizar uso de RAM para evitar …
Bot OpenClaw Não Responde? Solução em 2 Minutos
Seu bot está online mas não responde? 90% dos casos se resolvem em 2 minutos. Siga nosso fluxograma de diagnóstico …
Configuração Inválida — Erro YAML OpenClaw
Como resolver erros de configuração no arquivo YAML ou variáveis de ambiente. Sintaxe e validação.
Falha ao Atualizar o OpenClaw
Resolva erros de atualização do OpenClaw: permissão negada, cache corrompido, conflitos de versão. Inclui rollback para …
Erro de Permissões no Discord
Resolva problemas de permissões do bot OpenClaw no Discord: roles, channels, intents.
Telegram Não Recebe Mídia
Resolva problemas de envio e recebimento de fotos, vídeos e arquivos no Telegram com OpenClaw.
Número WhatsApp Banido ou Bloqueado
O que fazer quando seu número WhatsApp é banido e como prevenir bloqueio usando OpenClaw.
App do Slack Não Responde
Resolva problemas do app OpenClaw no Slack: tokens, events, permissões.
Bot do Discord Fica Offline
Resolva problemas do bot OpenClaw ficar offline no Discord: token, gateway, permissões.
Bot do Telegram Muito Lento
Otimize a velocidade do bot OpenClaw no Telegram: polling, webhook, performance.
OpenClaw Não Funciona em Grupos do WhatsApp
Configure o OpenClaw para funcionar corretamente em grupos do WhatsApp.
Mídia Não Funciona no WhatsApp
Resolva problemas de envio e recebimento de fotos, áudios e documentos no WhatsApp com OpenClaw.
Assistente Perde Contexto em Conversas Longas
Resolva perda de contexto em conversas longas no OpenClaw: memória, summarização, contexto.
Assistente Respondendo em Inglês
Force o OpenClaw a responder sempre em português brasileiro.
Custo de API de IA Muito Alto
Reduza custos com API de IA no OpenClaw: caching, model routing, otimização de prompts.
Modelo de IA Alucinando (Respostas Falsas)
Como lidar com alucinações de IA no OpenClaw: grounding, verificação, guardrails.
Respostas do Ollama com Qualidade Ruim
Melhore a qualidade das respostas de modelos locais no Ollama com OpenClaw.
Erro de Autenticação no Gemini
Resolva problemas de autenticação com a API do Google Gemini no OpenClaw.
GPT-4 Respondendo Muito Devagar
Otimize velocidade de resposta do GPT-4 no OpenClaw: streaming, modelo, prompt.
Erro 429 na API do Claude (Rate Limit)
Resolva erros de rate limit na API da Anthropic com OpenClaw: limites, retry, otimização.
Modelo Ollama Não Carrega
Resolva problemas ao carregar modelos locais no Ollama com OpenClaw: RAM, download, configuração.
Cenário do Make (Integromat) Falha
Resolva falhas de cenários entre OpenClaw e Make: webhook, dados, scheduling.
Zapier Webhook Dá Timeout
Resolva timeout de webhooks entre OpenClaw e Zapier: latência, payload, configuração.
Airtable Atinge Limite de Registros
Resolva problemas de limite de registros no Airtable com OpenClaw: otimização, arquivamento.
Configuração de Proxy Reverso (Nginx/Caddy)
Configure Nginx ou Caddy como proxy reverso para o OpenClaw: SSL, WebSocket, headers.
Issues do Jira Não São Criadas
Resolva problemas de criação de issues no Jira via OpenClaw: permissões, projetos, campos.
Contatos Duplicados no HubSpot
Resolva duplicação de contatos entre HubSpot e OpenClaw: deduplicação, merge, configuração.
Logs do OpenClaw Muito Grandes
Configure rotação de logs e reduza volume de logging do OpenClaw.
Performance Ruim com Múltiplos Usuários
Otimize o OpenClaw para lidar com muitos usuários simultâneos.
Stripe Não Notifica Pagamentos
Resolva problemas de integração entre Stripe e OpenClaw: webhooks, eventos, API keys.
Backup ou Restauração Falhou
Resolva problemas de backup e restauração do OpenClaw: dados, configuração, sessões.
Google Calendar Não Sincroniza
Resolva problemas de sincronização entre Google Calendar e OpenClaw: OAuth, permissões, eventos.
Pedidos do Shopify Não Aparecem
Resolva problemas de integração entre Shopify e OpenClaw: webhooks, API, permissões.
Servidor Sem Espaço em Disco
Resolva problemas de disco cheio que afetam o OpenClaw: logs, cache, dados.
Certificado SSL Expirado
Resolva problemas de certificado SSL expirado que afetam webhooks e conexões do OpenClaw.
Notion Não Sincroniza com OpenClaw
Resolva problemas de sincronização entre Notion e OpenClaw: API, permissões, databases.
Atualização Quebrou a Configuração
Resolva problemas após atualizar o OpenClaw: config incompatível, breaking changes.
Webhook do GitHub Não Funciona
Resolva problemas de webhook entre GitHub e OpenClaw: payload, secret, URL incorreta.
Container Docker do OpenClaw Crashando
Resolva crashes do container Docker do OpenClaw: memória, logs, configuração.
Gmail Não Conecta ao OpenClaw
Resolva problemas de conexão entre Gmail e OpenClaw: OAuth, permissões, tokens expirados.
Browser Control Não Funciona — Solução
Problemas com automação de navegador no OpenClaw. Puppeteer, Playwright e erros comuns.
Erro de SSL/TLS — Certificado OpenClaw
Como resolver erros de certificado SSL no OpenClaw. Certificados expirados, inválidos e configuração.
Memória Cheia / Alto Uso RAM — Solução
Otimize uso de memória do OpenClaw. Diagnóstico e redução de consumo de RAM.
Mensagens Duplicadas — Solução OpenClaw
Como resolver problema de mensagens duplicadas no OpenClaw. Causas e soluções.
OpenClaw Gateway Não Inicia? 7 Soluções Testadas (2026)
Resolvemos o erro 'gateway não inicia' do OpenClaw. Checklist rápido: porta ocupada, Node.js, permissões, .env. Copie os …
Respostas Lentas — Otimização OpenClaw
Otimize a velocidade de resposta do OpenClaw. Diagnóstico de lentidão e melhorias de performance.
Telegram Não Responde — Solução Bot
Como resolver quando o bot do Telegram para de responder. Diagnóstico e soluções.
WhatsApp Desconecta Sozinho — Solução
Como resolver WhatsApp que desconecta do OpenClaw. Causas comuns e soluções permanentes.