核心功能
OpenClaw Model Router 是一款面向生产环境的确定性模型路由工具，专为多模型协作场景设计。其核心能力包括：
前缀路由系统：通过简洁的 @codex（映射至 openai-codex/gpt-5.3-codex）和 @mini（映射至 minimax/MiniMax-M2.5）前缀，快速路由用户请求至指定模型，支持 @c、@m 快捷别名，降低记忆成本。
时区感知调度切换：基于 router.schedule.json 配置文件，实现工作时段自动切换模型策略，支持 schedule apply 启用调度与 schedule end 手动结束，满足业务高峰弹性需求。
生产安全机制：
- 环境验证：
auth.requiredEnv强制校验必要环境变量 - 验证-回滚闭环：
verify-after-switch模式确保切换后读取回显验证，异常自动回滚 - 并发锁保护：锁文件机制防止多进程调度冲突
- 完整审计链：
router.log.jsonl记录所有路由与调度操作，支持事后追溯
显著优点
1. 确定性路由：前缀匹配避免模型选择歧义，适合对一致性要求高的自动化流程
2. 零停机调度：热切换能力保障服务连续性
3. 防御性设计：多层验证与自动回滚降低人为操作风险
4. 可观测性：JSONL 结构化日志便于对接 ELK/Loki 等日志系统
潜在局限
- 仅支持前缀路由，不支持语义路由或意图识别
- 依赖本地配置文件，分布式场景需额外同步机制
- MiniMax 与 OpenAI 模型能力差异大，需用户自行评估输出质量
适用人群
- 需稳定多模型切换的开发团队
- 对路由可审计性有合规要求的金融/医疗 AI 应用
- 构建内部 AI 平台的运维工程师
常规风险
| 风险类型 | 说明 | 缓释建议 |
|---------|------|---------|
| 配置漂移 | `router.schedule.json` 手动修改导致调度异常 | 配置版本控制 + 预上线校验 `node src/cli.js schedule validate` |
| 凭证泄露 | `auth.requiredEnv` 读取敏感环境变量 | 使用密钥管理服务，避免硬编码 |
| 日志膨胀 | 高频请求导致 `router.log.jsonl` 体积失控 | 配置日志轮转与归档策略 |
| 模型服务中断 | 上游 MiniMax/OpenAI API 不可用 | 监控调度回滚事件，设置告警阈值 |