Erro Rate Limited — Limite de Requisições

Como resolver erro de rate limit no OpenClaw. Causas, soluções e como evitar limites de API.

Erro: Rate Limited

Você atingiu o limite de requisições da API. Aqui está como resolver.

O Que Significa
Error: Rate limit exceeded. Please retry after 60 seconds.

As APIs de IA (Anthropic, OpenAI) limitam quantas requisições você pode fazer por minuto/hora. Isso protege contra uso abusivo e garante disponibilidade.

Causas Comuns1. Muitas Mensagens Rápidas

Enviou várias mensagens em sequência sem esperar resposta.

2. Loops de Automação

Cron job ou heartbeat mal configurado gerando requisições excessivas.

3. Uso em Múltiplos Dispositivos

Mesmo API key usada em várias instâncias simultaneamente.

4. Tier Baixo da API

Contas novas têm limites mais restritivos.

Limites TípicosAnthropic (Claude)
TierRPMTPM
Free510K
Tier 16040K
Tier 2100080K
OpenAI (GPT-4)
TierRPMTPM
Free310K
Tier 16060K
Tier 2+5000+450K+

RPM = Requests per minute, TPM = Tokens per minute

SoluçõesSolução Imediata

Espere e tente novamente:

O erro diz quanto esperar. Geralmente 30-60 segundos.
Solução de Configuração

Configure retry automático:

# config.yaml
api:
  retry:
    enabled: true
    max_retries: 3
    backoff: exponential
Solução para Automações

Adicione delays:

# Cron com intervalo adequado
heartbeat:
  interval: 5m  # Não menos que 5 minutos
Solução para Alto Volume

Use modelo mais barato para tarefas simples:

models:
  default: claude-3-5-sonnet
  simple: claude-3-haiku  # Rate limits mais altos
Evitar Rate Limits1. Batching

Agrupe múltiplas perguntas em uma mensagem.

2. Caching

Não repita a mesma pergunta. Use memória.

3. Escalonamento

Distribua requisições ao longo do tempo.

4. Upgrade de Tier

Aumente limite pagando mais na API.

Verificar StatusUso Atual
# Dashboard Anthropic
https://console.anthropic.com/settings/usage

# Dashboard OpenAI
https://platform.openai.com/usage
Via OpenClaw
"Qual meu uso de API hoje?"
Quando Contatar Suporte
  • Limites muito restritivos para seu uso
  • Erro persiste mesmo após esperar
  • Precisa de limites maiores que Tier 2
Próximos Passos