freeride-aiManages 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/freeride-aiConfigures OpenClaw to use free AI models from OpenRouter with automatic fallback switching.
# 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 and indie developers can use this skill to access high-quality AI models without incurring costs, enabling rapid prototyping and testing of AI-powered applications. It automatically handles model selection and fallbacks, reducing setup time and ensuring reliable performance during development cycles.
Educational institutions can integrate this skill into learning platforms to provide students with free AI assistance for coding, research, and creative projects. The automatic fallback system ensures uptime during peak usage, making it suitable for classrooms or online courses with varying demand.
Content creators and marketers can leverage free AI models to generate text, analyze data, or automate social media posts while minimizing expenses. The skill's model ranking helps select the best-performing models for specific tasks like writing or image captioning, enhancing productivity.
Open-source communities can use this skill to offer AI-powered features in their projects without relying on paid APIs, making tools more accessible. It simplifies configuration and maintenance, allowing contributors to focus on development rather than managing AI service costs.
Companies can integrate this skill into their freemium products to provide basic AI functionalities for free users, reducing operational costs while upselling premium features. It leverages OpenRouter's free tier to maintain service quality, attracting users who may later convert to paid plans.
Agencies can offer consulting services to help businesses configure and optimize this skill for specific use cases, such as automating customer support or data analysis. Revenue comes from setup fees, ongoing maintenance, and training sessions tailored to client needs.
Developers can build and sell specialized tools or plugins that extend this skill's capabilities, such as adding analytics dashboards or advanced fallback strategies. This creates a marketplace around the OpenClaw ecosystem, generating revenue through licensing or one-time purchases.
💬 Integration Tip
Ensure the OPENROUTER_API_KEY is set in the environment before use, and regularly run 'freeride refresh' to keep model rankings up-to-date for optimal performance.
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...
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.