---

name: freeride description: 管理 OpenClaw 的 OpenRouter 免费 AI 模型。自动按质量排名模型，配置限速处理的回退机制，并更新 openclaw.json。当用户提到免费 AI、OpenRouter、模型切换、速率限制或想降低 AI 成本时使用。

FreeRide - OpenClaw 的免费 AI

此技能的作用

配置 OpenClaw 使用 OpenRouter 的免费 AI 模型。将最佳免费模型设为主模型，添加分级回退机制以防止限速中断用户操作，并保留现有配置。

前提条件

在运行任何 FreeRide 命令前，请确保：

1. 已设置 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-..."
   

2. 已安装 freeride CLI 工具。 使用 which freeride 检查。如果未找到：

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

主要工作流程

当用户需要免费 AI 时，按顺序运行以下步骤：

# 第一步：配置最佳免费模型 + 回退机制
freeride auto

# 第二步：重启网关以便 OpenClaw 应用更改
openclaw gateway restart

就这样。用户现在可以享受带有自动回退切换的免费 AI 服务。

通过告诉用户发送 /status 来检查当前活动模型，以验证配置。

命令参考

执行任何会修改配置的命令后，务必运行openclaw gateway restart。

配置写入内容

FreeRide仅更新~/.openclaw/openclaw.json中的以下键值：

• agents.defaults.model.primary — 例如openrouter/qwen/qwen3-coder:free
• agents.defaults.model.fallbacks — 例如["openrouter/free", "nvidia/nemotron:free", ...]
• agents.defaults.models — 白名单，使/model命令显示免费模型

其他配置（gateway、channels、plugins、env、customInstructions、named agents）均保持不变。

第一个备用模型始终是openrouter/free——这是OpenRouter的智能路由，会根据请求自动选择最佳可用模型。

监控程序（可选）

当遇到速率限制时，用户可运行以下命令实现自动轮换：

freeride-watcher --daemon    # 持续监控
freeride-watcher --rotate    # 立即强制轮换
freeride-watcher --status    # 查看轮换历史

故障排除