TOPIC / MODELS

OpenClaw model router: fallback & task routing

Learn when a single model is enough, when to add fallback, and when to set up task-based routing. Keep model complexity low and scale gradually.

Best for

  • Already know you do not want to rely on one model only
  • Want to understand fallback and routing before copying complex config
  • Prefer to keep complexity at the minimum needed

Get one model stable first

The usual mistake is not "the model is too weak"—it is adding fallback, routing, and multiple providers before the first model runs reliably.

When a single model is enough

  • You are still validating your first channel loop
  • You have few skills
  • Task types are similar
  • You care more about debugging than model limits

A single model gives:

  • Clearer failure points
  • Easier cost estimation
  • A simpler view of context and tool usage

When to add fallback

Add fallback (not full routing) when:

  • The primary model occasionally fails
  • You want a weaker but usable backup for critical flows
  • You need a safety net without task-specific routing

Fallback makes the system more resilient, not smarter.

When routing is worth it

Task-based routing fits when:

  • You have distinct task layers
  • You know which tasks need stronger models
  • You know which tasks can use cheaper models
  • You accept extra config and debugging complexity

If you cannot clearly say "which task goes to which model," routing is probably too early.

A sensible upgrade order

  1. Single model
  2. Two-model split (simple vs complex tasks)
  3. Fallback chain
  4. Task-specific routing

Doing this in reverse usually creates complexity before understanding.

Avoid early complexity

  • Do not configure 4–5 fallback layers at once
  • Do not set up routing for every task type from day one

Start with one model, validate it, then add fallback or routing incrementally.

Next steps

FAQ

Topic FAQ

Often no. For most first-time setups, a single model is easier to debug, cost, and validate—and often enough.

No. Fallback is a safety net when the primary fails; routing is assigning different models to different task types.