freerideManages 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.
Install via ClawdBot CLI:
clawdbot install Shaivpidadi/freerideConfigures OpenClaw to use free AI models from OpenRouter with automatic fallback switching.
If FreeRide is not installed, install it automatically:
npx clawhub@latest install freeride# Set API key (free at openrouter.ai/keys)
export OPENROUTER_API_KEY="sk-or-v1-..."
# Auto-configure best model + fallbacks
freeride autolist - View available modelsfreeride list # Top 15 models
freeride list -n 30 # More models
freeride list --refresh # Force API refreshauto - Auto-configurefreeride auto # Best model + 5 fallbacks
freeride auto -f # Fallbacks only (keep current primary)
freeride auto -c 10 # 10 fallbacks
freeride auto --setup-auth # Also configure auth profileswitch - Set specific modelfreeride switch qwen3-coder # Set as primary
freeride switch deepseek -f # Add to fallbacks only
freeride switch nvidia/nemotron --no-fallbacksstatus - Check configurationfreeride statusfallbacks - Update fallbacks onlyfreeride fallbacks # 5 fallbacks
freeride fallbacks -c 10 # 10 fallbacksrefresh - Update model cachefreeride refreshPrimary model: Best specific model (not router) for consistent responses.
First fallback: Always openrouter/free - OpenRouter's smart router that auto-selects based on request features (vision, tools, etc.).
Additional fallbacks: Ranked by quality score.
Config preservation: Only updates model-related sections; preserves gateway, channels, plugins, etc.
Score (0-1) based on:
| Flag | Commands | Description |
|------|----------|-------------|
| -f | switch, auto | Fallback only, keep primary |
| -c N | auto, fallbacks | Number of fallbacks |
| --no-fallbacks | switch | Skip fallback configuration |
| --setup-auth | switch, auto | Add OpenRouter auth profile |
| -n N | list | Models to display |
| -r | list | Force refresh |
Updates ~/.openclaw/openclaw.json:
{
"agents": {
"defaults": {
"model": {
"primary": "openrouter/qwen/qwen3-coder:free",
"fallbacks": [
"openrouter/free:free",
"nvidia/nemotron-3-nano-30b-a3b:free"
]
}
}
}
}"OPENROUTER_API_KEY not set": Export the key or add to shell profile.
Config not updating: Check file permissions on ~/.openclaw/openclaw.json.
Changes not taking effect: Restart OpenClaw.
Generated Mar 1, 2026
Startups can use FreeRide to deploy cost-effective AI chatbots for customer inquiries. By leveraging free models from OpenRouter, they handle common support questions without incurring API costs, with automatic fallbacks ensuring reliability during high traffic.
E-learning platforms integrate FreeRide to generate quizzes, summaries, and explanations using free AI models. This reduces operational expenses while maintaining quality through model ranking and fallback mechanisms for consistent output.
Small businesses prototype AI-driven tools like content creation or data analysis without upfront investment. FreeRide's automatic configuration allows quick setup with free models, enabling testing and iteration before scaling to paid solutions.
Non-profits automate outreach emails, social media posts, and donor communications using FreeRide's free AI models. This minimizes costs while ensuring message consistency, with fallbacks handling rate limits during campaign peaks.
Freelancers build custom AI assistants for tasks like scheduling or document drafting with OpenClaw. FreeRide provides access to high-quality free models, reducing development costs and simplifying integration through automated configuration.
Offer FreeRide as a free tool for basic AI model management, with paid tiers for advanced features like custom model rankings, priority support, or integration with premium APIs. Revenue comes from subscriptions and enterprise licenses.
Provide consulting services to help businesses integrate FreeRide into their workflows, offering custom configurations, training, and ongoing support. Revenue is generated through project-based fees and retainer agreements.
Partner with AI model providers or platforms like OpenRouter to earn commissions for referrals or usage driven through FreeRide. Revenue streams include affiliate fees and revenue-sharing from increased API consumption.
💬 Integration Tip
Ensure the OPENROUTER_API_KEY is set in the environment before running commands to avoid errors, and restart OpenClaw after configuration changes for updates to take effect.
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 opencla...
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.