freeride-opencode
Configure and optimize OpenCode Zen free models with smart fallbacks for subtasks, heartbeat, and cron jobs. Use when setting up cost-effective AI model routing with automatic failover between free models.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/heldinhow/freeride-opencodeFreeride OpenCode
Configure OpenCode Zen free models with intelligent fallbacks to optimize costs while maintaining reliability.
⚠️ Important: To use this skill, you need two API keys:
- OpenCode Zen API key - For OpenCode free models (MiniMax M2.1, Kimi K2.5, GLM 4.7, GPT 5 Nano)
- OpenRouter API key - For OpenRouter free models (Trinity Large and other OpenRouter providers)
Configure both keys in your OpenCode/Zen settings before applying these configurations.
Quick Start
Apply optimal free model configuration with provider diversification:
{
"agents": {
"defaults": {
"model": {
"primary": "opencode/minimax-m2.1-free",
"fallbacks": [
"openrouter/arcee-ai/trinity-large-preview:free",
"opencode/kimi-k2.5-free"
]
},
"heartbeat": {
"model": "opencode/glm-4.7-free"
},
"subagents": {
"model": "opencode/kimi-k2.5-free"
}
}
}
}
🔑 API Keys Required
This skill uses models from two different providers, so you need both API keys configured:
1. OpenCode Zen API Key
Required for:
opencode/minimax-m2.1-freeopencode/kimi-k2.5-freeopencode/glm-4.7-freeopencode/gpt-5-nano
Where to get: Sign up at OpenCode Zen and generate an API key.
2. OpenRouter API Key
Required for:
openrouter/arcee-ai/trinity-large-preview:free- Any other OpenRouter free models you add
Where to get: Sign up at OpenRouter.ai and generate an API key.
Configuration
Add both keys to your OpenCode configuration:
{
"providers": {
"opencode": {
"api_key": "YOUR_OPENCODE_ZEN_API_KEY"
},
"openrouter": {
"api_key": "YOUR_OPENROUTER_API_KEY"
}
}
}
Fallback Behavior by Provider
- If OpenCode models fail → tries next OpenCode fallback or OpenRouter model
- If OpenRouter models fail → tries next OpenRouter or OpenCode fallback
- Configure both providers for maximum reliability
Model Selection Guide
See models.md for detailed model comparisons, capabilities, and provider information.
| Task Type | Recommended Model | Rationale |
|---|---|---|
| Primary/General | MiniMax M2.1 Free | Best free model capability |
| Fallback 1 | Trinity Large Free | Different provider (OpenRouter) for rate limit resilience |
| Fallback 2 | Kimi K2.5 Free | General purpose, balance |
| Heartbeat | GLM 4.7 Free | Multilingual, cost-effective for frequent checks |
| Subtasks/Subagents | Kimi K2.5 Free | Balanced capability for secondary tasks |
Free Models Available
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-heldinhow-freeride-opencode": {
"enabled": true,
"auto_update": true
}
}
}