← Back to Skills Marketplace
Free Ride - Unlimited free AI
by
Shaishav Pidadi
· GitHub ↗
· v1.0.11
· MIT-0
67453
Downloads
469
Stars
532
Active Installs
9
Versions
Install in OpenClaw
/install free-ride
Description
Manages free AI models from OpenRouter for OpenClaw. Automatically ranks models by quality, configures fallbacks for rate-limit handling, and updates opencla...
Usage Guidance
Install only if you want this skill to manage OpenClaw’s default and fallback model configuration. Back up ~/.openclaw/openclaw.json first, keep the OpenRouter key private, and run freeride-watcher only if you knowingly want a background process that can keep changing model settings automatically.
Capability Analysis
Type: OpenClaw Skill
Name: free-ride
Version: 1.0.11
The FreeRide skill bundle is a legitimate utility designed to manage and rotate free AI models from OpenRouter within the OpenClaw ecosystem. The code (main.py, watcher.py) performs transparent operations such as fetching model lists from the OpenRouter API, ranking them based on quality metrics, and updating the local OpenClaw configuration file (~/.openclaw/openclaw.json). It includes a background daemon (watcher.py) for health monitoring and automatic failover, which is clearly documented in SKILL.md and README.md. No evidence of data exfiltration, malicious execution, or prompt injection was found; all network activity is restricted to openrouter.ai as declared.
Capability Assessment
Purpose & Capability
Fetching and ranking OpenRouter free models, updating OpenClaw model settings, and rebuilding fallback chains are coherent with the stated purpose.
Instruction Scope
Activation is broad for a config-changing skill, and the workflow tells the agent to update OpenClaw configuration and restart the gateway without a prominent confirmation step.
Install Mechanism
Installation is a normal editable Python package install, but the dependency range is not pinned, so users inherit dependency drift.
Credentials
The OpenRouter API key, outbound OpenRouter access, cache/state files, and targeted writes to ~/.openclaw/openclaw.json are disclosed and mostly proportionate to the integration.
Persistence & Privilege
The optional freeride-watcher can be launched with nohup, probes every 60 seconds, and may rewrite model configuration automatically after the initiating session ends.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install free-ride - After installation, invoke the skill by name or use
/free-ride - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.11
- Added .gitignore file to manage untracked files in the repository.
- Documentation improvements in SKILL.md: clarified the daemon usage in the Watcher section, added the freeride rotate command description, and expanded instructions for unattended setups.
- No changes to user-facing commands or logic.
v1.0.9
- Automatically configures OpenClaw to use free AI models from OpenRouter, ranking by quality and setting up fallback models to handle rate limits.
- Updates only specific keys in `~/.openclaw/openclaw.json` to preserve the user's existing configuration.
- Provides a detailed command reference, including model switching, fallback configuration, and cache refresh.
- Introduces a watcher utility for automatic fallback rotation.
- Includes setup, troubleshooting guidance, and clear prerequisites for seamless integration.
v1.0.8
- Added formal SKILL metadata section with required environment variable (OPENROUTER_API_KEY), network permissions (openrouter.ai), install instructions, and files written by the skill.
- No changes to functionality or commands; documentation and configuration remain the same.
- Clarified and documented file writes to openclaw-related JSON files for transparency and stronger integration.
v1.0.7
- Adds detailed SKILL.md documentation for the freeride skill.
- Clearly explains prerequisites, primary workflow, command reference, config changes, optional watcher, and troubleshooting steps.
- No code changes or functionality updates detailed.
v1.0.5
- No code or documentation changes detected in this version.
- This release maintains all previous functionality and instructions.
v1.0.4
- Added Python packaging support with a new setup.py file to enable installation via pip.
- Updated documentation in SKILL.md for clearer, step-by-step installation and usage instructions.
- Expanded troubleshooting section and clarified prerequisites for smoother user onboarding.
- Added new watcher command documentation for advanced auto-rotation features.
v1.0.3
- Added installation instructions for FreeRide using npx clawhub.
- No other changes detected to functionality, commands, or flags.
- Documentation now helps users install the skill more easily if it's missing.
v1.0.2
- Initial release of the FreeRide skill for OpenClaw.
- Automatically ranks and configures free OpenRouter AI models by quality.
- Sets up automatic fallback handling for rate limits, including the OpenRouter smart router.
- Updates only the model configuration in openclaw.json, preserving other user settings.
- Includes commands for listing models, auto-configuration, switching models, updating fallbacks, checking status, and refreshing the model cache.
v1.0.0
Initial release of FreeRide, a tool to manage free AI models for OpenClaw via OpenRouter.
- Automatically ranks and configures the best free AI models with fallback options to handle rate limits.
- Supports listing available models, auto-configuring with best-ranked and fallback models, and switching models as needed.
- Preserves non-model sections of OpenClaw configuration during updates.
- Uses a quality-based ranking system factoring in context length, capabilities, recency, and provider trust.
- Provides clear commands for refreshing model data, checking status, and troubleshooting setup issues.
Metadata
Frequently Asked Questions
What is Free Ride - Unlimited free AI?
Manages free AI models from OpenRouter for OpenClaw. Automatically ranks models by quality, configures fallbacks for rate-limit handling, and updates opencla... It is an AI Agent Skill for Claude Code / OpenClaw, with 67453 downloads so far.
How do I install Free Ride - Unlimited free AI?
Run "/install free-ride" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Free Ride - Unlimited free AI free?
Yes, Free Ride - Unlimited free AI is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Free Ride - Unlimited free AI support?
Free Ride - Unlimited free AI is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Free Ride - Unlimited free AI?
It is built and maintained by Shaishav Pidadi (@shaivpidadi); the current version is v1.0.11.
More Skills