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命令行工具。可通过以下命令检查：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命令显示免费模型

其他所有内容（网关、通道、插件、环境变量、自定义指令、命名代理）均保持不变。

首要备选方案始终是openrouter/free——OpenRouter的智能路由器，能根据请求自动选择最佳可用模型。

监控器（可选）

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

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

故障排除