# Openclaw Model Router Skill

> Production-grade model router for OpenClaw: prefix routing (@codex/@mini), timezone-aware schedule switching, verify-after-switch, rollback, lock protection, and JSONL audit logs.

- Skill: `modbender/openclaw-model-router-skill` (Agent Skill, multi-file: 17 files)
- Install (CLI): `npx skillmds@latest add modbender/openclaw-model-router-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/openclaw-model-router-skill/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/openclaw-model-router-skill

---



# 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` → `openai-codex/gpt-5.3-codex`
- `@mini` → `minimax/MiniMax-M2.5`
- Aliases: `@c`, `@m`

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` / `schedule end`
- 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

```bash
# Validate config
node src/cli.js validate

# Route inspection
node src/cli.js route "@codex implement this" --json

# Scheduler
node src/cli.js schedule validate
node src/cli.js schedule resolve --at "2026-03-02T10:00:00+01:00" --json
node src/cli.js schedule apply --json
node src/cli.js schedule end --id workday_codex --json
```

## Key config files

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

## Reliability checklist

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

## Tests

```bash
node --test
```