FreeRide 用于让 OpenClaw 使用 OpenRouter 的免费 AI 模型。它会将质量最好的免费模型设为主模型，并按排名添加回退模型，避免速率限制中断使用，同时保留现有配置。
使用前提：需设置 OPENROUTER_API_KEY（可用 echo $OPENROUTER_API_KEY 检查，为空则到 https://openrouter.ai/keys 获取免费密钥，再 export OPENROUTER_API_KEY="sk-or-v1-..." 或 openclaw config set env.OPENROUTER_API_KEY "sk-or-v1-..."）；需安装 freeride CLI（用 which freeride 检查，未找到则 cd ~/.openclaw/workspace/skills/free-ride 后 pip install -e .）。
主要流程：先运行 freeride auto 配置最佳免费模型与回退，再运行 openclaw gateway restart 让 OpenClaw 生效；之后可发送 /status 查看当前模型。常用命令：freeride auto（最常用）、freeride auto -f（保留当前主模型只加回退）、freeride auto -c 10（增加回退数量，默认 5）、freeride list、freeride list -n 30、freeride switch <model>、freeride switch <model> -f、freeride status、freeride fallbacks、freeride refresh。任何修改配置的命令后都需运行 openclaw gateway restart。
配置写入：仅更新 ~/.openclaw/openclaw.json 中的 agents.defaults.model.primary、agents.defaults.model.fallbacks、agents.defaults.models 三个键，其余（gateway、channels、plugins、env、customInstructions、命名智能体）保持不变。第一个回退始终是 openrouter/free。可选 watcher：freeride-watcher --daemon、--rotate、--status。
限制与排错：命令未找到需重新 pip install -e .；密钥未设置需获取密钥；改动未生效需重启 gateway 并 /new 开新会话；显示 0 tokens 时用 freeride status 检查主模型是否为 openrouter/<provider>/<model>:free。