← All fixes
429OpenClaw· Rate limits

OpenClaw “API rate limit reached” (429)

API rate limit reached
Quick answer

OpenClaw shows “rate limit reached” when its model provider returns a 429. The same message can come from several sources — provider RPM/TPM limits, a provider in cooldown, or no fallback configured — but it almost always traces back to an upstream provider throttling you.

What causes it

How to fix it

  1. Configure fallback models in openclaw.json so OpenClaw reroutes when one provider is throttled.
  2. Reduce heartbeat frequency and concurrency to lower background load.
  3. Check provider status with your model dashboard, and upgrade the provider tier for higher limits.
  4. Use a provider without per-minute caps so background activity can’t exhaust the budget.
Running an agent?

OpenClaw’s heartbeats and retries are the usual culprit — they can burn a large share of a per-minute quota before you send a single message.

The permanent fix

Stop hitting this entirely

Point OpenClaw at Standard Compute (base URL https://api.stdcmpt.com/v1, model “standardcompute”): there’s no per-minute limit to hit, it auto-routes across providers so you never hand-configure fallbacks, and it degrades gracefully under load instead of returning 429s that stall the agent.

Get a free API key →How it connects →

FAQ

Why does OpenClaw hit rate limits when I’m not even using it?

Background heartbeats, transient-failure retries, and parallel tool calls keep making provider requests. On a small per-minute quota, that background load alone can trigger 429s.

What’s the most reliable fix?

Configure fallbacks so a throttled provider doesn’t stall everything — or use a provider with no per-minute cap and built-in failover, so the 429 never reaches OpenClaw.

Related errors

Why your AI agent keeps getting rate limited (and how to stop it)Any agent“Quota exceeded — please use your own API key” explainedAgent / app429 Too Many Requests — what it means & how to fixAny provider · 429