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

• 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.

Archive index:

Archive v1.0.0: 7 files, 15006 bytes

Files: main.py (26229b), README.md (6607b), requirements.txt (17b), skill.json (719b), SKILL.md (2965b), watcher.py (10519b), _meta.json (130b)

File v1.0.0:SKILL.md

---

name: freeride 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.

FreeRide - Free AI for OpenClaw

Configures OpenClaw to use free AI models from OpenRouter with automatic fallback switching.

Quick Start

# Set API key (free at openrouter.ai/keys)
export OPENROUTER_API_KEY="sk-or-v1-..."

# Auto-configure best model + fallbacks
freeride auto

Commands

list - View available models

freeride list              # Top 15 models
freeride list -n 30        # More models
freeride list --refresh    # Force API refresh

auto - Auto-configure

freeride 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 profile

switch - Set specific model

freeride switch qwen3-coder         # Set as primary
freeride switch deepseek -f         # Add to fallbacks only
freeride switch nvidia/nemotron --no-fallbacks

status - Check configuration

freeride status

fallbacks - Update fallbacks only

freeride fallbacks         # 5 fallbacks
freeride fallbacks -c 10   # 10 fallbacks

refresh - Update model cache

freeride refresh

Behavior

Primary 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.

Model Ranking

Score (0-1) based on:

• Context length (40%)
• Capabilities (30%)
• Recency (20%)
• Provider trust (10%)

Flags

| 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 |

Config Output

Updates ~/.openclaw/openclaw.json:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "openrouter/qwen/qwen3-coder:free",
        "fallbacks": [
          "openrouter/free:free",
          "nvidia/nemotron-3-nano-30b-a3b:free"
        ]
      }
    }
  }
}

Troubleshooting

"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.

File v1.0.0:README.md

🎢 FreeRide

Stop paying for AI. Start riding free.

---

FreeRide gives you unlimited free AI in OpenClaw by automatically managing OpenRouter's free models.

You: *hits rate limit*
FreeRide: "I got you." *switches to next best model*
You: *keeps coding*

The Problem

You're using OpenClaw. You love it. But:

• 💸 API costs add up fast
• 🚫 Free models have rate limits
• 😤 Manually switching models is annoying
• 🤷 You don't know which free model is actually good

The Solution

One command. Free AI. Forever.

freeride auto

That's it. FreeRide:

1. Finds the 30+ free models on OpenRouter
2. Ranks them by quality (context length, capabilities, speed)
3. Sets the best one as your primary
4. Configures smart fallbacks for when you hit rate limits
5. Preserves your existing OpenClaw config

Quick Start

1. Get a Free OpenRouter Key

Go to openrouter.ai/keys → Create account → Generate key

No credit card. No trial. Actually free.

2. Set Your Key

export OPENROUTER_API_KEY="sk-or-v1-..."

3. Run FreeRide

freeride auto

4. Restart OpenClaw

Done. You're now running on free AI with automatic fallbacks.

What You Get

Primary Model: nvidia/nemotron-3-nano-30b-a3b:free (256K context)

Fallbacks:
  1. openrouter/free         ← Smart router (auto-picks best available)
  2. qwen/qwen3-coder:free   ← Great for coding
  3. stepfun/step-3.5:free   ← Fast responses
  4. deepseek/deepseek:free  ← Strong reasoning
  5. mistral/mistral:free    ← Reliable fallback

When you hit a rate limit, OpenClaw automatically tries the next model. You keep working. No interruptions.

Commands

| Command | What it does | |---------|--------------| | freeride auto | Auto-configure best model + fallbacks | | freeride list | See all 30+ free models ranked | | freeride switch <model> | Use a specific model | | freeride status | Check your current setup |

Pro Tips

# Already have a model you like? Just add fallbacks:
freeride auto -f

# Want more fallbacks for maximum uptime?
freeride auto -c 10

# Coding? Switch to the best coding model:
freeride switch qwen3-coder

# See what's available:
freeride list -n 30

How It Ranks Models

FreeRide scores each model (0-1) based on:

