OpenRouter免费模型智能管理工具，自动配置降级链防限流，零成本使用优质AI
说明：
## 功能概述
FreeRide 是专为 OpenClaw 设计的 OpenRouter 免费 AI 模型管理工具。它自动从 OpenRouter 平台筛选优质免费模型，智能配置主模型与多级降级链，确保用户在遭遇速率限制时无缝切换，实现零成本稳定使用 AI 服务。
## 核心用法
使用 `freeride auto` 一键完成最佳免费模型配置，系统自动：
– 抓取 OpenRouter 实时免费模型列表并按质量排序
– 设置最优模型为主力（如 `qwen3-coder:free`）
– 构建 5 级智能降级链，首位固定为 OpenRouter 智能路由 `openrouter/free`
– 更新 OpenClaw 配置并重启网关生效
其他关键命令：
– `freeride list` 查看可用免费模型
– `freeride switch ` 手动切换指定模型
– `freeride rotate` 限流死锁时现场测试并重建链
– `freeride-watcher` 后台守护进程，60秒自动探活恢复
## 显著优点
1. **零成本高质量 AI**：接入 OpenRouter 官方免费模型池，覆盖 Qwen、Llama、DeepSeek 等主流开源模型
2. **抗限流设计**：多级 fallback + 智能路由，单点限流自动无缝切换，几乎无感知中断
3. **配置安全**：仅修改 `agents.defaults.model` 相关键，完整保留网关、插件、自定义指令等现有配置
4. **多 Key 轮换**：内置支持 JSON 数组格式多 API Key，自动轮询分散限流风险
5. **无人值守恢复**：可选后台 watcher 进程，自主检测死锁并重建可用链
## 潜在局限
– **模型能力边界**：免费模型相比付费版本（Pro/Enterprise）存在上下文长度、推理深度、知识时效等差距
– **速率限制本质**：免费层级存在硬性 RPM/TPM 上限，高并发场景仍可能整体受限
– **可用性波动**：免费模型池动态变化，优质模型可能突然下架或调整策略
– **T3 来源依赖**：个人开发者维护，长期更新稳定性需社区验证
## 适用人群
– 个人开发者/研究者：降低实验成本，快速验证 AI 工作流
– 轻量级应用场景：代码补全、文案生成、简单问答等非关键业务
– OpenClaw 现有用户：希望无缝迁移至免费模型栈，保留原有生态配置
## 常规风险与建议
| 风险场景 | 缓解措施 |
|———|———|
| 全链限流死锁 | 启用 `freeride-watcher` 后台守护，或配置多 API Key 分散风险 |
| 模型突然下架 | 定期运行 `freeride refresh` 同步最新可用列表 |
| API Key 泄露 | 通过环境变量或 `openclaw config set` 配置，避免硬编码；利用内置掩码保护 |
| 配置冲突 | 首次使用后执行 `/status` 验证，确认主模型格式为 `openrouter//:free` |
会员专属
