Guia de Status do Bot
O que cada status significa e o que fazer.
Visao geral
Cada agente no QuickClaw tem um status que indica sua situacao atual. O status e exibido como um indicador colorido no dashboard, tanto na lista de bots quanto na pagina de detalhes.
Entender o significado de cada status ajuda voce a diagnosticar problemas rapidamente e saber exatamente o que fazer em cada situacao.
Sincronizacao automatica
O status do agente e sincronizado automaticamente entre o container na VPS e o banco de dados. Mudancas de status sao refletidas no dashboard em tempo real via polling.
running
Significado: Agente esta online, respondendo a mensagens normalmente.
Acao: Nenhuma acao necessaria. Tudo esta funcionando.
stopped
Significado: Agente foi parado manualmente pelo usuario. O container esta inativo e nao responde mensagens.
Acao: Clique em "Iniciar" no dashboard para retomar. O agente voltara ao status running em poucos segundos.
provisioning
Significado: Agente esta sendo configurado pela primeira vez. O container esta sendo criado, dependencias instaladas e skills copiadas.
Acao: Aguarde aproximadamente 30 segundos. O processo e automatico. O status mudara para running quando concluido.
error
Significado: Erro detectado no agente. Pode ser falha de API key, problema no container ou erro no provedor de IA.
Acao: Verifique o alerta na tab Overview para identificar o erro especifico. Tente reiniciar o agente. Se persistir, verifique sua API key.
pending_payment
Significado: Aguardando confirmacao de pagamento. O checkout foi iniciado mas ainda nao foi concluido ou confirmado pelo Stripe.
Acao: Complete o checkout no Stripe. Se o pagamento ja foi feito, aguarde alguns segundos para a sincronizacao via webhook.
suspended
Significado: Agente foi suspenso devido a uma disputa de pagamento (chargeback) ou deteccao de abuso (mineracao de cripto, flood de rede).
Acao: Contate o suporte em suporte@myquickclaw.com. Suspensoes por disputa sao resolvidas quando o caso e encerrado no Stripe. Suspensoes por abuso requerem investigacao.
maintenance
Significado: Agente esta em manutencao programada ou automatica. Pode ocorrer durante atualizacoes de seguranca ou migracao de infraestrutura.
Acao: Aguarde a resolucao automatica. Manutencoes sao tipicamente curtas (menos de 5 minutos). O agente voltara ao status anterior quando concluida.
Status mais comum de problema
Se seu agente esta em error, verifique primeiro os Codigos de Erro para entender a causa especifica. A maioria dos erros e resolvida verificando a API key ou reiniciando o agente.
