FreeRide - 适用于 OpenClaw 的免费 AI
这项技能的作用
配置 OpenClaw 使用OpenRouter 提供的免费AI 模型。将最佳免费模型设置为首选模型，添加排名靠前的备用模型，以避免速率限制中断用户，并保留现有配置。
先决条件
在运行任何 FreeRide 命令之前，请确保：
-
**已设置 OPENROUTER_API_KEY。**请检查
echo $OPENROUTER_API_KEY。如果为空，用户必须从openrouter.ai/keysexport OPENROUTER_API_KEY="sk-or-v1-..." # Or persist it: openclaw config set env.OPENROUTER_API_KEY "sk-or-v1-..." -
**CLI
freeride已安装。**请检查which freeride。如果未找到：cd ~/.openclaw/workspace/skills/free-ride pip install -e .
主要工作流程
当用户想要使用免费人工智能时，请按以下步骤操作：
# Step 1: Configure best free model + fallbacks
freeride auto
# Step 2: Restart gateway so OpenClaw picks up the changes
openclaw gateway restart
就这样。用户现在拥有了带有自动备用切换功能的免费人工智能。
通过让用户发送信息/status来验证当前使用的型号。
命令参考
| 命令 | 何时使用 |
|---|---|
freeride auto |
用户希望免费设置人工智能（最常见） |
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:free -
agents.defaults.model.fallbacks例如["openrouter/free", "nvidia/nemotron:free", ...] -
agents.defaults.models— allowlist/model命令显示免费模型
其他所有内容（网关、通道、插件、环境、自定义指令、命名代理）均保留。
第一备选方案始终是openrouter/freeOpenRouter 的智能路由器，它会根据请求自动选择最佳可用型号。
观察者（可选）
当存在速率限制时，用户可以运行以下命令来实现自动轮播：
freeride-watcher --daemon # Continuous monitoring
freeride-watcher --rotate # Force rotate now
freeride-watcher --status # Check rotation history
故障排除
| 问题 | 使固定 |
|---|---|
freeride: command not found |
cd ~/.openclaw/workspace/skills/free-ride && pip install -e . |
OPENROUTER_API_KEY not set |
用户需要从openrouter.ai/keys |
| 更改未生效 | openclaw gateway restart然后/new进行新一轮会议 |
| 代理显示 0 个令牌 | 检查freeride status——主要内容应该是openrouter/<provider>/<model>:free |
skill技能下载：
下载zip，直接发送文件并与龙虾对话请帮我下载zip并unzip解压，帮我安装这个skills
我用夸克网盘分享了「free-ride-1.0.5.zip」，点击链接即可保存。打开「夸克APP」，无需下载在线播放视频，畅享原画5倍速，支持电视投屏。
链接： 夸克网盘分享
提取码：hZHZ