freeride

Discover, rank, and configure free OpenRouter models for OpenClaw.

2|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/papachong/RHClaw --skill freeride-papachong
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: freeride
Source: https://github.com/papachong/RHClaw/tree/main/RHClaw-Desktop/src-tauri/skills/free-ride
Command: npx skills add https://github.com/papachong/RHClaw --skill freeride-papachong

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reduce or eliminate AI API costs and interruptions by automatically finding, ranking, and switching to free OpenRouter models for OpenClaw so users never get blocked by rate limits.

Core Features & Use Cases

  • Automatic Discovery: Finds available free models on OpenRouter and caches them for fast access.
  • Quality Ranking & Selection: Ranks models by context length, capabilities, recency, and provider trust to pick the best candidate.
  • Smart Fallbacks & Rotation: Configures openclaw.json fallbacks and runs a watcher to rotate when rate limits or unavailability are detected.
  • Use Case: A developer running OpenClaw who wants to avoid paid APIs can install FreeRide, set an OpenRouter key, and have the system maintain a resilient free-model configuration.

Quick Start

Set your OPENROUTER_API_KEY, run freeride auto to configure the best free model and fallbacks, and then restart the OpenClaw gateway to activate them.

Frequently Asked Questions about freeride

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

FAQPage Schema
How do I automatically switch to free OpenRouter models when rate limited?

To automatically switch to free OpenRouter models when rate limited, you can run the auto command to configure ranked fallbacks and activate a watcher for continuous model rotation. This prevents interruptions by detecting unavailability and rotating to the next free model.

What is the best way to avoid AI API costs with OpenClaw?

The best way to avoid AI API costs with OpenClaw is to use automatic discovery to find free OpenRouter models and configure smart fallbacks. This eliminates paid API usage by ranking and selecting available free models based on context length and capabilities.

Do I need an OPENROUTER_API_KEY to use free model rotation?

Yes, you need an OPENROUTER_API_KEY to use free model rotation, along with a Python environment for the CLI and watcher. The key is required to access the OpenRouter API for discovering models and managing rate-limit fallbacks.

How does automatic discovery rank and select free OpenRouter models?

Automatic discovery ranks and selects free OpenRouter models by evaluating context length, capabilities, recency, and provider trust. It caches the available models for fast access and picks the best candidate to configure your openclaw.json file.

Can I configure openclaw.json fallbacks automatically for free models?

Yes, you can configure openclaw.json fallbacks automatically by running the setup command, which discovers and ranks free OpenRouter models. After configuration, you restart the OpenClaw gateway to activate the resilient free-model setup.

Why does my OpenClaw setup keep getting blocked by rate limits on free models?

Your OpenClaw setup gets blocked by rate limits when lacking a watcher for continuous model rotation. By applying automatic fallback configuration and enabling rotation, the system detects rate limits and switches to alternative free models automatically.