mcpField
F
freeride

freeride

github.com/shaivpidadiAgent 工作流238782 次安装4 天前更新
代码仓库

关于 freeride

freeride 是用于为 OpenClaw 配置 OpenRouter 免费模型的 Skill。它设置主模型和排序后的备用模型，并可通过监控程序在主模型失败时重建模型链。

主要功能

  1. 01配置免费主模型
  2. 02设置排序后的备用模型
  3. 03查看并切换模型
  4. 04检查状态并刷新模型列表
  5. 05监控并重建模型链

适用场景

  1. 01为 OpenClaw 配置免费模型
  2. 02通过备用恢复机制运行无人值守配置

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/shaivpidadi/freeride --skill freeride

安装后在 Claude Code 中输入/freeride确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.gitignore
README.md
watcher.py
main.py
skill.json
setup.py
requirements.txt

详细介绍

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-..."
# Or persist it:
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 时，按顺序运行以下步骤：

# Step 1: Configure best free model + fallbacks
freeride auto

# Step 2: Restart gateway so OpenClaw picks up the changes
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强制刷新缓存的模型列表
freeride rotate用户受到速率限制／备用链失效时，实时测试并重建模型链

每次运行会更改配置的命令后，务必运行 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 的智能路由器，会根据请求自动选择当前可用的最佳模型。

监控程序（后台守护进程）

如果整个模型链都受到速率限制，系统就会陷入死锁。Agent 无法自行修复，因为调用 freeride rotate 需要推理，而推理恰好就是失效的环节。为实现自动恢复，用户可以运行一个精简的后台守护进程：

# Foreground
freeride-watcher

# Persistent background
nohup freeride-watcher > ~/.openclaw/freeride-watcher.log 2>&1 &

# One-shot check (no loop)
freeride-watcher --once

# State / history
freeride-watcher --status

守护进程每 60 秒探测一次当前主模型；如果失败，就使用实时验证过的模型重建模型链。建议用户在无人值守地运行 OpenClaw 时启用此功能。

故障排除

问题解决方法
freeride: command not foundcd ~/.openclaw/workspace/skills/free-ride && pip install -e .
OPENROUTER_API_KEY not set用户需要从 https://openrouter.ai/keys 获取密钥
更改未生效运行 openclaw gateway restart，然后运行 /new 开启新会话
Agent 显示 0 个令牌检查 freeride status — 主模型应为 openrouter/<provider>/<model>:free

评论

支持 Markdown