- name
- openrouter-paid-fallback
- description
- Set OpenClaw to use a paid OpenRouter model first and fall back to free models when quota is exhausted or rate-limited. Use when the user wants a paid OpenRouter model such as gpt-5.4-mini as the primary model with automatic free fallback.
OpenRouter Paid Fallback
Configure
- Keep the OpenRouter API key present in config.
- Set
agents.defaults.model.primaryto the requested paid model. - Set
agents.defaults.model.fallbacksto:
- openrouter/free - nvidia/nemotron-3-nano-30b-a3b:free - qwen/qwen3-next-80b-a3b-instruct:free - stepfun/step-3.5-flash:free - arcee-ai/trinity-mini:free
- Restart the gateway.
- Verify with
openclaw statusor/status.
Defaults
- Primary:
openrouter/openai/gpt-5.4-mini - Keep the same fallback list unless the user asks otherwise.
Rules
- Edit only the model-routing keys.
- Preserve unrelated config.
- If restart fails, check gateway status and remove stale config entries before retrying.