| Factor | Weight | Why | |--------|--------|-----| | Context Length | 40% | Longer = handle bigger codebases | | Capabilities | 30% | Vision, tools, structured output | | Recency | 20% | Newer models = better performance | | Provider Trust | 10% | Google, Meta, NVIDIA, etc. |

The smart fallback openrouter/free is always first - it auto-selects based on what your request needs.

FAQ

Is this actually free?

Yes. OpenRouter provides free tiers for many models. You just need an account (no credit card).

What about rate limits?

That's the whole point. FreeRide configures multiple fallbacks. When one model rate-limits you, OpenClaw automatically switches to the next.

Will it mess up my OpenClaw config?

No. FreeRide only touches the model settings. Your gateway, channels, plugins, workspace - all preserved.

Which models are free?

Run freeride list to see current availability. It changes, which is why FreeRide exists.

The Math

| Scenario | Monthly Cost | |----------|--------------| | GPT-4 API | $50-200+ | | Claude API | $50-200+ | | OpenClaw + FreeRide | $0 |

You're welcome.

Requirements

• OpenClaw installed
• Python 3.8+
• requests library (pip install requests)
• Free OpenRouter account

Installation

Option 1: Download

# Download and extract
curl -L https://github.com/Shaivpidadi/agent-security-bonds-arc/releases/download/v1.0/freeride.zip -o freeride.zip
unzip freeride.zip
cd freeride
pip install -r requirements.txt

Option 2: Clone

git clone https://github.com/Shaivpidadi/agent-security-bonds-arc.git
cd agent-security-bonds-arc/server/skills/freeride
pip install -r requirements.txt

Option 3: ClaHub (Coming Soon)

clahub install freeride

Architecture

┌──────────────┐     ┌──────────────┐     ┌──────────────────┐
│  You         │ ──→ │  FreeRide    │ ──→ │  OpenRouter API  │
│  "freeride   │     │              │     │  (30+ free       │
│   auto"      │     │  • Fetch     │     │   models)        │
└──────────────┘     │  • Rank      │     └──────────────────┘
                     │  • Configure │
                     └──────┬───────┘
                            │
                            ▼
                     ┌──────────────┐
                     │ ~/.openclaw/ │
                     │ openclaw.json│
                     └──────┬───────┘
                            │
                            ▼
                     ┌──────────────┐
                     │  OpenClaw    │
                     │  (free AI!)  │
                     └──────────────┘

Contributing

Found a bug? Want a feature? PRs welcome.

# Run tests
python main.py list
python main.py status
python main.py auto --help

Related Projects

• OpenClaw - The AI coding agent
• OpenRouter - The model router
• Arc Security - Secure skill marketplace

License

MIT - Do whatever you want.

---

<p align="center"> <b>Stop paying. Start riding.</b> <br> <br> <a href="https://github.com/Shaivpidadi/agent-security-bonds-arc">⭐ Star us on GitHub</a> · <a href="https://openrouter.ai/keys">🔑 Get OpenRouter Key</a> · <a href="https://github.com/openclaw/openclaw">🦞 Install OpenClaw</a> </p>

File v1.0.0:_meta.json

{ "ownerId": "kn7eepf540q01kxs5gzwnvsp5s80hhje", "slug": "freeride-ai", "version": "1.0.0", "publishedAt": 1770313577820 }

File v1.0.0:skill.json

{ "name": "freeride", "displayName": "FreeRide - Free AI for OpenClaw", "version": "1.0.0", "description": "Unlimited free AI access for OpenClaw via OpenRouter's free models with automatic fallback switching", "author": "OpenClaw Community", "license": "MIT", "commands": [ "list", "switch", "auto", "status", "refresh", "fallbacks" ], "dependencies": { "requests": ">=2.31.0" }, "config": { "OPENROUTER_API_KEY": { "description": "Your OpenRouter API key (get free at openrouter.ai)", "required": true, "env": true } }, "openclaw": { "compatible": true, "minVersion": "1.0.0", "configPath": "~/.openclaw/openclaw.json" } }

File v1.0.0:requirements.txt

requests>=2.31.0