freeride

What This Skill Does

The FreeRide skill for OpenClaw is an intelligent configuration manager designed to optimize your AI experience by leveraging free models from the OpenRouter ecosystem. Instead of manually searching for high-performing free models or dealing with disruptive rate limits, FreeRide automates the entire process. It continuously benchmarks and ranks available free models based on context length, capabilities, recency, and provider reliability. When you execute commands like freeride auto, the skill automatically updates your openclaw.json configuration file, ensuring you always have a high-performing primary model and a robust set of fallback models ready if the primary encounters traffic spikes or service outages.

Installation

To begin using FreeRide, you must have OpenClaw installed. First, ensure you have an API key from OpenRouter. You can obtain one for free at openrouter.ai/keys. Once you have the key, set it as an environment variable in your terminal session or add it to your shell configuration file using export OPENROUTER_API_KEY="sk-or-v1-...". Finally, run the following installation command in your terminal: clawhub install openclaw/skills/skills/shaivpidadi/freeride-ai. After installation, simply run freeride auto to initialize your configuration and start utilizing free AI models immediately.

Use Cases

FreeRide is ideal for power users who want to reduce AI overhead costs while maintaining high-quality outputs. It is particularly useful for developers who frequently hit rate limits on premium models and need a seamless "failover" experience. It also serves those who want to experiment with the latest open-weight models (like Qwen, Nemotron, or DeepSeek) without spending credits. By automating the model switching process, it allows you to focus on your work rather than maintaining configuration files.

Example Prompts

1. "OpenClaw, switch to a free AI model to help me save on my monthly bill."
2. "I keep getting rate-limited by the current model; can you configure some fallbacks using FreeRide?"
3. "Show me the best-ranked free models available right now and update my primary model to the top choice."

Tips & Limitations

• Proactive Management: Use freeride refresh periodically to ensure your list of available models reflects the latest updates from OpenRouter.
• Customization: Use the -c flag with the auto command if you prefer a larger pool of fallbacks for maximum resilience during high-traffic periods.
• Non-Destructive: The skill is designed to be "config-safe"; it only modifies the model-specific sections of your configuration, ensuring that your existing plugins, channels, and gateway settings remain intact.
• Dependencies: Keep in mind that this skill relies on the OpenRouter API. If the API is down or your API key is invalid, the model switching will fail. Always verify your status using freeride status if you notice unexpected behavior.