OpenClaw Model Router Skill

Deterministic model routing with a closed-loop production switch pipeline.

Why use this skill

• - Explicit user intent routing (@codex, @mini)
• Time-window model policy (router.schedule.json)
• Safe switch flow with verification and rollback
• Concurrency lock to prevent race conditions
• Structured audit logs for operations and incident review

Core capabilities

1) Prefix routing

• - @codex → INLINECODE4
• INLINECODE5 → INLINECODE6
• Aliases: @c, INLINECODE8

2) Scheduler routing

• - Rule-based windows by day/time/priority
• Timezone-aware resolution (router.schedule.json.timezone)
• Supports overnight windows (e.g. 18:00 → 09:00)

3) Production switch loop

• - schedule apply / INLINECODE11
• Auth gate (auth.requiredEnv[])
• Switch + readback verify
• Failure classification (auth_expired, rate_limit, provider_drift, unknown)
• Optional rollback (safety.rollbackOnFailure)
• Lock file (safety.lockPath) to avoid concurrent switching
• Audit logs (router.log.jsonl + rotation)

Quick commands

CODEBLOCK0

Key config files

• - router.config.json (prefix map, retry, auth, safety, logging, controller)
• INLINECODE21 (timezone + rules)

Reliability checklist

• - Deterministic mapping
• Idempotent switching behavior
• Execute only after switch verification
• Observable success/failure events
• Recoverability on failure paths

Tests

CODEBLOCK1