名称： freeride
描述： 为 OpenClaw 管理来自 OpenRouter 的免费 AI 模型。自动按质量对模型进行排序，配置用于处理速率限制的备用模型，并更新 openclaw.json。当用户提及免费 AI、OpenRouter、模型切换、速率限制或希望降低 AI 成本时使用。
配置 OpenClaw 以使用来自 OpenRouter 的 免费 AI 模型。将最佳免费模型设为主模型，添加排序后的备用模型以防止速率限制中断用户使用，并保留现有配置。
运行任何 FreeRide 命令前，请确保：
已设置 OPENROUTER_API_KEY。使用 echo $OPENROUTER_API_KEY 检查。如果为空，用户必须在 https://openrouter.ai/keys 获取免费密钥并设置：
bash
export OPENROUTER_API_KEY="sk-or-v1-..."
# 或持久化保存：
openclaw config set env.OPENROUTER_API_KEY "sk-or-v1-..."
已安装 freeride CLI。使用 which freeride 检查。如果未找到：
bash
cd ~/.openclaw/workspace/skills/free-ride
pip install -e .
当用户需要使用免费 AI 时，按顺序运行以下步骤：
# 步骤 1：配置最佳免费模型及备用模型
freeride auto
# 步骤 2：重启网关以使 OpenClaw 应用更改
openclaw gateway restart
完成。用户现在即可使用具备自动备用切换功能的免费 AI。
可通过让用户发送 /status 来验证当前活动模型。
| 命令 | 使用场景 |
|---|---|
freeride auto |
用户希望设置免费 AI（最常用） |
freeride auto -f |
用户希望配置备用模型，但保留当前主模型 |
freeride auto -c 10 |
用户希望配置更多备用模型（默认为 5 个） |
freeride list |
用户希望查看可用的免费模型 |
freeride list -n 30 |
用户希望查看所有免费模型 |
freeride switch <model> |
用户希望切换到特定模型（例如 freeride switch qwen3-coder） |
freeride switch <model> -f |
仅将特定模型添加为备用模型 |
freeride status |
检查当前的 FreeRide 配置 |
freeride fallbacks |
仅更新备用模型列表 |
freeride refresh |
强制刷新缓存的模型列表 |
任何更改配置的命令执行后，务必运行 openclaw gateway restart。
FreeRide 仅更新 ~/.openclaw/openclaw.json 中的以下键：
agents.defaults.model.primary — 例如 openrouter/qwen/qwen3-coder:freeagents.defaults.model.fallbacks — 例如 ["openrouter/free", "nvidia/nemotron:free", ...]agents.defaults.models — 允许列表，使 /model 命令能显示免费模型其他所有内容（网关、频道、插件、环境变量、自定义指令、命名代理）均保持不变。
第一个备用模型始终是 openrouter/free — 这是 OpenRouter 的智能路由器，能根据请求自动选择最佳可用模型。
如需在遇到速率限制时自动轮换模型，用户可以运行：
freeride-watcher --daemon # 持续监控
freeride-watcher --rotate # 立即强制轮换
freeride-watcher --status # 检查轮换历史
| 问题 | 解决方法 |
|---|---|
freeride: command not found |
cd ~/.openclaw/workspace/skills/free-ride && pip install -e . |
OPENROUTER_API_KEY not set |
用户需要从 https://openrouter.ai/keys 获取密钥 |
| 更改未生效 | 运行 openclaw gateway restart，然后使用 /new 开始新会话 |
| 代理显示 0 个令牌 | 检查 freeride status — 主模型应为 openrouter/<provider>/<model>:free 格式 |