免费模型管理器

技能简介

FreeRide 为 OpenClaw 管理来自 OpenRouter 的免费 AI 模型，自动按质量评分排序模型，配置速率限制时的降级切换方案，并更新 openclaw.json 配置文件。

能做什么

• 列出 OpenRouter 上可用的免费模型并按质量排名
• 自动选择最佳主模型并配置多级降级备选
• 手动切换指定模型为主模型或加入备选列表
• 查看当前模型配置状态
• 单独更新降级备选模型列表
• 刷新本地模型缓存数据

使用说明

安装

npx clawhub@latest install freeride

快速开始

# 设置 API 密钥（在 openrouter.ai/keys 免费获取）
export OPENROUTER_API_KEY="sk-or-v1-..."

# 自动配置最佳模型 + 降级备选
freeride auto

常用命令

查看可用模型：

freeride list              # 显示前 15 个模型
freeride list -n 30        # 显示更多模型
freeride list --refresh    # 强制刷新 API 数据

自动配置：

freeride auto              # 最佳模型 + 5 个降级备选
freeride auto -f           # 仅配置降级备选（保留当前主模型）
freeride auto -c 10        # 配置 10 个降级备选
freeride auto --setup-auth # 同时配置认证信息

切换指定模型：

freeride switch qwen3-coder         # 设为主模型
freeride switch deepseek -f         # 仅加入降级备选
freeride switch nvidia/nemotron --no-fallbacks  # 不配置降级备选

其他命令：

freeride status            # 检查当前配置
freeride fallbacks -c 10   # 更新为 10 个降级备选
freeride refresh           # 更新模型缓存

配置说明

主模型选择最佳具体模型（非路由型）以保证响应一致性。第一降级备选固定为 openrouter/free，这是 OpenRouter 的智能路由器，会根据请求特征自动选择。其余降级备选按质量评分排序。配置仅更新模型相关部分，保留网关、频道、插件等其他设置。

模型评分规则

评分范围 0-1，基于：上下文长度（40%）、能力支持（30%）、发布时间（20%）、提供商可信度（10%）。

输入与输出

见下方输入与输出表格。

项目	内容
输入	OpenRouter API 密钥；目标模型名称（可选）；降级备选数量参数 -c N（可选）；强制刷新标志 –refresh/-r（可选）
输出	~/.openclaw/openclaw.json 配置文件更新；终端输出的模型排名列表；配置状态检查报告
适用人群	OpenClaw 用户中希望使用免费模型降低成本的开发者；需要自动降级机制应对速率限制的生产环境；频繁测试不同模型的技术团队
不包含	付费模型的订阅与管理；OpenAI/Anthropic 等官方 API 的直接对接；模型响应质量的实时评估反馈；详细的调用日志与用量统计

 

风险提示

• 免费模型存在速率限制，高频调用可能触发限流
• 模型可用性随 OpenRouter 政策变化，需定期刷新列表
• 智能路由器 openrouter/free 的模型选择不透明，可能影响输出一致性
• API 密钥泄露可能导致额度被盗用
• 配置文件权限问题可能导致更新失败

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/shaivpidadi/freeride/SKILL.md
来源类型：GitHub 仓库