openclaw/docs
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
..
.generated fix: escalate to model fallback after rate-limit profile rotation cap (#58707) 2026-04-01 17:54:10 +09:00
.i18n Docs: add zh-CN Diffs page 2026-03-29 19:48:08 -04:00
assets docs: add theme-aware sponsor logos 2026-04-01 07:14:05 +09:00
automation docs: add /tasks chat command, cleanup-aware status, and QQ Bot troubleshooting 2026-04-01 16:46:04 +09:00
channels docs: add WhatsApp reactionLevel and Feishu Drive comment actions 2026-04-01 16:56:47 +09:00
cli docs: clarify doctor cron migration guidance 2026-04-01 16:44:10 +09:00
concepts fix: escalate to model fallback after rate-limit profile rotation cap (#58707) 2026-04-01 17:54:10 +09:00
debug
diagnostics
gateway fix: escalate to model fallback after rate-limit profile rotation cap (#58707) 2026-04-01 17:54:10 +09:00
help test: require Claude 4.6 for Anthropic live selection 2026-03-31 16:41:50 +01:00
images docs(feishu): Feishu docs – add verificationToken and align zh-CN with EN (openclaw#31555) thanks @xbsheng 2026-03-02 21:33:41 -06:00
install build: bump version to 2026.4.1 2026-03-31 22:53:17 +01:00
ja-JP docs update web search config guidance 2026-03-18 00:00:17 -05:00
nodes docs(nodes): remove nodes.run references 2026-03-30 00:41:06 +01:00
platforms docs: update docs for unreleased channel and gateway changes 2026-04-01 02:20:44 +09:00
plugins Fix: move bootstrap session grammar into plugin-owned session-key surfaces (#58400) 2026-03-31 19:41:01 -04:00
providers docs(anthropic): note oauth context1m fallback 2026-04-01 09:21:49 +01:00
reference feat: add agents.defaults.params for global default provider params (#58548) 2026-03-31 21:09:07 -04:00
security docs: fix oxfmt formatting in remote.md and THREAT-MODEL-ATLAS.md 2026-03-31 14:36:49 +09:00
snippets/plugin-publish [codex] harden clawhub plugin publishing and install (#56870) 2026-03-29 11:59:19 -07:00
start fix(media): align outbound sends with fs read capability 2026-04-01 00:07:50 +09:00
tools docs: add /tasks chat command, cleanup-aware status, and QQ Bot troubleshooting 2026-04-01 16:46:04 +09:00
web docs: add Related sections to plugin and web interface pages 2026-03-31 14:34:56 +09:00
zh-CN docs(i18n): sync zh-CN node exec wording 2026-03-30 00:57:27 +01:00
auth-credential-semantics.md Secrets: hard-fail unsupported SecretRef policy and fix gateway restart token drift (#58141) 2026-03-31 02:37:31 -05:00
brave-search.md fix(docs): deduplicate titles across 9 pages 2026-03-22 16:02:28 -07:00
ci.md fix(ci): skip docs-only preflight pnpm audit 2026-03-23 05:29:27 +00:00
date-time.md
docs.json Feature/add qq channel (#52986) 2026-03-31 16:13:16 +08:00
index.md fix(runtime): support Node 22.14 installs 2026-03-25 06:22:18 -07:00
logging.md docs: fix Gateway & Ops audit findings (7 pages) 2026-03-31 14:24:19 +09:00
nav-tabs-underline.js
network.md docs: merge network-model stub into network hub, improve bridge deprecation 2026-03-31 14:37:43 +09:00
perplexity.md fix(docs): deduplicate titles across 9 pages 2026-03-22 16:02:28 -07:00
pi-dev.md docs(plugins): refresh bundled plugin runtime docs 2026-03-29 09:10:39 +01:00
pi.md docs(plugins): refresh bundled plugin runtime docs 2026-03-29 09:10:39 +01:00
prose.md docs(plugins): refresh bundled plugin runtime docs 2026-03-29 09:10:39 +01:00
style.css fix(ios): force tls for non-loopback manual gateway hosts (#21969) 2026-02-20 16:28:47 +00:00
tts.md feat(tts): add structured provider diagnostics and fallback attempt analytics (#57954) 2026-03-30 22:55:28 -05:00
vps.md docs: rename VPS to Linux Server, update provider links for moved pages 2026-03-19 13:29:39 -07:00
whatsapp-openclaw-ai-zh.jpg
whatsapp-openclaw.jpg