Xpersona
Claim this agent
agentCLAWHUBUnverified

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.

OpenClaw
View on ClawHub

Rank

62

Safety

84

Downloads

815

Updated

Apr 15, 2026

Version

1.2.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 815 downloads reported by the source. Last updated 4/15/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Apr 15, 2026
Protocol compatibility
OpenClawcompatibility · observed Apr 15, 2026
Adoption signal
815 downloadsadoption · observed Apr 15, 2026
Latest release
1.2.0release · observed Feb 10, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install kn74nrx32v4n0423jptzg1v5kx80ssnf:freeride-opencode
  1. Install using `clawhub skill install kn74nrx32v4n0423jptzg1v5kx80ssnf:freeride-opencode` in an isolated environment before connecting it to live workloads.
  2. No published capability contract is available yet, so validate auth and request/response behavior manually.
  3. Review the upstream CLAWHUB listing at https://clawhub.ai/Heldinhow/freeride-opencode before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-heldinhow-freeride-opencode/snapshot"

Documentation

CLAWHUB

50,607 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: freeride-opencode
description: 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.
version: 1.2.0
---

# Freeride 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**:
> 1. **OpenCode Zen API key** - For OpenCode free models (MiniMax M2.1, Kimi K2.5, GLM 4.7, GPT 5 Nano)
> 2. **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:

```json
{
  "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-free`
- `opencode/kimi-k2.5-free`
- `opencode/glm-4.7-free`
- `opencode/gpt-5-nano`

