openclaw - 💡(How to fix) Fix [Feature]: Include retry/reset time in rate limit error messages [1 participants]

Official PRs (…)
ON THIS PAGE

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#59876Fetched 2026-04-08 02:39:25
View on GitHub
Comments
0
Participants
1
Timeline
1
Reactions
0
Author
Participants
Timeline (top)
labeled ×1

Rate limit errors should show the reset/wait time instead of just "try again later."

Error Message

When the upstream model provider (e.g. Anthropic subscription) returns a rate limit error, the user-facing message is: OpenClaw already tracks cooldownUntil and retryAfterMs internally for auth profile failover. It would be helpful to surface this in the error message shown to the user, e.g.: Include retry/reset time in rate limit error messages

Root Cause

Rate limit errors should show the reset/wait time instead of just "try again later."

RAW_BUFFERClick to expand / collapse

Summary

Rate limit errors should show the reset/wait time instead of just "try again later."

Problem to solve

When the upstream model provider (e.g. Anthropic subscription) returns a rate limit error, the user-facing message is:

:warning: API rate limit reached. Please try again later.

OpenClaw already tracks cooldownUntil and retryAfterMs internally for auth profile failover. It would be helpful to surface this in the error message shown to the user, e.g.:

:warning: API rate limit reached. Try again in ~2 minutes.

This helps users know whether to wait 30 seconds, 10 minutes or 3 hours.

Proposed solution

Include retry/reset time in rate limit error messages

Alternatives considered

No response

Impact

Affected users Severity annoying Frequency when api limit reached Consequence not knowing when to continue

Evidence/examples

No response

Additional information

No response

extent analysis

TL;DR

Update the rate limit error message to include the retry/reset time, such as "Try again in ~X minutes", where X is the value of retryAfterMs or cooldownUntil.

Guidance

  • Review the current implementation of rate limit error handling to identify where the error message is constructed and returned to the user.
  • Modify the error message construction to include the retryAfterMs or cooldownUntil value, which is already tracked internally.
  • Consider formatting the retry time in a user-friendly way, such as converting milliseconds to minutes or seconds.
  • Test the updated error message to ensure it is correctly displayed to the user when a rate limit error occurs.

Example

error_message = f":warning: API rate limit reached. Try again in ~{retryAfterMs /

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING