freeride

Discover, rank, and rotate free OpenRouter models for OpenClaw configurations.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/adiytharpansa/openclawuserland --skill freeride-adiytharpansa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: freeride
Source: https://github.com/adiytharpansa/openclawuserland/tree/main/skills/free-ride
Command: npx skills add https://github.com/adiytharpansa/openclawuserland --skill freeride-adiytharpansa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

FreeRide eliminates API cost and reliability pain by automatically discovering, ranking, and switching to free OpenRouter models so OpenClaw users avoid rate-limit interruptions and recurring billing.

Core Features & Use Cases

  • Automatic Discovery & Ranking: Fetches free models from OpenRouter, scores them by context length, capabilities, recency, and provider trust, and ranks the best candidates.
  • Safe Configuration Changes: Updates only agents.defaults.model and agents.defaults.models in ~/.openclaw/openclaw.json and preserves other OpenClaw settings.
  • Smart Fallbacks & Watcher: Adds an OpenRouter smart router and ranked fallbacks, plus an optional watcher daemon that detects rate limits, validates models live, and rotates automatically.
  • Use Case: Ideal for developers running OpenClaw who want a zero-cost, resilient back end for agent workloads without manual model swapping.

Quick Start

Export your OPENROUTER_API_KEY and run freeride auto to configure OpenClaw to use the best free models and fallbacks.

Frequently Asked Questions about freeride

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically switch OpenClaw models to avoid OpenRouter rate limits?

FreeRide automatically discovers free OpenRouter models, ranks them by context length and capabilities, and configures OpenClaw fallbacks to prevent rate-limit interruptions. It updates only agents.defaults.model settings in ~/.openclaw/openclaw.json without recurring billing.

Can I configure OpenClaw to use only free OpenRouter models?

Yes, FreeRide fetches free OpenRouter models, scores them by context length, capabilities, recency, and provider trust, then writes only the top candidates to agents.defaults.model and agents.defaults.models in your OpenClaw configuration.

Do I need an OpenRouter API key to set up automatic model fallbacks?

Yes, a valid OPENROUTER_API_KEY is required to verify model availability and configure automatic fallbacks. FreeRide uses this key to fetch live model lists, validate them, and safely write ranked configurations to ~/.openclaw/openclaw.json.

What is the best way to manage OpenRouter API costs for agent workloads?

The best way to manage OpenRouter API costs is to use automatic model discovery and rotation to switch to free models. FreeRide eliminates recurring billing by scoring and ranking free models to maintain a resilient back end for agent workloads.

How does a watcher daemon handle OpenRouter model rotation?

A watcher daemon handles model rotation by continuously detecting rate limits, validating model availability live, and automatically switching to ranked fallback models. FreeRide includes an optional watcher to ensure OpenClaw agents execute without interruption.

Will configuring automatic model fallbacks overwrite my existing OpenClaw settings?

No, configuring automatic model fallbacks safely updates only agents.defaults.model and agents.defaults.models in ~/.openclaw/openclaw.json. FreeRide preserves all other existing OpenClaw settings while applying the ranked free model configurations.