OpenClaw Model Router Skill

OpenClaw 模型路由技能（Model Router Skill）

基于闭环式生产切换流水线（closed-loop production switch pipeline） 的确定性模型路由方案。

为何使用该技能

• 显式用户意图路由（例如 @codex、@mini）
• 基于时间窗口的模型策略（由 router.schedule.json 定义）
• 具备验证与回滚机制的安全切换流程
• 并发锁机制，防止竞态条件（race conditions）
• 结构化审计日志，支持操作追溯与事故复盘

核心能力

1) 前缀路由（Prefix routing）

• @codex → openai-codex/gpt-5.3-codex
• @mini → minimax/MiniMax-M2.5
• 别名支持：@c、@m

2) 调度器路由（Scheduler routing）

• 基于日期、时间与优先级的规则化时间窗口
• 时区感知解析（由 router.schedule.json.timezone 指定）
• 支持跨日时间窗口（例如 18:00 → 09:00）

3) 生产环境切换闭环（Production switch loop）

• schedule apply / schedule end 操作指令
• 认证门控（通过 auth.requiredEnv[] 配置）
• 切换后执行读回校验（readback verify）
• 故障分类（auth_expired、rate_limit、provider_drift、unknown）
• 可选自动回滚（由 safety.rollbackOnFailure 控制）
• 锁文件机制（safety.lockPath）避免并发切换冲突
• 审计日志记录（写入 router.log.jsonl，支持日志轮转）

快速命令示例

# 验证配置有效性
node src/cli.js validate

# 路由解析调试
node src/cli.js route "@codex implement this" --json

# 调度器相关操作
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

关键配置文件

• router.config.json：定义前缀映射、重试策略、认证配置、安全策略、日志设置及控制器参数
• router.schedule.json：定义时区与调度规则

可靠性检查清单

• 路由映射具备确定性（deterministic mapping）
• 切换行为具备幂等性（idempotent switching behavior）
• 仅在切换验证成功后才执行后续操作
• 成功/失败事件可观测（observable success/failure events）
• 所有故障路径均具备可恢复性（recoverability on failure paths）

测试命令

node --test