66k下载!用OpenRouter免费模型跑OpenClaw

▶ 66k 下载！OpenClaw 白嫖免费模型的正确姿势

AI Agent 跑起来很爽，烧钱更快。一个下午的测试和调试，几十块钱就没了。换成免费模型？要么效果差，要么频繁触发速率限制，一顿操作下来比付费还累。

Free Ride 这个 OpenClaw Skill 解决的就是这个问题：自动配置 OpenRouter 的免费模型链路，让 Agent 跑在零成本的模型上。66.2k 下载量，461 个 Star，MIT-0 许可证。

▶ 三分钟搞定零成本 Agent

第一步：注册 OpenRouter 免费 Key

去 openrouter.ai/keys 注册，不需要绑信用卡。OpenRouter 按月给你一定额度的免费调用配额。

拿到 Key 后设到环境变量：

export OPENROUTER_API_KEY="sk-or-v1-..."

或者用 OpenClaw 的 config 命令持久化：

openclaw config set env.OPENROUTER_API_KEY "sk-or-v1-..."

第二步：安装 + 初始化

一条命令安装 Skill：

openclaw skills install free-ride

关键一步，很多人会漏：

cd ~/.openclaw/workspace/skills/free-ride
pip install -e .

漏了这一步，后面跑 freeride 命令会提示 command not found。从社区反馈看，这是新手最容易卡住的点。

验证环境：

freeride status

▶ 核心命令只有 4 条

freeride auto — 一键配置

从 OpenRouter 免费模型池里选出当前表现最好的作为主模型，按性能排出回退链。默认链长 5 个，可以用 -c 10 扩到 10 个。

freeride auto

只想刷新回退链不动主模型：

freeride auto -f

freeride switch — 手动指定

知道要什么模型时更直接：

freeride switch qwen3-coder

代码能力需求选 qwen3-coder，在免费模型里表现不错。

freeride rotate — 救急专用

正用着免费模型突然遇到速率限制，回退链也全挂了：

freeride rotate

实时测试每个候选模型的可用性，只把能正常响应的放进回退链。比 auto 慢一点（要逐个发请求验证），但准确率更高。实测下来能省掉至少十分钟的手动排查时间。

最后一步：重启网关

openclaw gateway restart

Free Ride 修改的是 openclaw.json 配置文件，OpenClaw 只在启动时读一次。改完配置开新会话（/new），用 /status 确认当前激活的模型是不是 openrouter//:free 格式。

▶ 回退链设计是最值钱的部分

Free Ride 的核心竞争力不在算法创新，在于对 OpenRouter 免费模型生态的理解深度。

智能路由兜底

回退链的第一个位置永远是 openrouter/free。这不是偷懒的默认值，而是智能路由端点——它会根据你的请求内容动态选择最合适的免费模型。即使 Free Ride 缓存的模型列表过时了，只要这个端点还在，你至少还有一个能用的兜底。

最小侵入配置

Free Ride 只改 openclaw.json 里的三个字段：primary、fallbacks、models 白名单。其他所有配置原封不动保留。v1.0.7 之后专门做了配置 diff 逻辑，写入前先读后比，只改动真正需要改的字段。

后台守护进程

freeride-watcher 每 60 秒探测一次主模型是否还能正常响应，失败就自动用经过实时验证的模型重建回退链。

nohup freeride-watcher > ~/.openclaw/freeride-watcher.log 2>&1 &

局限：只监测主模型的可用性，不追踪每个回退模型的状态。

▶ 免费额度不是无限的

OpenRouter 的免费额度有限，每个月有固定配额。Free Ride 能做到的是让你在额度内最大化利用免费模型，而不是无限量白嫖。

一天几百次复杂推理请求的场景，免费模型和付费 API 之间的差距会迅速拉大。这个 Skill 的价值边界在"轻度到中度使用"这个区间里。

目前的免费模型列表里，qwen3-coder、nvidia/nemotron 这些模型的免费额度是厂商提供的推广配额，不是永久免费的承诺。一旦某个模型取消免费或提高门槛，Free Ride 的模型池就会缩水。

就算免费模型哪天消失了，Free Ride 的设计模式不会过时：自动选最优模型、多层回退链、最小侵入配置、后台自愈守护。这四种模式可以套到任何需要"智能路由模型选择"的场景上。

▶ 资源

• ClawHub：clawhub.ai/shaivpidadi/free-ride

• GitHub：github.com/shaivpidadi/free-ride

• OpenRouter API：openrouter.ai/keys