FreeRide：为 OpenClaw 管理免费 AI 模型 - Openclaw Skills

下载入口:https://github.com/openclaw/skills/tree/main/skills/shaivpidadi/freeride

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install freeride

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 <project>/skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 freeride。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

什么是 FreeRide？

FreeRide 是一款专用实用程序，旨在通过提供对免费 AI 模型的自动化访问，简化开发者与 Openclaw Skills 的交互。通过直接对接 OpenRouter，FreeRide 能够识别可用的免费模型，并根据上下文窗口和模型能力等技术指标，使用复杂的评分系统对它们进行排名。对于希望在不产生高昂成本的情况下保持 AI 智能体高性能的用户来说，该工具至关重要，它提供了一种程序化方式来管理模型切换和配置更新。

其核心在于，FreeRide 弥补了原始模型可用性与生产级智能体配置之间的差距。它智能地修改您的本地设置，以确保您的智能体始终能够访问最强大的免费模型，并处理速率限制和提供商可靠性方面的细节，让您可以专注于构建和编码。

FreeRide 应用场景

• 通过在 Openclaw Skills 中利用免费 OpenRouter 模型降低 API 运营成本。
• 实施自动回退机制，以确保在提供商速率受限期间智能体的正常运行。
• 根据实时能力动态排名并选择最佳的可用免费大语言模型 (LLM)。
• 在针对特定编码任务的专业模型（如 Qwen-Coder 或 Nemotron）之间快速切换。

FreeRide 工作原理

1. 该技能查询 OpenRouter API 以获取当前可用免费模型的完整列表。
2. 它应用多因素排名算法，根据上下文长度 (40%)、能力 (30%)、时效性 (20%) 和提供商信任度 (10%) 对模型进行加权。
3. 用户执行命令以自动配置环境或手动选择特定的主模型和回退模型。
4. FreeRide 解析并更新 ~/.openclaw/openclaw.json 配置文件，特别针对模型层级结构。
5. 智能体将主模型用于所有请求，如果遇到错误或限制，则自动循环遍历排名后的回退列表。

FreeRide 配置指南

要将 FreeRide 添加到您的 Openclaw Skills 工具包中，请运行以下安装命令：

npx clawhub@latest install freeride

安装后，设置您的 OpenRouter API 密钥以启用模型发现：

# 在 openrouter.ai/keys 获取您的密钥
export OPENROUTER_API_KEY="sk-or-v1-..."

运行自动配置程序以立即设置最佳免费模型和回退：

freeride auto --setup-auth

FreeRide 数据架构与分类体系

FreeRide 修改智能体的主配置文件以管理模型逻辑。它专注于 defaults 架构中的模型特定键。

键名	位置	用途
primary	agents.defaults.model	用于智能体任务的主模型（例如 qwen3-coder:free）。
fallbacks	agents.defaults.model	用于错误处理和速率限制的备份模型数组。
openrouter/free	fallbacks[0]	通常用作第一个回退，以利用 OpenRouter 的内部智能路由。

name: freeride
description: Manages free AI models from OpenRouter for OpenClaw. Automatically ranks models by quality, configures fallbacks for rate-limit handling, and updates openclaw.json. Use when the user mentions free AI, OpenRouter, model switching, rate limits, or wants to reduce AI costs.

FreeRide - Free AI for OpenClaw

Configures OpenClaw to use free AI models from OpenRouter with automatic fallback switching.

Installation

If FreeRide is not installed, install it automatically:

npx clawhub@latest install freeride

Quick Start

# Set API key (free at openrouter.ai/keys)
export OPENROUTER_API_KEY="sk-or-v1-..."

# Auto-configure best model + fallbacks
freeride auto

Commands

list - View available models

freeride list              # Top 15 models
freeride list -n 30        # More models
freeride list --refresh    # Force API refresh

auto - Auto-configure

freeride auto              # Best model + 5 fallbacks
freeride auto -f           # Fallbacks only (keep current primary)
freeride auto -c 10        # 10 fallbacks
freeride auto --setup-auth # Also configure auth profile

switch - Set specific model

freeride switch qwen3-coder         # Set as primary
freeride switch deepseek -f         # Add to fallbacks only
freeride switch nvidia/nemotron --no-fallbacks

status - Check configuration

freeride status

fallbacks - Update fallbacks only

freeride fallbacks         # 5 fallbacks
freeride fallbacks -c 10   # 10 fallbacks

refresh - Update model cache

freeride refresh

Behavior

Primary model: Best specific model (not router) for consistent responses.

First fallback: Always openrouter/free - OpenRouter's smart router that auto-selects based on request features (vision, tools, etc.).

Additional fallbacks: Ranked by quality score.

Config preservation: Only updates model-related sections; preserves gateway, channels, plugins, etc.

Model Ranking

Score (0-1) based on:

• Context length (40%)
• Capabilities (30%)
• Recency (20%)
• Provider trust (10%)

Flags

Config Output

Updates ~/.openclaw/openclaw.json:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "openrouter/qwen/qwen3-coder:free",
        "fallbacks": [
          "openrouter/free:free",
          "nvidia/nemotron-3-nano-30b-a3b:free"
        ]
      }
    }
  }
}

Troubleshooting

"OPENROUTER_API_KEY not set": Export the key or add to shell profile.

Config not updating: Check file permissions on ~/.openclaw/openclaw.json.

Changes not taking effect: Restart OpenClaw.