Problemas Comuns
FAQ tecnico com diagnosticos e solucoes rapidas.
Abaixo estao os problemas mais frequentes reportados pelos usuarios, com diagnostico e solucao para cada um. Se o seu problema nao esta listado, verifique tambem os Codigos de Erro e o Guia de Status.
Bot nao responde no Telegram
Sintoma: Voce envia mensagens para o agente no Telegram, mas ele nao responde.
Causa: Pode ser o status do agente, token do Telegram incorreto ou creditos insuficientes.
Solucao:
- Verifique o status do agente no dashboard. Ele precisa estar
running(verde). Se estiver parado, clique em "Iniciar" - Verifique o token do Telegram na tab Secrets & API Keys. O token deve ser o mesmo gerado pelo @BotFather. Se voce regenerou o token no BotFather, atualize-o tambem no QuickClaw
- Verifique seus creditos. Se ambos (assinatura e avulso) estao zerados, o agente nao responde. Faca um top-up ou aguarde a renovacao
API key invalida
Sintoma: O agente exibe alerta auth_error na tab Overview.
Causa: A chave de API configurada esta incorreta, expirada ou foi revogada pelo provedor.
Solucao:
- Verifique se a chave esta no formato correto para o provedor:
- Anthropic: comeca com
sk-ant- - OpenAI: comeca com
sk- - Google: formato alfanumerico
- OpenRouter: comeca com
sk-or-
- Anthropic: comeca com
- Acesse o painel do provedor e verifique se a chave ainda e valida. Chaves podem ser revogadas ou expirar automaticamente
- Se necessario, gere uma nova chave no provedor e atualize-a na tab Secrets & API Keys do QuickClaw
- Certifique-se de que o provedor selecionado no agente corresponde ao provedor da chave (nao use uma chave Anthropic com o provedor OpenAI)
Creditos acabaram
Sintoma: O agente esta com status running mas nao responde mensagens.
Causa: Ambos os tipos de creditos (assinatura e avulso) estao zerados.
Solucao:
- Verifique o saldo na tab Overview do agente. Se o indicador de creditos esta em 0% ou exibe alerta amarelo, os creditos acabaram
- Faca um top-up de creditos para restaurar imediatamente. Os creditos ficam disponiveis em segundos apos a confirmacao do pagamento
- Alternativamente, aguarde a renovacao mensal dos creditos de assinatura. A data de renovacao e exibida na pagina de Assinatura
Seu agente nao e deletado
Creditos zerados apenas bloqueiam as chamadas de IA. O agente continua rodando, suas configuracoes e memoria permanecem intactas. Basta adicionar creditos para retomar o funcionamento.
Bot mostra status "error"
Sintoma: O agente aparece com status error (vermelho) no dashboard.
Causa: Erro interno detectado — pode ser falha no container, API key invalida ou problema no provedor.
Solucao:
- Verifique o alerta na tab Overview. O BotAlertBanner exibe o codigo de erro especifico e a acao recomendada
- Verifique sua API key. Erros de autenticacao sao a causa mais comum de status error
- Tente reiniciar o agente clicando em "Reiniciar" no dashboard. Muitos erros transientes sao resolvidos com um restart
- Se o problema persistir, consulte os Codigos de Erro para diagnostico especifico
Skill com status "error"
Sintoma: Uma skill instalada aparece com indicador de erro (amarelo) na tab Skills.
Causa: Falha na instalacao, configuracao incorreta ou arquivo corrompido.
Solucao:
- Clique no botao de reinstalacao (icone amarelo) ao lado da skill com erro. Isso baixa e instala uma copia limpa da skill
- Verifique se a skill requer configuracao adicional. Algumas skills precisam de API keys ou parametros especificos para funcionar
- Se a reinstalacao nao resolver, remova a skill e instale-a novamente do catalogo
Login nao funciona
Sintoma: Voce nao consegue acessar o dashboard.
Causa: Senha incorreta, email nao confirmado ou 2FA ativo.
Solucao:
- Verifique se voce esta usando a senha correta. Se esqueceu, use o link "Esqueci minha senha" na tela de login
- Verifique se seu email foi confirmado. Apos o cadastro, voce recebe um email de confirmacao que precisa ser clicado antes de acessar
- Se voce tem 2FA (MFA) ativado, a tela de verificacao TOTP aparecera apos o login. Use o app autenticador (Google Authenticator, Authy, etc.) para gerar o codigo de 6 digitos
- Se perdeu acesso ao app autenticador, entre em contato com suporte@myquickclaw.com para desativar o 2FA manualmente
Checkout nao completa
Sintoma: O pagamento nao e processado ao criar um agente ou fazer top-up.
Causa: Pop-up bloqueado pelo navegador, cartao recusado ou problema temporario no Stripe.
Solucao:
- Verifique se o bloqueador de pop-ups esta desativado para myquickclaw.com. O checkout do Stripe abre em uma nova aba
- Se o cartao foi recusado, verifique se ha saldo disponivel, se o cartao permite compras internacionais e se os dados estao corretos
- Tente com outro cartao. O Stripe aceita Visa, Mastercard, American Express e outros
- Aguarde alguns minutos e tente novamente. Problemas temporarios no Stripe sao raros mas podem ocorrer
Compras internacionais
O processamento e feito pelo Stripe em USD. Alguns cartoes brasileiros podem bloquear transacoes internacionais por padrao. Se necessario, habilite compras internacionais no app do seu banco antes de tentar novamente.
