FreeRide — Free AI Model Manager for OpenClaw
Automatically ranks OpenRouter's free models and wires them into OpenClaw as primary plus a rate-limit-proof fallback chain.
UtilitiesIntermediate★ 231⑂ 39AI score 8/10Last updated: May 7, 2026
What it does
- Fetches OpenRouter's free (:free) model catalog and ranks it by quality.
- Sets the best free model as primary and builds a fallback chain so rate limits don't interrupt your session (the first fallback is always OpenRouter's smart router
openrouter/free). - Touches only
agents.defaults.modelandagents.defaults.modelsin~/.openclaw/openclaw.json; gateway, channels, plugins, env and custom instructions stay intact. - Ships a slim background daemon (
freeride-watcher) that probes the primary every 60s and rebuilds the chain with live-verified models when everything is throttled. - Includes a command reference table and a troubleshooting table for missing keys, missing CLI, and config not taking effect.
Who it's for
- OpenClaw users who want to drive inference cost to near zero.
- Anyone tired of free-tier rate limits killing a session mid-task.
- Operators running unattended OpenClaw instances that need self-healing model selection.
- Note: without OpenClaw and an OpenRouter API key this skill has essentially no use.
Usage examples
- "Set me up with free AI" → run
freeride auto, thenopenclaw gateway restart, and confirm with/status. - "Switch me to a coding model" →
freeride switch qwen3-coder, or add-fto register it as fallback only. - "I keep hitting rate limits" →
freeride rotateto live-test and rebuild the chain; for unattended boxes launchnohup freeride-watcher &.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/Shaivpidadi/FreeRide/HEAD/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the SKILL.m folder from the GitHub repo Shaivpidadi/FreeRide into my ~/.claude/skills/freeride/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/Shaivpidadi/FreeRide.git ~/.openclaw/workspace/skills/free-ride && cd ~/.openclaw/workspace/skills/free-ride && pip install -e .⚠ This is a third-party skill. Check the source repository before installing.
- Get an API key — create a free key at https://openrouter.ai/keys.
- Export it —
export OPENROUTER_API_KEY="sk-or-v1-...", or persist it withopenclaw config set env.OPENROUTER_API_KEY "sk-or-v1-...". - Clone the skill —
git clone https://github.com/Shaivpidadi/FreeRide.git ~/.openclaw/workspace/skills/free-ride - Install the CLI —
cd ~/.openclaw/workspace/skills/free-ride && pip install -e . - Verify —
which freerideshould print a path. - Apply config — run
freeride auto, thenopenclaw gateway restart. - Confirm — send
/statusin a chat and check the primary looks likeopenrouter/<provider>/<model>:free.