free-rideManages free AI models from OpenRouter for OpenClaw. Automatically ranks models by quality, configures fallbacks for rate-limit handling, and updates opencla...
Install via ClawdBot CLI:
clawdbot install Shaivpidadi/free-rideConfigures OpenClaw to use free AI models from OpenRouter. Sets the best free model as primary, adds ranked fallbacks so rate limits don't interrupt the user, and preserves existing config.
Before running any FreeRide command, ensure:
echo $OPENROUTER_API_KEY. If empty, the user must get a free key at https://openrouter.ai/keys and set it:
export OPENROUTER_API_KEY="sk-or-v1-..."
# Or persist it:
openclaw config set env.OPENROUTER_API_KEY "sk-or-v1-..."freeride CLI is installed. Check with which freeride. If not found:
cd ~/.openclaw/workspace/skills/free-ride
pip install -e .When the user wants free AI, run these steps in order:
# Step 1: Configure best free model + fallbacks
freeride auto
# Step 2: Restart gateway so OpenClaw picks up the changes
openclaw gateway restartThat's it. The user now has free AI with automatic fallback switching.
Verify by telling the user to send /status to check the active model.
| Command | When to use it |
|---------|----------------|
| freeride auto | User wants free AI set up (most common) |
| freeride auto -f | User wants fallbacks but wants to keep their current primary model |
| freeride auto -c 10 | User wants more fallbacks (default is 5) |
| freeride list | User wants to see available free models |
| freeride list -n 30 | User wants to see all free models |
| freeride switch | User wants a specific model (e.g. freeride switch qwen3-coder) |
| freeride switch | Add specific model as fallback only |
| freeride status | Check current FreeRide configuration |
| freeride fallbacks | Update only the fallback models |
| freeride refresh | Force refresh the cached model list |
After any command that changes config, always run openclaw gateway restart.
FreeRide updates only these keys in ~/.openclaw/openclaw.json:
agents.defaults.model.primary — e.g. openrouter/qwen/qwen3-coder:freeagents.defaults.model.fallbacks — e.g. ["openrouter/free", "nvidia/nemotron:free", ...]agents.defaults.models — allowlist so /model command shows the free modelsEverything else (gateway, channels, plugins, env, customInstructions, named agents) is preserved.
The first fallback is always openrouter/free — OpenRouter's smart router that auto-picks the best available model based on the request.
For auto-rotation when rate limited, the user can run:
freeride-watcher --daemon # Continuous monitoring
freeride-watcher --rotate # Force rotate now
freeride-watcher --status # Check rotation history| Problem | Fix |
|---------|-----|
| freeride: command not found | cd ~/.openclaw/workspace/skills/free-ride && pip install -e . |
| OPENROUTER_API_KEY not set | User needs a key from https://openrouter.ai/keys |
| Changes not taking effect | openclaw gateway restart then /new for fresh session |
| Agent shows 0 tokens | Check freeride status — primary should be openrouter/ |
Generated Feb 24, 2026
A startup uses FreeRide to deploy cost-effective AI agents for handling customer inquiries via chat. By leveraging free models from OpenRouter, they reduce operational costs while maintaining quality through automatic fallbacks during rate limits, ensuring uninterrupted service during peak hours.
An online learning platform integrates FreeRide to generate educational materials and answer student questions. The skill's model ranking and fallback features provide reliable AI assistance without subscription fees, making it ideal for budget-conscious educational initiatives.
Developers use FreeRide to quickly prototype AI-driven apps with OpenClaw, testing different free models for tasks like text summarization or code generation. The easy setup and configuration updates allow rapid iteration without upfront AI costs.
Small businesses employ FreeRide to automate tasks such as email drafting or social media posting using AI. By minimizing expenses with free models and handling rate limits automatically, they streamline operations affordably.
Offer FreeRide as a free tier to attract users, then upsell premium features like advanced model access, priority support, or enhanced monitoring tools. Revenue comes from subscription upgrades and enterprise plans.
Provide paid consulting to help businesses integrate and customize FreeRide with their OpenClaw setups. Revenue is generated through one-time project fees or ongoing maintenance contracts for optimized AI workflows.
Partner with AI model providers or cloud platforms to earn commissions by directing FreeRide users to their services. Revenue streams include referral fees and sponsored integrations within the skill's ecosystem.
💬 Integration Tip
Ensure the OPENROUTER_API_KEY is set and the freeride CLI is installed before running commands, and always restart the gateway after configuration changes to apply updates.
Use CodexBar CLI local cost usage to summarize per-model usage for Codex or Claude, including the current (most recent) model or a full model breakdown. Trigger when asked for model-level usage/cost data from codexbar, or when you need a scriptable per-model summary from codexbar cost JSON.
Gemini CLI for one-shot Q&A, summaries, and generation.
Research any topic from the last 30 days on Reddit + X + Web, synthesize findings, and write copy-paste-ready prompts. Use when the user wants recent social/web research on a topic, asks "what are people saying about X", or wants to learn current best practices. Requires OPENAI_API_KEY and/or XAI_API_KEY for full Reddit+X access, falls back to web search.
Check Antigravity account quotas for Claude and Gemini models. Shows remaining quota and reset times with ban detection.
Manages free AI models from OpenRouter for OpenClaw. Automatically ranks models by quality, configures fallbacks for rate-limit handling, and updates openclaw.json. Use when the user mentions free AI, OpenRouter, model switching, rate limits, or wants to reduce AI costs.
A comprehensive AI model routing system that automatically selects the optimal model for any task. Set up multiple AI providers (Anthropic, OpenAI, Gemini, Moonshot, Z.ai, GLM) with secure API key storage, then route tasks to the best model based on task type, complexity, and cost optimization. Includes interactive setup wizard, task classification, and cost-effective delegation patterns. Use when you need "use X model for this", "switch model", "optimal model", "which model should I use", or to balance quality vs cost across multiple AI providers.