**Where to get:** Sign up at [OpenCode Zen](https://opencode.ai) 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](https://openrouter.ai) and generate an API key.

### Configuration

Add both keys to your OpenCode configuration:

```json
{
  "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](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

README.md

# Freeride OpenCode Skill

> ⚠️ **Para funcionar, são necessárias duas API keys:**
> - **OpenCode Zen API key** - Para modelos OpenCode (MiniMax M2.1, Kimi K2.5, GLM 4.7, GPT 5 Nano)
> - **OpenRouter API key** - Para modelos OpenRouter (Trinity Large e outros)

## Descrição

Configure modelos free do OpenCode Zen com fallbacks inteligentes para otimizar custos mantendo confiabilidade.

## Quick Start

```json
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "opencode/minimax-m2.1-free",
        "fallbacks": [
          "openrouter/arcee-ai/trinity-large-preview:free",
          "opencode/kimi-k2.5-free"
        ]
      }
    }
  }
}
```

## Documentação Completa

Veja [SKILL.md](SKILL.md) para documentação detalhada.

## Modelos Disponíveis

| Modelo | Provider | ID | Posição |
|--------|----------|-----|---------|
| MiniMax M2.1 | OpenCode | `opencode/minimax-m2.1-free` | Primary |
| Trinity Large | OpenRouter | `openrouter/arcee-ai/trinity-large-preview:free` | Fallback 1 |
| Kimi K2.5 | OpenCode | `opencode/kimi-k2.5-free` | Fallback 2 |

## Versão

1.2.0

_meta.json

{
  "ownerId": "kn74nrx32v4n0423jptzg1v5kx80ssnf",
  "slug": "freeride-opencode",
  "version": "1.2.0",
  "publishedAt": 1770728122855
}

references/models.md

# OpenCode Zen Free Models Reference

> **⚠️ API Keys Required:**
> - **OpenCode models:** Requires OpenCode Zen API key
> - **OpenRouter models:** Requires OpenRouter API key
>
> Configure both keys in your OpenCode settings for full fallback coverage.

## Complete Model List

### MiniMax M2.1 Free (Primary)
- **ID:** `opencode/minimax-m2.1-free`
- **Provider:** MiniMax (via OpenCode)
- **Best for:** Complex coding tasks, reasoning, multi-step workflows
- **Context:** Large context window
- **Strengths:** Strong coding capability, good reasoning

### Trinity Large Free (Fallback 1 - Different Provider)
- **ID:** `openrouter/arcee-ai/trinity-large-preview:free`
- **Provider:** Arcee AI (via OpenRouter)
- **Best for:** Complex reasoning, coding, multi-step workflows
- **Context:** Large context window
- **Strengths:** High-quality model, **different provider** for rate limit resilience
- **Why Fallback 1:** Being on OpenRouter, this model remains available when OpenCode models are rate-limited

### Kimi K2.5 Free (Fallback 2)
- **ID:** `opencode/kimi-k2.5-free`
- **Provider:** Moonshot AI (Kimi) (via OpenCode)
- **Best for:** General purpose, balanced performance
- **Context:** Large context window
- **Strengths:** Good all-around model, reliable responses

### GLM 4.7 Free
- **ID:** `opencode/glm-4.7-free`
- **Provider:** Zhipu AI (GLM)
- **Best for:** Multilingual tasks, alternative provider fallback
- **Context:** Medium-large context
- **Strengths:** Multilingual support, different provider ecosystem

### GPT 5 Nano
- **ID:** `opencode/gpt-5-nano`
- **Provider:** OpenAI
- **Best for:** Simple tasks, high-frequency operations, quick checks
- **Context:** Smaller context window
- **Strengths:** Fastest responses, lowest cost

## Provider Information

### OpenCode (MiniMax, Moonshot AI/Kimi)
- Primary provider for free models
- Requires OpenCode Zen API key
- Models: MiniMax M2.1, Kimi K2.5

### OpenRouter (Arcee AI/Trinity Large)
- **Different provider** from OpenCode
- Aggregation platform with multiple model providers
- Trinity Large: Arcee AI's large language model
- Focus: High-quality reasoning and coding
- **Requires OpenRouter API key** (separate from OpenCode Zen)
- **Key benefit:** Rate limits on OpenCode do NOT affect OpenRouter models

## Rate Limits by Model

| Model | Typical Rate Limits | Notes |
|-------|--------------------|-------|
| MiniMax M2.1 Free | Medium | Most popular free model |
| Trinity Large Free | Medium | **Different provider** - available when OpenCode is rate-limited |
| Kimi K2.5 Free | Medium-High | Good availability within OpenCode |

## Performance Comparison

| Model | Speed | Capability | Provider Diversification |
|-------|-------|------------|-------------------------|
| MiniMax M2.1 Free | Medium | Highest | Primary (OpenCode) |
| Trinity Large Free | Medium | High | Fallback 1 (OpenRouter) ✅ |
| Kimi K2.5 Free | Medium-High | High | Fallback 2 (OpenCode) |

## Configuration Tips

### For High-Volume Tas

references/templates.md

# Configuration Templates

## Minimal Template (Just Fallbacks)

```json
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "opencode/minimax-m2.1-free",
        "fallbacks": [
          "openrouter/arcee-ai/trinity-large-preview:free",
          "opencode/kimi-k2.5-free"
        ]
      }
    }
  }
}
```

## Complete Template (All Optimizations)

```json
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "opencode/minimax-m2.1-free",
        "fallbacks": [
          "openrouter/arcee-ai/trinity-large-preview:free",
          "opencode/kimi-k2.5-free"
        ]
      },
      "models": {
        "opencode/minimax-m2.1-free": { "alias": "MiniMax M2.1" },
        "openrouter/arcee-ai/trinity-large-preview:free": { "alias": "Trinity Large" },
        "opencode/kimi-k2.5-free": { "alias": "Kimi K2.5" },
        "opencode/glm-4.7-free": { "alias": "GLM 4.7" }
      },
      "heartbeat": {
        "every": "30m",
        "model": "opencode/glm-4.7-free"
      },
      "subagents": {
        "model": "opencode/kimi-k2.5-free"
      }
    }
  }
}
```

## Cost-Optimized Template (Cheapest First)

```json
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "opencode/glm-4.7-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"
      }
    }
  }
}
```

## Performance-Optimized Template (Best First)

```json
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "opencode/minimax-m2.1-free",
        "fallbacks": [
          "openrouter/arcee-ai/trinity-large-preview:free"
        ]
      },
      "heartbeat": {
        "model": "opencode/glm-4.7-free"
      },
      "subagents": {
        "model": "opencode/kimi-k2.5-free"
      }
    }
  }
}
```

## Subagent-Only Template

```json
{
  "agents": {
    "defaults": {
      "subagents": {
        "model": "opencode/kimi-k2.5-free"
      }
    }
  }
}
```

## Cron-Specific Template

```json
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "opencode/glm-4.7-free",
        "fallbacks": [
          "opencode/kimi-k2.5-free"
        ]
      }
    }
  }
}
```

## Applying Templates

> **⚠️ Prerequisites:** Ensure you have both API keys configured before applying templates:
> - OpenCode Zen API key (for `opencode/*` models)
> - OpenRouter API key (for `openrouter/*` models - Trinity Large)
>
> Without both keys, fallbacks will fail when switching providers.

### Via CLI

```bash
openclaw config.patch --raw '{
  "agents": {
    "defaults": {
      "model": {
        "primary": "opencode/minimax-m2.1-free",
        "fallbacks": ["openrouter/arcee-ai/trinity-large-preview:free", "opencode/kimi-k2.5-free"]
      }
    }
  }
}'
```

### Via Gateway API

```bash
openclaw gateway call config.patch --params '{
  "

Related agents

Same protocol, similar job.

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/Heldinhow/freeride-opencode",
      "sourceUrl": "https://clawhub.ai/Heldinhow/freeride-opencode",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-04-15T00:45:39.800Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-heldinhow-freeride-opencode/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-heldinhow-freeride-opencode/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-04-15T00:45:39.800Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "815 downloads",
      "href": "https://clawhub.ai/Heldinhow/freeride-opencode",
      "sourceUrl": "https://clawhub.ai/Heldinhow/freeride-opencode",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-04-15T00:45:39.800Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "1.2.0",
      "href": "https://clawhub.ai/Heldinhow/freeride-opencode",
      "sourceUrl": "https://clawhub.ai/Heldinhow/freeride-opencode",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-02-10T12:55:22.855Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-heldinhow-freeride-opencode/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-heldinhow-freeride-opencode/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 1.2.0",
      "description": "Provider diversification strategy: Trinity Large via OpenRouter as first fallback to maximize resilience against rate limits.",
      "href": "https://clawhub.ai/Heldinhow/freeride-opencode",
      "sourceUrl": "https://clawhub.ai/Heldinhow/freeride-opencode",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-02-10T12:55:22.855Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 9, 2026.

Sponsored

Ads related to Freeride Opencode and adjacent AI workflows.