“Rate limit exceeded” significa “limite de requisições excedido”. No OpenClaw, quando o erro vem da API do modelo, pause as automações que geram chamadas, respeite o tempo de espera informado e teste uma única mensagem. Se o erro mencionar cota, créditos ou faturamento, esperar não resolve: confira a conta do provedor. O código HTTP 429 sozinho não identifica qual desses casos ocorreu.
Este guia trata de chamadas de modelos no OpenClaw. A mensagem também aparece em outros aplicativos, mas os limites e as correções dependem do serviço que a emitiu.
Diagnóstico rápido: limite temporário ou cota esgotada?
Mensagens como rate_limited, rate_limit_exceeded e Rate limit exceeded. Please try again later. indicam uma restrição de uso. Leia também o corpo do erro, o nome do provedor e, quando disponível, o cabeçalho de resposta.
| Sinal observado | O que verificar | Próxima ação |
|---|---|---|
| Erro após muitas mensagens ou tarefas simultâneas | Requisições por minuto e concorrência | Pause a fila, aguarde o prazo informado e retome com menos chamadas simultâneas |
| Erro após enviar documentos grandes | Tokens por minuto, tamanho do histórico e saída solicitada | Reduza contexto desnecessário e divida o trabalho em etapas menores |
Resposta com Retry-After | Tempo mínimo antes de tentar novamente | Respeite o valor; não dispare novas tentativas durante a espera |
Erro menciona insufficient_quota, créditos ou limite de gasto | Saldo, faturamento e limites da organização ou projeto | Corrija a condição da conta antes de repetir a chamada |
| Erro persiste com uma única mensagem curta | Modelo, credencial, limite compartilhado e status do serviço | Confira o painel do provedor e registre o erro completo sem segredos |
Não existe uma tabela universal de limites para Claude ou GPT. Os valores dependem de modelo, conta, projeto, faixa de uso e políticas do provedor. Consulte os limites da sua conta em vez de copiar números de outro usuário. RPM significa requisições por minuto; TPM, tokens por minuto. Uma chamada longa pode atingir TPM mesmo com poucas mensagens.
Como resolver no OpenClaw em 5 passos
1. Pause a origem das chamadas
Interrompa temporariamente tarefas agendadas, heartbeats ou integrações que estejam repetindo pedidos. Verifique se várias instâncias usam o mesmo projeto ou organização de API: o consumo pode ser compartilhado conforme as regras do provedor.
Não reenfileire tudo imediatamente. Uma automação que tenta de novo sem pausa pode prolongar o problema e acumular trabalho duplicado.
2. Identifique o provedor nos logs
Use os comandos de diagnóstico documentados pelo OpenClaw:
openclaw status
openclaw gateway status
openclaw logs --follow
Procure o horário da falha, o provedor, o modelo e o texto do erro. Interrompa o acompanhamento com Ctrl+C quando tiver a informação necessária. Se houver suspeita de configuração inválida, rode também:
openclaw doctor
Esses comandos ajudam a localizar a falha; não aumentam o limite da API. Antes de compartilhar logs, remova chaves, tokens, dados pessoais e conteúdo das conversas.
3. Confira espera, consumo e faturamento
Se a resposta trouxer Retry-After, respeite esse prazo mínimo. Não presuma que todo limite se renova em 30 ou 60 segundos: a janela pode ser diferente.
No painel do provedor, confira o modelo afetado, os limites de requisições e tokens, o saldo e eventuais tetos de gasto. Se a mensagem indicar cota esgotada, trate a causa da conta. Reiniciar o OpenClaw ou gerar outra chave no mesmo projeto não cria uma nova cota automaticamente.
4. Teste uma única mensagem curta
Depois da espera ou da correção de faturamento, envie um pedido curto, sem anexos nem tarefas paralelas. Se funcionar, retome a fila aos poucos. Se falhar, anote o novo erro antes de alterar qualquer outra variável.
Trocar para um modelo mais barato pode reduzir custos, mas não garante limites maiores. Só use outro modelo se ele tiver capacidade disponível, suportar as ferramentas necessárias e respeitar a política de dados do fluxo. Veja o comparativo de modelos para avaliar essa escolha.
5. Evite repetir ações externas
Antes de executar novamente uma automação, confirme se uma etapa anterior já enviou uma mensagem, criou um registro ou alterou um arquivo. Repetir a chamada ao modelo não significa que repetir todo o workflow seja seguro.
Em integrações próprias, use uma fila com concorrência limitada, número máximo de tentativas e espera progressiva com pequena variação aleatória (backoff com jitter). Respeite Retry-After quando presente e não repita indefinidamente erros de cota. Verifique se o SDK já faz retentativas para não somar duas camadas de retry.
As opções de configuração variam por versão e integração. Consulte a documentação correspondente antes de editar o OpenClaw; um bloco genérico de config.yaml não é uma configuração validada para o produto.
Como evitar que o erro volte
- Controle concorrência: distribua os pedidos em vez de iniciar todos no mesmo segundo.
- Revise agendamentos: um heartbeat muito frequente ou um loop sem condição de parada gera chamadas mesmo sem novas mensagens.
- Reduza tokens desnecessários: não reenvie documentos e históricos completos quando um trecho basta.
- Reutilize resultados quando fizer sentido: cache de tarefas idênticas reduz chamadas, desde que não exponha dados nem devolva informação vencida.
- Monitore por modelo e projeto: registre falhas, tokens e chamadas para descobrir a origem do pico.
- Peça aumento de limite apenas com evidência: volume legítimo e estável pode justificar a solicitação, sujeita às regras do provedor.
Para dimensionar o orçamento, veja o guia de custos. Para tarefas que possam rodar no seu hardware, Ollama é uma alternativa à API de nuvem, mas continua limitado por memória, velocidade e capacidade da máquina.
Quando procurar suporte
Procure o provedor se uma única chamada curta continuar falhando após o prazo indicado e a conta estiver regular. Inclua horário com fuso, modelo, tipo de limite e identificador da requisição, se disponível. Nunca envie a chave de API.
Se os logs mostrarem que a chamada ao modelo funciona, mas o canal não entrega a resposta, investigue separadamente o troubleshooting do OpenClaw. Um erro de API não é o mesmo problema que uma sessão de WhatsApp desconectada.
Perguntas frequentes
O que significa rate limited em português?
Significa que o serviço limitou as requisições. “Rate limit exceeded” pode ser traduzido como “limite de requisições excedido”. Na API de um modelo, a restrição pode envolver quantidade de chamadas, tokens ou outra condição de uso; leia o erro completo.
Quanto tempo devo esperar depois do erro 429?
Respeite o prazo da mensagem ou o cabeçalho Retry-After, quando presente. Não há um tempo universal. Se a causa for cota, créditos ou faturamento, esperar não basta: é necessário corrigir a condição da conta.
Erro 429 significa que meus créditos acabaram?
Não necessariamente. Ele pode indicar um limite temporário de chamadas ou tokens. Na OpenAI, erros de cota ou limites de gasto também podem retornar 429. O corpo da resposta e o painel da conta ajudam a distinguir os casos.
Reiniciar o OpenClaw resolve rate limit?
Reiniciar não aumenta o limite do provedor nem repõe créditos. Primeiro pause a origem das chamadas e identifique a restrição nos logs. Um loop que continua ativo pode voltar a gerar o mesmo erro após o reinício.
Trocar a chave de API ou o modelo resolve?
Não há garantia. Chaves podem compartilhar limites de projeto ou organização, e modelos podem ter limites compartilhados ou próprios. Confira a capacidade disponível no painel e valide ferramentas, custo e privacidade antes de trocar.
Fontes e próximos passos
- OpenAI: limites de API e tratamento de retentativas
- Anthropic: limites de API
- OpenClaw: comandos oficiais de troubleshooting
- FAQ de custos — consumo e orçamento
- Comparativo de modelos — escolha por tarefa
- Troubleshooting — outros sintomas