技能介绍

要解决什么问题

在 OpenClaw 里接多个免费模型 Provider（OpenRouter、NVIDIA NIM 等）时，常见痛点是：网关配置一改就要重启、主模型挂了要手改 openclaw.json、多个 Key 之间没有统一的轮询与降级策略。免费模型还会随时下架或限流，单靠一个 Provider 很容易整链路不可用。

技能如何工作

free-model-router 在本地 127.0.0.1:5678 起一个只监听回环的代理 Router。Setup 时只改一次 OpenClaw：写入指向该 Router 的 free-model-router provider；之后所有主备切换、Round-Robin 轮询、故障降级都在 Router 层完成，运行期不再碰网关配置。

典型能力包括：

多 Provider 聚合：从 freemodel.eu.org 等同步 provider 与模型元数据（不含对话内容）；API Key 仅存本地 router-config.json
自动故障切换：主模型不可用时切备模型；全部不可用时自动降级
事件通知：切换、故障等写入 events.json，由 cron 在指定时段推送（无待办事件时静默）
幂等 Setup：Router 已运行或 OpenClaw 已配置则跳过；重复 setup 不会覆盖你手动设的主备模型

配置完成后还可把 Router 设为 OpenClaw 的主模型或备用模型；未选角色则路由不会真正生效。

边界与注意

你的提示词与模型响应会经 Router 转发到外部 Provider，本技能不收集、不存储对话内容；可选的健康上报默认关闭。Skill 文件更新后不会自动重启 Router 进程，需 stop 再 setup 新代码才生效（用户配置持久化在 ~/.free-model-router/data/router-config.json）。免费模型可用性随时变化，多 Provider 仍比单 Key 更稳，但不能保证长期在线。