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

安装与下载

1. ClawHub CLI

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

npx clawhub@latest install freeride-ai

2. 手动安装

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

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

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

3. 提示词安装

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

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

什么是 FreeRide？

FreeRide 是一款专门设计的实用工具，旨在简化开发环境中使用免费大语言模型的过程。通过与 OpenRouter 直接集成，它可以识别最佳的可用免费模型并将其整合到您的工作流中，对于希望在不牺牲性能的情况下降低运营成本的开发者来说，它是 Openclaw 技能中不可或缺的组件。

该技能通过提供动态排名系统，消除了手动搜索可用免费端点的繁琐任务。它通过建立稳健的模型回退层级，确保您的 AI 代理在遇到速率限制时仍能保持功能，为您的所有 Openclaw 技能和项目提供高可用性。

FreeRide 应用场景

• 通过优先使用高质量的免费 OpenRouter 模型来降低 API 成本。
• 实施自动模型回退，以绕过高峰时段的速率限制。
• 在 OpenClaw 中快速测试 Qwen 或 Nemotron 等多种开源模型。
• 自动化用于模型管理的 openclaw.json 文件配置。

FreeRide 工作原理

1. 该技能查询 OpenRouter API 以获取当前可用免费模型的实时列表。
2. 它根据上下文长度、能力、时效性和提供者声誉为每个模型计算质量评分。
3. 用户可以触发主模型和一系列回退模型的自动分配。
4. 该技能使用优化后的模型层级更新本地 ~/.openclaw/openclaw.json 配置文件。
5. OpenClaw 利用这些设置来路由请求，如果主模型失败或达到速率限制，则自动切换到回退模型。

FreeRide 配置指南

要在您的 Openclaw 技能套件中开始使用此功能，请设置您的 API 密钥并运行自动配置命令。

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

# 自动配置最佳模型 + 回退方案
freeride auto

FreeRide 数据架构与分类体系

FreeRide 在标准 OpenClaw 目录中管理配置数据。它专门修改代理模型路径，同时保留其他环境设置。

字段	描述
primary	被选为主要任务的排名最高的特定模型（例如 qwen3-coder）。
fallbacks	模型数组，以 openrouter/free 开头，用作顺序备份。
质量评分	基于上下文 (40%)、能力 (30%)、时效性 (20%) 和信任度 (10%) 得出的数值 (0-1)。

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.

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.