OpenClaw 添加 FreeRide 技能

技能名称：FreeRide（免费AI模型管理器）功能描述：为 OpenClaw 自动化管理 OpenRouter 平台的免费AI模型，自动按质量排序优选模型、配置限流降级策略、更新 openclaw.json 配置文件。适用于免费使用AI、切换模型、处理限流、降低AI使用成本等场景。

技能官方地址：https://clawhub.ai/Shaivpidadi/free-ride

使用本技能前，必须完成以下准备：  1. 已安装并正常运行 OpenClaw 环境  2. 前往 OpenRouter API Keys 免费注册并获取 API Key  3. 确保终端环境可正常调用 OpenClaw 命令

安装步骤 :

第一步: 快速检查（管理员 PowerShell）

openclaw --versionclawhub --version

第二步: OpenClaw 配置 OpenRouter API Key

# 获取地址: https://openrouter.ai/workspaces/default/keysopenclaw config set env.OPENROUTER_API_KEY "sk-or-v1-你的API密钥"

第三步: Windows 安装 FreeRide（free-ride）技能

方法 1：ClawHub 命令行安装（推荐）  以管理员身份打开 PowerShell，依次执行：  # 1. 安装技能  npx clawhub@latest install free-ride  # 2. 进入技能目录（Windows 路径）  cd ~/.openclaw/workspace/skills/free-ride  # 3. 安装 Python 依赖  pip install -e .方法 2：手动 Git 安装（备用）  cd ~/.openclaw/workspace/skills/  git clone https://github.com/openclaw-eco/free-ride.git  cd free-ride  pip install -e .验证是否安装成功: (freeride-1.0.0 没有通过查看版本命令验证参数)  终端输入 freeride 回车,出现以下内容说明安装成功

出现问题:  在终端直接输入freeride 回车报错:  PS C:\Users\PurpleDandelion\.openclaw\workspace\skills\free-ride> freeridefreeride : The term 'freeride' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.At line:1 char:1+ freeride+ ~~~~~~~~    + CategoryInfo          : ObjectNotFound: (freeride:String) [], CommandNotFoundException    + FullyQualifiedErrorId : CommandNotFoundException 中文意思:     freeride：术语 “freeride” 未被识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写，若包含路径，请验证路径是否正确，然后重试。 解决方法:   在执行完 FreeRide 技能安装命令后,安装 Python 依赖完后会有一个警告,会告知freeride 命令的安装目录,执行freeride 命令时,添加上命令所在的目录,通过绝对路径的方式进行执行.

命令参考

命令	使用场景
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	强制刷新缓存的模型列表

Watcher(监视器（可选）)

若需在触发速率限制时自动切换，用户可运行：

命令	使用场景
freeride-watcher --daemon	持续监控
freeride-watcher --rotate	立即强制切换
freeride-watcher --status	查看轮换历史记录

第四步: 自动配置最优免费模型 + 限流降级策略

freeride auto# 重启网关使配置生效openclaw gateway restart

配置修改说明

FreeRide 仅修改以下3项配置，不会影响其他自定义设置：  agents.defaults.model.primary：主模型（质量最优的免费模型）  agents.defaults.model.fallbacks：降级模型列表  agents.defaults.models：模型白名单

✅ 降级列表首位固定为 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`	配置 OpenRouter API Key 环境变量
配置修改后未生效	执行 `openclaw gateway restart`，并发送 `/new` 新建会话
AI返回0令牌/无响应	执行 `freeride status` 检查模型格式是否正确

查看当前模型是否是免费模型: 在输入框中输入 /status 回车,在模型行查看是否有:free,有则是免费

使用前可通过 /status 查看当前会话所使用的完整模型名称，确认是否带有 :free 标识。如需切换模型，可在对话中指定或通过配置修改默认模型。