{"id":"9dda9fc9-a4f2-4a5d-a7a0-ad5acf2c94b4","entityType":"agent","slug":"clawhub-shaivpidadi-freeride-ai","name":"Free Ride Unlimited free AI","canonicalUrl":"https://www.xpersona.co/agent/clawhub-shaivpidadi-freeride-ai","canonicalPath":"/agent/clawhub-shaivpidadi-freeride-ai","generatedAt":"2026-10-09T15:06:51.783Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"description":"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. Skill: Free Ride Unlimited free AI Owner: Shaivpidadi Summary: 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. Tags: latest:1.0.0 Version history: v1.0.0 | 2026-02-05T17:46:17.820Z | user - Initia","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 4/15/2026.","installCommand":"clawhub skill install kn7eepf540q01kxs5gzwnvsp5s80hhje:freeride-ai","sourceUrl":"https://clawhub.ai/Shaivpidadi/freeride-ai","homepage":"https://clawhub.ai/Shaivpidadi/freeride-ai","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/Shaivpidadi/freeride-ai","kind":"source"}],"safetyScore":84,"overallRank":62,"popularityScore":61,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Manages free AI models from OpenRouter for OpenClaw. Automatically ranks models by quality, configures fallbacks for rate-limit handling, and updates openclaw.j"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"stars":null,"forks":null,"downloads":1137,"packageName":null,"latestVersion":"1.0.0","tractionLabel":"1.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-03-01T00:12:02.213Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T00:45:39.800Z","lastCrawledAt":"2026-03-01T00:12:02.213Z","lastIndexedAt":null,"nextCrawlAt":"2026-03-02T00:12:02.213Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.0","createdAt":"2026-02-05T17:46:17.820Z","changelog":"- Initial release of the FreeRide skill for OpenClaw. - Enables automatic configuration of free AI models from OpenRouter, including quality-based ranking and fallback setup. - Updates openclaw.json with best primary model and fallbacks for handling rate limits. - Provides commands to list, switch, and manage models and fallbacks efficiently. - Designed to help users reduce AI costs and handle OpenRouter usage limits automatically.","fileCount":7,"zipByteSize":15006}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install kn7eepf540q01kxs5gzwnvsp5s80hhje:freeride-ai","setupComplexity":"medium","setupSteps":["Python environment detected. Create a strict virtual environment (`python -m venv .venv`) before installing dependencies to prevent system-level package conflicts.","Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-shaivpidadi-freeride-ai/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-shaivpidadi-freeride-ai/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-shaivpidadi-freeride-ai/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-shaivpidadi-freeride-ai/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-shaivpidadi-freeride-ai/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-shaivpidadi-freeride-ai/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-09T15:06:51.783Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-shaivpidadi-freeride-ai/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-shaivpidadi-freeride-ai/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-shaivpidadi-freeride-ai/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-shaivpidadi-freeride-ai/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"readme":"Skill: Free Ride Unlimited free AI\n\nOwner: Shaivpidadi\n\nSummary: 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.\n\nTags: latest:1.0.0\n\nVersion history:\n\nv1.0.0 | 2026-02-05T17:46:17.820Z | user\n\n- Initial release of the FreeRide skill for OpenClaw.\n- Enables automatic configuration of free AI models from OpenRouter, including quality-based ranking and fallback setup.\n- Updates openclaw.json with best primary model and fallbacks for handling rate limits.\n- Provides commands to list, switch, and manage models and fallbacks efficiently.\n- Designed to help users reduce AI costs and handle OpenRouter usage limits automatically.\n\nArchive index:\n\nArchive v1.0.0: 7 files, 15006 bytes\n\nFiles: main.py (26229b), README.md (6607b), requirements.txt (17b), skill.json (719b), SKILL.md (2965b), watcher.py (10519b), _meta.json (130b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: freeride\ndescription: 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.\n---\n\n# FreeRide - Free AI for OpenClaw\n\nConfigures OpenClaw to use free AI models from OpenRouter with automatic fallback switching.\n\n## Quick Start\n\n```bash\n# Set API key (free at openrouter.ai/keys)\nexport OPENROUTER_API_KEY=\"sk-or-v1-...\"\n\n# Auto-configure best model + fallbacks\nfreeride auto\n```\n\n## Commands\n\n### `list` - View available models\n\n```bash\nfreeride list              # Top 15 models\nfreeride list -n 30        # More models\nfreeride list --refresh    # Force API refresh\n```\n\n### `auto` - Auto-configure\n\n```bash\nfreeride auto              # Best model + 5 fallbacks\nfreeride auto -f           # Fallbacks only (keep current primary)\nfreeride auto -c 10        # 10 fallbacks\nfreeride auto --setup-auth # Also configure auth profile\n```\n\n### `switch` - Set specific model\n\n```bash\nfreeride switch qwen3-coder         # Set as primary\nfreeride switch deepseek -f         # Add to fallbacks only\nfreeride switch nvidia/nemotron --no-fallbacks\n```\n\n### `status` - Check configuration\n\n```bash\nfreeride status\n```\n\n### `fallbacks` - Update fallbacks only\n\n```bash\nfreeride fallbacks         # 5 fallbacks\nfreeride fallbacks -c 10   # 10 fallbacks\n```\n\n### `refresh` - Update model cache\n\n```bash\nfreeride refresh\n```\n\n## Behavior\n\n**Primary model**: Best specific model (not router) for consistent responses.\n\n**First fallback**: Always `openrouter/free` - OpenRouter's smart router that auto-selects based on request features (vision, tools, etc.).\n\n**Additional fallbacks**: Ranked by quality score.\n\n**Config preservation**: Only updates model-related sections; preserves gateway, channels, plugins, etc.\n\n## Model Ranking\n\nScore (0-1) based on:\n- Context length (40%)\n- Capabilities (30%)\n- Recency (20%)\n- Provider trust (10%)\n\n## Flags\n\n| Flag | Commands | Description |\n|------|----------|-------------|\n| `-f` | switch, auto | Fallback only, keep primary |\n| `-c N` | auto, fallbacks | Number of fallbacks |\n| `--no-fallbacks` | switch | Skip fallback configuration |\n| `--setup-auth` | switch, auto | Add OpenRouter auth profile |\n| `-n N` | list | Models to display |\n| `-r` | list | Force refresh |\n\n## Config Output\n\nUpdates `~/.openclaw/openclaw.json`:\n\n```json\n{\n  \"agents\": {\n    \"defaults\": {\n      \"model\": {\n        \"primary\": \"openrouter/qwen/qwen3-coder:free\",\n        \"fallbacks\": [\n          \"openrouter/free:free\",\n          \"nvidia/nemotron-3-nano-30b-a3b:free\"\n        ]\n      }\n    }\n  }\n}\n```\n\n## Troubleshooting\n\n**\"OPENROUTER_API_KEY not set\"**: Export the key or add to shell profile.\n\n**Config not updating**: Check file permissions on `~/.openclaw/openclaw.json`.\n\n**Changes not taking effect**: Restart OpenClaw.\n\nFile v1.0.0:README.md\n\n# 🎢 FreeRide\n\n### Stop paying for AI. Start riding free.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)\n[![OpenClaw Compatible](https://img.shields.io/badge/OpenClaw-Compatible-blue.svg)](https://github.com/openclaw/openclaw)\n[![OpenRouter](https://img.shields.io/badge/OpenRouter-30%2B%20Free%20Models-orange.svg)](https://openrouter.ai)\n\n---\n\n**FreeRide** gives you unlimited free AI in [OpenClaw](https://github.com/openclaw/openclaw) by automatically managing OpenRouter's free models.\n\n```\nYou: *hits rate limit*\nFreeRide: \"I got you.\" *switches to next best model*\nYou: *keeps coding*\n```\n\n## The Problem\n\nYou're using OpenClaw. You love it. But:\n\n- 💸 API costs add up fast\n- 🚫 Free models have rate limits\n- 😤 Manually switching models is annoying\n- 🤷 You don't know which free model is actually good\n\n## The Solution\n\nOne command. Free AI. Forever.\n\n```bash\nfreeride auto\n```\n\nThat's it. FreeRide:\n\n1. **Finds** the 30+ free models on OpenRouter\n2. **Ranks** them by quality (context length, capabilities, speed)\n3. **Sets** the best one as your primary\n4. **Configures** smart fallbacks for when you hit rate limits\n5. **Preserves** your existing OpenClaw config\n\n## Quick Start\n\n### 1. Get a Free OpenRouter Key\n\nGo to [openrouter.ai/keys](https://openrouter.ai/keys) → Create account → Generate key\n\nNo credit card. No trial. Actually free.\n\n### 2. Set Your Key\n\n```bash\nexport OPENROUTER_API_KEY=\"sk-or-v1-...\"\n```\n\n### 3. Run FreeRide\n\n```bash\nfreeride auto\n```\n\n### 4. Restart OpenClaw\n\nDone. You're now running on free AI with automatic fallbacks.\n\n## What You Get\n\n```\nPrimary Model: nvidia/nemotron-3-nano-30b-a3b:free (256K context)\n\nFallbacks:\n  1. openrouter/free         ← Smart router (auto-picks best available)\n  2. qwen/qwen3-coder:free   ← Great for coding\n  3. stepfun/step-3.5:free   ← Fast responses\n  4. deepseek/deepseek:free  ← Strong reasoning\n  5. mistral/mistral:free    ← Reliable fallback\n```\n\nWhen you hit a rate limit, OpenClaw automatically tries the next model. You keep working. No interruptions.\n\n## Commands\n\n| Command | What it does |\n|---------|--------------|\n| `freeride auto` | Auto-configure best model + fallbacks |\n| `freeride list` | See all 30+ free models ranked |\n| `freeride switch <model>` | Use a specific model |\n| `freeride status` | Check your current setup |\n\n### Pro Tips\n\n```bash\n# Already have a model you like? Just add fallbacks:\nfreeride auto -f\n\n# Want more fallbacks for maximum uptime?\nfreeride auto -c 10\n\n# Coding? Switch to the best coding model:\nfreeride switch qwen3-coder\n\n# See what's available:\nfreeride list -n 30\n```\n\n## How It Ranks Models\n\nFreeRide scores each model (0-1) based on:\n\n| Factor | Weight | Why |\n|--------|--------|-----|\n| Context Length | 40% | Longer = handle bigger codebases |\n| Capabilities | 30% | Vision, tools, structured output |\n| Recency | 20% | Newer models = better performance |\n| Provider Trust | 10% | Google, Meta, NVIDIA, etc. |\n\nThe **smart fallback** `openrouter/free` is always first - it auto-selects based on what your request needs.\n\n## FAQ\n\n**Is this actually free?**\n\nYes. OpenRouter provides free tiers for many models. You just need an account (no credit card).\n\n**What about rate limits?**\n\nThat's the whole point. FreeRide configures multiple fallbacks. When one model rate-limits you, OpenClaw automatically switches to the next.\n\n**Will it mess up my OpenClaw config?**\n\nNo. FreeRide only touches the model settings. Your gateway, channels, plugins, workspace - all preserved.\n\n**Which models are free?**\n\nRun `freeride list` to see current availability. It changes, which is why FreeRide exists.\n\n## The Math\n\n| Scenario | Monthly Cost |\n|----------|--------------|\n| GPT-4 API | $50-200+ |\n| Claude API | $50-200+ |\n| OpenClaw + FreeRide | **$0** |\n\nYou're welcome.\n\n## Requirements\n\n- [OpenClaw](https://github.com/openclaw/openclaw) installed\n- Python 3.8+\n- `requests` library (`pip install requests`)\n- Free OpenRouter account\n\n## Installation\n\n### Option 1: Download\n\n```bash\n# Download and extract\ncurl -L https://github.com/Shaivpidadi/agent-security-bonds-arc/releases/download/v1.0/freeride.zip -o freeride.zip\nunzip freeride.zip\ncd freeride\npip install -r requirements.txt\n```\n\n### Option 2: Clone\n\n```bash\ngit clone https://github.com/Shaivpidadi/agent-security-bonds-arc.git\ncd agent-security-bonds-arc/server/skills/freeride\npip install -r requirements.txt\n```\n\n### Option 3: ClaHub (Coming Soon)\n\n```bash\nclahub install freeride\n```\n\n## Architecture\n\n```\n┌──────────────┐     ┌──────────────┐     ┌──────────────────┐\n│  You         │ ──→ │  FreeRide    │ ──→ │  OpenRouter API  │\n│  \"freeride   │     │              │     │  (30+ free       │\n│   auto\"      │     │  • Fetch     │     │   models)        │\n└──────────────┘     │  • Rank      │     └──────────────────┘\n                     │  • Configure │\n                     └──────┬───────┘\n                            │\n                            ▼\n                     ┌──────────────┐\n                     │ ~/.openclaw/ │\n                     │ openclaw.json│\n                     └──────┬───────┘\n                            │\n                            ▼\n                     ┌──────────────┐\n                     │  OpenClaw    │\n                     │  (free AI!)  │\n                     └──────────────┘\n```\n\n## Contributing\n\nFound a bug? Want a feature? PRs welcome.\n\n```bash\n# Run tests\npython main.py list\npython main.py status\npython main.py auto --help\n```\n\n## Related Projects\n\n- [OpenClaw](https://github.com/openclaw/openclaw) - The AI coding agent\n- [OpenRouter](https://openrouter.ai) - The model router\n- [Arc Security](https://github.com/Shaivpidadi/agent-security-bonds-arc) - Secure skill marketplace\n\n## License\n\nMIT - Do whatever you want.\n\n---\n\n<p align=\"center\">\n  <b>Stop paying. Start riding.</b>\n  <br>\n  <br>\n  <a href=\"https://github.com/Shaivpidadi/agent-security-bonds-arc\">⭐ Star us on GitHub</a>\n  ·\n  <a href=\"https://openrouter.ai/keys\">🔑 Get OpenRouter Key</a>\n  ·\n  <a href=\"https://github.com/openclaw/openclaw\">🦞 Install OpenClaw</a>\n</p>\n\nFile v1.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn7eepf540q01kxs5gzwnvsp5s80hhje\",\n  \"slug\": \"freeride-ai\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1770313577820\n}\n\nFile v1.0.0:skill.json\n\n{\n  \"name\": \"freeride\",\n  \"displayName\": \"FreeRide - Free AI for OpenClaw\",\n  \"version\": \"1.0.0\",\n  \"description\": \"Unlimited free AI access for OpenClaw via OpenRouter's free models with automatic fallback switching\",\n  \"author\": \"OpenClaw Community\",\n  \"license\": \"MIT\",\n  \"commands\": [\n    \"list\",\n    \"switch\",\n    \"auto\",\n    \"status\",\n    \"refresh\",\n    \"fallbacks\"\n  ],\n  \"dependencies\": {\n    \"requests\": \">=2.31.0\"\n  },\n  \"config\": {\n    \"OPENROUTER_API_KEY\": {\n      \"description\": \"Your OpenRouter API key (get free at openrouter.ai)\",\n      \"required\": true,\n      \"env\": true\n    }\n  },\n  \"openclaw\": {\n    \"compatible\": true,\n    \"minVersion\": \"1.0.0\",\n    \"configPath\": \"~/.openclaw/openclaw.json\"\n  }\n}\n\nFile v1.0.0:requirements.txt\n\nrequests>=2.31.0","readmeExcerpt":"Skill: Free Ride Unlimited free AI Owner: Shaivpidadi Summary: 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. Tags: latest:1.0.0 Version history: v1.0.0 | 2026-02-05T17:46:17.820Z | user - Initia","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"# Set API key (free at openrouter.ai/keys)\nexport OPENROUTER_API_KEY=\"sk-or-v1-...\"\n\n# Auto-configure best model + fallbacks\nfreeride auto"},{"language":"bash","snippet":"freeride list              # Top 15 models\nfreeride list -n 30        # More models\nfreeride list --refresh    # Force API refresh"},{"language":"bash","snippet":"freeride auto              # Best model + 5 fallbacks\nfreeride auto -f           # Fallbacks only (keep current primary)\nfreeride auto -c 10        # 10 fallbacks\nfreeride auto --setup-auth # Also configure auth profile"},{"language":"bash","snippet":"freeride switch qwen3-coder         # Set as primary\nfreeride switch deepseek -f         # Add to fallbacks only\nfreeride switch nvidia/nemotron --no-fallbacks"},{"language":"bash","snippet":"freeride status"},{"language":"bash","snippet":"freeride fallbacks         # 5 fallbacks\nfreeride fallbacks -c 10   # 10 fallbacks"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: freeride\ndescription: 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.\n---\n\n# FreeRide - Free AI for OpenClaw\n\nConfigures OpenClaw to use free AI models from OpenRouter with automatic fallback switching.\n\n## Quick Start\n\n```bash\n# Set API key (free at openrouter.ai/keys)\nexport OPENROUTER_API_KEY=\"sk-or-v1-...\"\n\n# Auto-configure best model + fallbacks\nfreeride auto\n```\n\n## Commands\n\n### `list` - View available models\n\n```bash\nfreeride list              # Top 15 models\nfreeride list -n 30        # More models\nfreeride list --refresh    # Force API refresh\n```\n\n### `auto` - Auto-configure\n\n```bash\nfreeride auto              # Best model + 5 fallbacks\nfreeride auto -f           # Fallbacks only (keep current primary)\nfreeride auto -c 10        # 10 fallbacks\nfreeride auto --setup-auth # Also configure auth profile\n```\n\n### `switch` - Set specific model\n\n```bash\nfreeride switch qwen3-coder         # Set as primary\nfreeride switch deepseek -f         # Add to fallbacks only\nfreeride switch nvidia/nemotron --no-fallbacks\n```\n\n### `status` - Check configuration\n\n```bash\nfreeride status\n```\n\n### `fallbacks` - Update fallbacks only\n\n```bash\nfreeride fallbacks         # 5 fallbacks\nfreeride fallbacks -c 10   # 10 fallbacks\n```\n\n### `refresh` - Update model cache\n\n```bash\nfreeride refresh\n```\n\n## Behavior\n\n**Primary model**: Best specific model (not router) for consistent responses.\n\n**First fallback**: Always `openrouter/free` - OpenRouter's smart router that auto-selects based on request features (vision, tools, etc.).\n\n**Additional fallbacks**: Ranked by quality score.\n\n**Config preservation**: Only updates model-related sections; preserves gateway, channels, plugins, etc.\n\n## Model Ranking\n\nScore (0-1) based on:\n- Context length (40%)\n- Capabilities (30%)\n- Recency (20%)\n- Provider trust (10%)\n\n## Flags\n\n| Flag | Commands | Description |\n|------|----------|-------------|\n| `-f` | switch, auto | Fallback only, keep primary |\n| `-c N` | auto, fallbacks | Number of fallbacks |\n| `--no-fallbacks` | switch | Skip fallback configuration |\n| `--setup-auth` | switch, auto | Add OpenRouter auth profile |\n| `-n N` | list | Models to display |\n| `-r` | list | Force refresh |\n\n## Config Output\n\nUpdates `~/.openclaw/openclaw.json`:\n\n```json\n{\n  \"agents\": {\n    \"defaults\": {\n      \"model\": {\n        \"primary\": \"openrouter/qwen/qwen3-coder:free\",\n        \"fallbacks\": [\n          \"openrouter/free:free\",\n          \"nvidia/nemotron-3-nano-30b-a3b:free\"\n        ]\n      }\n    }\n  }\n}\n```\n\n## Troubleshooting\n\n**\"OPENROUTER_API_KEY not set\"**: Export the key or add to shell profile.\n\n**Config not updating**: Check file permissions on `~/.openclaw/openclaw.json`.\n\n**Changes not taking effect**: Restart OpenClaw."},{"path":"README.md","content":"# 🎢 FreeRide\n\n### Stop paying for AI. Start riding free.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)\n[![OpenClaw Compatible](https://img.shields.io/badge/OpenClaw-Compatible-blue.svg)](https://github.com/openclaw/openclaw)\n[![OpenRouter](https://img.shields.io/badge/OpenRouter-30%2B%20Free%20Models-orange.svg)](https://openrouter.ai)\n\n---\n\n**FreeRide** gives you unlimited free AI in [OpenClaw](https://github.com/openclaw/openclaw) by automatically managing OpenRouter's free models.\n\n```\nYou: *hits rate limit*\nFreeRide: \"I got you.\" *switches to next best model*\nYou: *keeps coding*\n```\n\n## The Problem\n\nYou're using OpenClaw. You love it. But:\n\n- 💸 API costs add up fast\n- 🚫 Free models have rate limits\n- 😤 Manually switching models is annoying\n- 🤷 You don't know which free model is actually good\n\n## The Solution\n\nOne command. Free AI. Forever.\n\n```bash\nfreeride auto\n```\n\nThat's it. FreeRide:\n\n1. **Finds** the 30+ free models on OpenRouter\n2. **Ranks** them by quality (context length, capabilities, speed)\n3. **Sets** the best one as your primary\n4. **Configures** smart fallbacks for when you hit rate limits\n5. **Preserves** your existing OpenClaw config\n\n## Quick Start\n\n### 1. Get a Free OpenRouter Key\n\nGo to [openrouter.ai/keys](https://openrouter.ai/keys) → Create account → Generate key\n\nNo credit card. No trial. Actually free.\n\n### 2. Set Your Key\n\n```bash\nexport OPENROUTER_API_KEY=\"sk-or-v1-...\"\n```\n\n### 3. Run FreeRide\n\n```bash\nfreeride auto\n```\n\n### 4. Restart OpenClaw\n\nDone. You're now running on free AI with automatic fallbacks.\n\n## What You Get\n\n```\nPrimary Model: nvidia/nemotron-3-nano-30b-a3b:free (256K context)\n\nFallbacks:\n  1. openrouter/free         ← Smart router (auto-picks best available)\n  2. qwen/qwen3-coder:free   ← Great for coding\n  3. stepfun/step-3.5:free   ← Fast responses\n  4. deepseek/deepseek:free  ← Strong reasoning\n  5. mistral/mistral:free    ← Reliable fallback\n```\n\nWhen you hit a rate limit, OpenClaw automatically tries the next model. You keep working. No interruptions.\n\n## Commands\n\n| Command | What it does |\n|---------|--------------|\n| `freeride auto` | Auto-configure best model + fallbacks |\n| `freeride list` | See all 30+ free models ranked |\n| `freeride switch <model>` | Use a specific model |\n| `freeride status` | Check your current setup |\n\n### Pro Tips\n\n```bash\n# Already have a model you like? Just add fallbacks:\nfreeride auto -f\n\n# Want more fallbacks for maximum uptime?\nfreeride auto -c 10\n\n# Coding? Switch to the best coding model:\nfreeride switch qwen3-coder\n\n# See what's available:\nfreeride list -n 30\n```\n\n## How It Ranks Models\n\nFreeRide scores each model (0-1) based on:\n\n| Factor | Weight | Why |\n|--------|--------|-----|\n| Context Length | 40% | Longer = handle bigger codebases |\n| Capabilities | 30% | Vision, tools, structured output |\n| Recency | 20% | Newer models = better performance |\n| Provider Trust | 10% | Google, Meta, NVI"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7eepf540q01kxs5gzwnvsp5s80hhje\",\n  \"slug\": \"freeride-ai\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1770313577820\n}"},{"path":"skill.json","content":"{\n  \"name\": \"freeride\",\n  \"displayName\": \"FreeRide - Free AI for OpenClaw\",\n  \"version\": \"1.0.0\",\n  \"description\": \"Unlimited free AI access for OpenClaw via OpenRouter's free models with automatic fallback switching\",\n  \"author\": \"OpenClaw Community\",\n  \"license\": \"MIT\",\n  \"commands\": [\n    \"list\",\n    \"switch\",\n    \"auto\",\n    \"status\",\n    \"refresh\",\n    \"fallbacks\"\n  ],\n  \"dependencies\": {\n    \"requests\": \">=2.31.0\"\n  },\n  \"config\": {\n    \"OPENROUTER_API_KEY\": {\n      \"description\": \"Your OpenRouter API key (get free at openrouter.ai)\",\n      \"required\": true,\n      \"env\": true\n    }\n  },\n  \"openclaw\": {\n    \"compatible\": true,\n    \"minVersion\": \"1.0.0\",\n    \"configPath\": \"~/.openclaw/openclaw.json\"\n  }\n}"},{"path":"requirements.txt","content":"requests>=2.31.0"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"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. Skill: Free Ride Unlimited free AI Owner: Shaivpidadi Summary: 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. Tags: latest:1.0.0 Version history: v1.0.0 | 2026-02-05T17:46:17.820Z | user - Initia","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1050,"uniquenessScore":45,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T15:06:51.783Z","emptyReason":null},"items":[{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-10T18:48:31.762Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}