核心用法
FreeRide 是专为 OpenClaw 设计的 CLI 工具,核心功能是通过 OpenRouter 的免费模型 API 实现"零成本 AI"。主要用法极其简单:运行 freeride auto 即可完成三件事——自动筛选当前最优免费模型设为主力、配置 5 个智能回退模型(首推 openrouter/free 自动路由)、更新 openclaw.json 并保留原有其他配置。之后执行 openclaw gateway restart 生效,用户发送 /status 即可验证。
支持精细化控制:-f 保留现有主力仅更新回退链、-c 10 扩展回退数量、freeride switch <模型名> 指定特定模型、freeride list 查看全部免费模型。高级用户可启用 freeride-watcher 守护进程,实现遇到限速时的自动无缝切换。
显著优点
1. 成本归零:完全依赖 OpenRouter 官方免费模型池,无需信用卡
2. 智能韧性:自动回退机制解决免费 API 最常见的限速痛点,第一层回退 openrouter/free 是官方智能路由,能根据请求自动匹配可用模型
3. 配置非侵入:仅修改 agents.defaults.model 相关三键,网关、频道、插件、环境变量等全部保留
4. 透明可控:freeride status 实时展示当前配置,list 命令公开模型质量排序逻辑
5. 依赖极简:仅依赖 requests 一个库,无供应链攻击风险
潜在局限
- T3 来源信任:个人开发者维护(Shaishav Pidadi),无企业背书
- 免费模型质量波动:OpenRouter 免费池模型能力参差不齐,高峰时段可能出现延迟或不可用
- 功能边界清晰:仅解决"用免费模型"问题,不涉及模型微调、本地部署等进阶需求
- Watcher 守护进程为可选:需手动启动,非全自动托管
适合人群
- 个人开发者、学生、独立项目希望零成本试用 AI
- 已有 OpenClaw 配置但想叠加免费模型作为后备/降本方案
- 对 OpenRouter 生态熟悉、能接受免费模型性能波动的技术用户
常规风险
- API 密钥管理:需自行获取并保管 OpenRouter API key,虽代码无硬编码密钥行为,但环境变量方式在共享环境存在泄露风险,建议用
openclaw config set机制 - 网络依赖:完全依赖 OpenRouter 服务可用性,无离线能力
- 免费服务政策变动:OpenRouter 可能调整免费额度或模型可用性
- 配置覆盖风险:虽设计为非侵入,但仍建议首次使用前备份
openclaw.json