FreeRide automates the selection and configuration of free AI models from OpenRouter for the OpenClaw agent ecosystem.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install freeride
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install freeride 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 how developers interact with Openclaw Skills by providing automated access to free AI models. By interfacing directly with OpenRouter, FreeRide identifies available free models and ranks them using a sophisticated scoring system based on technical specs like context window and model capabilities. This tool is essential for users looking to maintain high-performance AI agents without incurring high costs, offering a programmatic way to manage model switching and configuration updates.
At its core, FreeRide bridges the gap between raw model availability and production-ready agent configuration. It intelligently modifies your local settings to ensure that your agent always has access to the most capable free models available, handling the nuances of rate limits and provider reliability so you can focus on building and coding.
FreeRide Use Cases
- Reducing API operational costs by leveraging free OpenRouter models within Openclaw Skills.
- Implementing automated fallback mechanisms to ensure agent uptime during provider rate limits.
- Dynamically ranking and selecting the best available free LLMs based on real-time capabilities.
- Rapidly switching between specialized models like Qwen-Coder or Nemotron for specific coding tasks.
How FreeRide Works
- The skill queries the OpenRouter API to fetch a comprehensive list of currently available free models.
- It applies a multi-factor ranking algorithm that weights models based on context length (40%), capabilities (30%), recency (20%), and provider trust (10%).
- Users execute commands to either auto-configure the environment or manually select specific primary and fallback models.
- FreeRide parses and updates the ~/.openclaw/openclaw.json configuration file, specifically targeting the model hierarchy.
- The agent utilizes the primary model for all requests, automatically cycling through the ranked fallback list if errors or limits are encountered.
FreeRide Setup
To add FreeRide to your toolkit of Openclaw Skills, run the following installation command:
npx clawhub@latest install freeride
After installation, set your OpenRouter API key to enable model discovery:
# Get your key at openrouter.ai/keys
export OPENROUTER_API_KEY="sk-or-v1-..."
Run the auto-configurator to instantly set up the best free model and fallbacks:
freeride auto --setup-auth
FreeRide Data Schema & Taxonomy
FreeRide modifies the primary configuration file of the agent to manage model logic. It focuses on the model-specific keys within the defaults schema.
| Key | Location | Purpose |
|---|---|---|
primary |
agents.defaults.model | The main model used for agent tasks (e.g., qwen3-coder:free). |
fallbacks |
agents.defaults.model | An array of backup models used for error handling and rate limits. |
openrouter/free |
fallbacks[0] | Typically used as the first fallback to utilize OpenRouter's internal smart routing. |
FreeRide Advanced Features
- Smart Model Ranking: Automatically scores models to ensure you always use the most capable free logic available.
- Selective Updates: Use the -f flag to update only fallback models while preserving your primary model choice.
- Cache Management: Includes a refresh command to force update model data and rankings without waiting for TTL expiration.
- Configuration Preservation: Safely updates model strings without disturbing other complex settings like plugins or channel configurations.
SKILL.md
Loading
Related Openclaw Skills
FreeRide
FreeRide is a management tool that automatically configures and ranks free AI models from OpenRouter for use within OpenClaw environments.
NEAR Name Service
A comprehensive utility for managing .near domain names and resolving blockchain account IDs within the Openclaw Skills ecosystem.
NEAR Faucet
A streamlined CLI tool for requesting NEAR testnet tokens and managing account balances within the Openclaw environment.
NEAR Email Reporter
A command-line utility for automating NEAR protocol transaction reports and balance alerts via secure SMTP email integration.
ClawCost
A financial tracking utility for AI agents that monitors token costs, budget limits, and model-specific expenditures.
Codex Orchestrator
A methodical end-to-end software delivery orchestrator for Codex CLI that manages project lifecycles through strict quality gates and spec-driven development.
Featured*
