Troubleshooting OpenClaw — Soluções para Erros Comuns

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

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 chave de API.

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 travamentos.

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 rápido.

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 versão anterior.

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.

Gateway Não Inicia — Solução OpenClaw

O que fazer quando o gateway OpenClaw não sobe. Diagnóstico e correção de erros de inicializaçã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.

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.