核心功能
free-model-router 是专为 OpenClaw 设计的本地模型路由代理,核心价值在于实现免费 LLM 资源的智能调度与高可用保障。
核心用法:安装后作为本地服务(127.0.0.1:5678)运行,OpenClaw 仅需一次配置指向该代理。Router 层自动完成多 Provider(OpenRouter、NVIDIA NIM 等)的轮询调度、主备模型自动切换、故障检测与降级。用户可通过 CLI 查看状态、切换模型、管理 API Key,日常零维护。
显著优点:
1. 配置零侵入 —— OpenClaw 配置仅在 setup 时修改一次,运行时不再触碰,避免 Gateway 宕机风险
2. 高可用架构 —— Round-Robin 轮询 + 自动故障切换 + 全 Provider 不可用时的自动降级
3. 数据本地化 —— 用户对话内容不离开本机,仅模型配置元数据与外部同步
4. 幂等设计 —— 多次安装无副作用,自动备份与回滚机制保障配置安全
5. 透明可控 —— 三层数据流向清晰标注,用户可完全控制上报行为(默认关闭)
潜在局限:
- 免费模型存在随时下架/转收费的风险,需依赖社区维护 Provider 列表
- 本地 Router 故障时需手动诊断修复,无云端兜底
- 外部 Provider 的可用性、延迟、速率限制不可控
- 需要用户自行申请多平台 API Key,初期配置门槛较高
适合人群:
- 高频使用 AI 对话、希望降低 API 成本的技术用户
- 对服务可用性有要求、能接受多 Provider 管理的进阶用户
- 注重数据隐私、希望避免对话内容上云的安全敏感用户
常规风险:
- API Key 本地存储虽有保护,但仍需防范本地环境泄露
- 设备指纹采用 SHA256 哈希,理论上不可逆但存在碰撞风险
- 依赖
freemodel.eu.org等控制服务器获取配置,存在单点依赖