openclaw/docs/concepts
Forgely3D 4fa11632b4
fix: escalate to model fallback after rate-limit profile rotation cap (#58707)
* fix: escalate to model fallback after rate-limit profile rotation cap

Per-model rate limits (e.g. Anthropic Sonnet-only quotas) are not
relieved by rotating auth profiles — if all profiles share the same
model quota, cycling between them loops forever without falling back
to the next model in the configured fallbacks chain.

Apply the same rotation-cap pattern introduced for overloaded_error
(#58348) to rate_limit errors:

- Add `rateLimitedProfileRotations` to auth.cooldowns config (default: 1)
- After N profile rotations on a rate_limit error, throw FailoverError
  to trigger cross-provider model fallback
- Add `resolveRateLimitProfileRotationLimit` helper following the same
  pattern as `resolveOverloadProfileRotationLimit`

Fixes #58572

* fix: cap prompt-side rate-limit failover (#58707) (thanks @Forgely3D)

* fix: restore latest-main gates for #58707

---------

Co-authored-by: Ember (Forgely3D) <ember@forgely.co>
Co-authored-by: Peter Steinberger <steipete@gmail.com>
2026-04-01 17:54:10 +09:00
..
agent-loop.md docs: Batch 1 — create automation hub + add Related sections 2026-03-30 19:07:18 +09:00
agent-workspace.md docs: add Related sections to 10 concept pages 2026-03-31 14:34:56 +09:00
agent.md docs(agents): update steering semantics 2026-03-22 15:40:56 -07:00
architecture.md docs: add Related sections to 10 concept pages 2026-03-31 14:34:56 +09:00
compaction.md docs: add Related sections to 10 concept pages 2026-03-31 14:34:56 +09:00
context-engine.md docs: add Related sections to 10 concept pages 2026-03-31 14:34:56 +09:00
context.md docs: add Related sections to 10 concept pages 2026-03-31 14:34:56 +09:00
delegate-architecture.md docs: add delegate architecture guide for organizational deployments (#43261) 2026-03-20 09:23:17 -05:00
features.md fix: standardize 'MS Teams' to 'Microsoft Teams' across docs (#50863) 2026-03-19 23:54:47 -07:00
markdown-formatting.md fix: standardize 'MS Teams' to 'Microsoft Teams' across docs (#50863) 2026-03-19 23:54:47 -07:00
memory-builtin.md docs: deep audit of memory section -- fix icons, beef up engine pages, restructure config reference 2026-03-30 08:39:18 +09:00
memory-honcho.md docs: deep audit of memory section -- fix icons, beef up engine pages, restructure config reference 2026-03-30 08:39:18 +09:00
memory-qmd.md docs(memory): clarify qmd symlink traversal limits 2026-03-31 17:54:00 +09:00
memory-search.md docs: add dedicated memory engine pages, replace ASCII diagram with Mermaid 2026-03-30 07:34:14 +09:00
memory.md docs: deep audit of memory section -- fix icons, beef up engine pages, restructure config reference 2026-03-30 08:39:18 +09:00
messages.md docs: add Related sections to 10 concept pages 2026-03-31 14:34:56 +09:00
model-failover.md fix: escalate to model fallback after rate-limit profile rotation cap (#58707) 2026-04-01 17:54:10 +09:00
model-providers.md docs: add Related sections to 10 concept pages 2026-03-31 14:34:56 +09:00
models.md fix: queue model switches behind busy runs 2026-04-01 16:14:10 +09:00
multi-agent.md feat(memory): add per-agent QMD extra collections for cross-agent session search (#58211) 2026-03-31 17:08:18 +09:00
oauth.md docs: add Related sections to 10 concept pages 2026-03-31 14:34:56 +09:00
presence.md docs: fix curly quotes, non-breaking hyphens, and remaining apostrophes in headings 2026-03-18 01:31:38 -07:00
queue.md docs: add background tasks cross-references across 6 doc pages 2026-03-30 16:42:47 +09:00
retry.md
session-pruning.md docs: simplify sessions/memory concept pages and fix QMD experimental label 2026-03-30 07:32:20 +09:00
session-tool.md docs: simplify sessions/memory concept pages and fix QMD experimental label 2026-03-30 07:32:20 +09:00
session.md docs: Batch 1 — create automation hub + add Related sections 2026-03-30 19:07:18 +09:00
streaming.md docs: add Related sections to 10 concept pages 2026-03-31 14:34:56 +09:00
system-prompt.md
timezone.md docs: Batch 1 — create automation hub + add Related sections 2026-03-30 19:07:18 +09:00
typebox.md docs: fix curly quotes, non-breaking hyphens, and remaining apostrophes in headings 2026-03-18 01:31:38 -07:00
typing-indicators.md
usage-tracking.md