Depure e corrija problemas comuns do assistente de IA Clawdbot. Aprenda a diagnosticar problemas de conexão, falhas de mensagens e erros do gateway.

Visão Geral da Solução de Problemas do Clawdbot

Este guia ajuda você a diagnosticar e corrigir problemas comuns com sua implantação do Clawdbot. Encontre soluções para problemas de conexão, falhas de mensagens e erros do gateway.

Problemas Comuns

Gateway Não Inicia

Sintomas: Gateway falha ao iniciar ou encerra imediatamente.

Soluções:

Verificar disponibilidade da porta:

lsof -i :3010

Validar configuração:

clawdbot config validate

Verificar logs:

clawdbot gateway logs

Conexão WhatsApp Falhou

Sintomas: Código QR não aparece ou a conexão cai.

Soluções:

Limpar sessão do WhatsApp:

rm -rf ~/.clawdbot/providers/whatsapp/session

Reiniciar gateway:

clawdbot gateway restart

Verificar conectividade de rede

Mensagens Não Entregues

Sintomas: Mensagens enviadas mas não recebidas.

Soluções:

Verificar status da sessão:

clawdbot sessions list

Verificar conexão do provedor:

clawdbot providers status

Verificar limites de taxa

Agente Não Responde

Sintomas: Agente não gera respostas.

Soluções:

Verificar status do agente:

clawdbot agents status

Verificar chave API:

echo $ANTHROPIC_API_KEY

Verificar disponibilidade do modelo

Comandos de Diagnóstico

Status do Gateway

# Verificar saúde do gateway
clawdbot gateway status

# Ver conexões ativas
clawdbot gateway connections

# Mostrar uso de recursos
clawdbot gateway stats

Diagnóstico de Sessões

# Listar todas as sessões
clawdbot sessions list

# Ver detalhes da sessão
clawdbot sessions get <session-key>

# Limpar sessão travada
clawdbot sessions clear <session-key>

Diagnóstico de Provedores

# Verificar status do provedor
clawdbot providers status

# Testar conexão do provedor
clawdbot providers test whatsapp

# Reconectar provedor
clawdbot providers reconnect telegram

Análise de Logs

Habilitar Log de Debug

clawdbot gateway start --log-level debug

Localizações dos Logs

Log	Localização
Gateway	`~/.clawdbot/logs/gateway.log`
Provedores	`~/.clawdbot/logs/providers/`
Agentes	`~/.clawdbot/logs/agents/`

Níveis de Log

Nível	Descrição
`error`	Apenas erros
`warn`	Avisos e erros
`info`	Informações gerais
`debug`	Informações detalhadas de debug

Códigos de Erro

Erros de Conexão

Código	Descrição	Solução
`ECONNREFUSED`	Porta não aberta	Verifique se o gateway está rodando
`ETIMEDOUT`	Timeout de rede	Verifique a rede
`EAUTH`	Autenticação falhou	Verifique as credenciais

Erros de Provedor

Código	Descrição	Solução
`WA_DISCONNECTED`	WhatsApp desconectado	Re-escaneie o QR
`TG_INVALID_TOKEN`	Token do Telegram inválido	Verifique o token
`DC_MISSING_INTENTS`	Intents do Discord faltando	Habilite os intents

Problemas de Desempenho

Respostas Lentas

Causas:

Alto volume de mensagens
Tamanho de contexto grande
Latência de rede

Soluções:

Habilitar streaming
Reduzir tamanho do contexto
Verificar rede

Uso de Memória

Verificar memória:

clawdbot gateway stats --memory

Reduzir memória:

{
  "gateway": {
    "messageBuffer": 500,
    "maxHistory": 50
  }
}

Procedimentos de Recuperação

Resetar Gateway

# Parar gateway
clawdbot gateway stop

# Limpar estado
clawdbot gateway reset --state

# Reiniciar
clawdbot gateway start

Resetar Provedor

# Desconectar provedor
clawdbot providers disconnect whatsapp

# Limpar dados do provedor
rm -rf ~/.clawdbot/providers/whatsapp

# Reconfigurar
clawdbot providers setup whatsapp

Resetar Agente

# Limpar sessões do agente
clawdbot agents reset main --sessions

# Limpar workspace do agente
clawdbot agents reset main --workspace

Obtendo Ajuda

Recursos de Suporte

Documentação: https://docs.clawdbotai.app
GitHub Issues: https://github.com/clawdbot/clawdbot/issues
Discord da Comunidade: https://discord.gg/clawdbot

Relatórios de Bugs

Incluir nos relatórios de bugs:

Versão do Clawdbot
Sistema operacional
Mensagens de erro
Passos para reproduzir

Próximos Passos

Configuração do Clawdbot - Guia de configuração
Segurança do Clawdbot - Configuração de segurança
Clawdbot Gateway - Visão geral do gateway

Solução de Problemas do Clawdbot

On this page