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.