FreeRide for Openclaw

FreeRide is a management tool that automatically configures and ranks free AI models from OpenRouter for use within OpenClaw environments.

shaivpidadi
v1.0.0
Feb 6, 2026
484
70.5k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install freeride-ai

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install freeride-ai using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is FreeRide?

FreeRide is a specialized utility designed to streamline the use of cost-free large language models within your development environment. By integrating directly with OpenRouter, it identifies the best available free models and integrates them into your workflow, making it an essential component of Openclaw Skills for developers looking to minimize operational costs without sacrificing performance.

This skill eliminates the manual task of searching for available free endpoints by providing a dynamic ranking system. It ensures that your AI agents remain functional even during rate limits by establishing a robust hierarchy of fallback models, ensuring high availability for all your Openclaw Skills and projects.

FreeRide Use Cases

  • Reducing API costs by prioritizing high-quality free OpenRouter models.
  • Implementing automatic model fallbacks to bypass rate limits during peak usage.
  • Quickly testing multiple open-source models like Qwen or Nemotron within OpenClaw.
  • Automating the configuration of the openclaw.json file for model management.

How FreeRide Works

  1. The skill queries the OpenRouter API to fetch a real-time list of currently available free models.
  2. It calculates a quality score for each model based on context length, capabilities, recency, and provider reputation.
  3. Users can trigger an automatic assignment of the primary model and a sequence of fallback models.
  4. The skill updates the local ~/.openclaw/openclaw.json configuration file with the optimized model hierarchy.
  5. OpenClaw utilizes these settings to route requests, automatically switching to fallbacks if the primary model fails or hits a rate limit.

FreeRide Setup

To begin using this feature within your Openclaw Skills suite, set your API key and run the auto-configuration command.

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

# Auto-configure best model + fallbacks
freeride auto

FreeRide Data Schema & Taxonomy

FreeRide manages configuration data within the standard OpenClaw directory. It specifically modifies the agent model path while preserving other environment settings.

Field Description
primary The top-ranked specific model (e.g., qwen3-coder) selected for primary tasks.
fallbacks An array of models, starting with openrouter/free, used as sequential backups.
Quality Score A value (0-1) derived from context (40%), capabilities (30%), recency (20%), and trust (10%).

FreeRide Advanced Features

  • Smart routing via the openrouter/free meta-model for vision and tool-use tasks.
  • Customizable fallback counts using the -c flag for high-resiliency setups.
  • Automatic authentication profile setup with the --setup-auth flag.
  • Forced API refreshes to ensure you are always using the latest model iterations available in Openclaw Skills.
  • Specific model switching that preserves existing fallback chains.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*