Free Ride - Unlimited free AI

• 您希望在不支付 LLM API 订阅费用的情况下使用 OpenClaw，并且可以接受免费套餐的速率限制。
• 您在使用免费模型时遇到速率限制，希望通过自动回退切换来避免会话中断。
• 您希望快速尝试不同的免费模型（例如 qwen3-coder、nvidia/nemotron），而无需手动编辑配置文件。
• 您希望实现"一劳永逸"的配置，由 OpenRouter 的智能路由器为每个请求自动选择最优的可用免费模型。

• 您需要有保障的 SLA、低延迟或稳定的吞吐量——免费模型共享容量，可用性不可预测。
• 您未使用 OpenClaw；Free Ride - Unlimited free AI 直接写入 openclaw.json，与 OpenClaw 生态系统紧密耦合。

运行 freeride auto 会自动获取当前可用的免费 OpenRouter 模型列表，按质量进行排名，将最优模型设为主要模型，并生成一个按排名排列的备用模型列表——一步完成所有操作。

Free Ride - Unlimited free AI 默认配置最多 5 个回退模型（可通过 -c 参数进行配置）。第一个回退始终是 openrouter/free，即 OpenRouter 自带的智能路由器，确保当某个模型触达速率限制时，请求会自动重新路由。

只有 ~/.openclaw/openclaw.json 中的三个键会被修改：agents.defaults.model.primary、agents.defaults.model.fallbacks 和 agents.defaults.models。其他所有内容——网关、频道、插件、环境变量和自定义指令——均保持不变。

使用 freeride switch <model> 将特定免费模型设置为您的主要模型，或使用 freeride switch <model> -f 仅将其添加为备用模型，而不更改您当前的主要模型。

freeride-watcher 守护进程持续监控速率限制事件并自动轮换模型，您也可以使用 freeride-watcher --rotate 手动触发轮换。

运行 freeride auto，然后运行 openclaw gateway restart，即可立即将 OpenClaw 切换至免费的编程专用模型，例如 qwen3-coder。继续正常使用 OpenClaw —— 触发速率限制时会自动静默回退，不会中断当前会话。

使用 freeride list -n 30 查看所有可用免费模型（按质量排名），然后使用 freeride switch <model> 尝试特定模型。随时在 OpenClaw 中使用 /status 查看当前活跃模型状态。

如果您已经配置了首选模型，请运行 freeride auto -f，这样可以在不改变主模型的情况下，自动将当前最佳的免费选项填充到备用模型列表中。

在执行长时间任务之前，启用 freeride-watcher --daemon，让守护进程在后台监控速率限制事件，并自动轮换备用模型，从而无需手动干预即可保持会话持续运行。