Skip to main content

Troubleshooting

Fixes for common AI errors: what 429, 403, and 500 responses mean, rate limit and quota errors, login and verification problems, and steps that have been checked to work.
  • 33 articles
  • Updated Oct 10, 2026
Conceptual OpenClaw connection map separating Gateway, provider and channel credentials and identifying the host, agent, session and model that failed

OpenClaw API Key Errors: Fix Missing Keys, 401, 429, and Gateway Auth

For an OpenClaw API key error, identify the connection that rejected the request before changing credentials. A missing provider key, a Gateway token mismatch, and a provider rate limit need different repairs. Verify recovery in the same agent, session, and model that failed.

19 min
Gemini image references can use supported HTTPS, inline bytes, or upload URIs after checking the actual outgoing value.

Nano Banana Pro "Unsupported File URI Type"? Fix the Gemini File Route

For "Unsupported file URI type," check the exact image value your app sent and the endpoint that rejected it. Native Gemini can accept supported HTTPS URLs; local paths, unresolved templates and base64 data URLs need a different payload. Verify the repair by getting an edited image from the same Pro request.

11 min
OpenClaw context includes system instructions, tools, workspace files, history and tool output

Fix OpenClaw context_length_exceeded and Failed Compaction

For a large OpenClaw session, save the task state and try supported manual compaction. If the summary request also exceeds its limit, resume in a fresh session from a short record of completed work. Fresh-session failures require checking fixed overhead and the local model's loaded context.

15 min
OpenClaw 429 diagnosis separates model-provider requests from ClawHub skill downloads

Fix OpenClaw 429 Rate Limit Errors: Wait, Recover, or Use a Fallback

When OpenClaw reports a 429, pause extra requests and identify whether the rejection came from the model provider or ClawHub. Wait for a temporary limit, repair exhausted quota or access, and check whether the current selection permits fallback. Preserve completed work before continuing.

13 min
Match a Gemini zero free-tier allowance error with the failing app’s project, billing state, and model quota

Gemini API Paid Tier Getting free_tier_requests Limit 0: What to Fix

A paid Gemini project can still return free_tier_requests limit 0 if the running app uses another project's key, billing setup is incomplete, or the requested model has no usable allowance. Match the request to AI Studio's project, billing status, and active model limits before retrying or replacing keys.

12 min
Illustration of Nano Banana Pro resource-limit diagnosis and preserved completed images

Nano Banana Pro RESOURCE_EXHAUSTED: Fix 429 and Resume Image Jobs

For Nano Banana Pro RESOURCE_EXHAUSTED errors, check the actual project, model, and exhausted limit before retrying. Pause zero allowances, daily limits, and billing blocks; retry transient pressure within a time budget and save confirmed images so a restart does not generate them again.

12 min