{
  "schemaVersion": "1.0",
  "item": {
    "slug": "freeride-opencode",
    "name": "Freeride Opencode",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/Heldinhow/freeride-opencode",
    "canonicalUrl": "https://clawhub.ai/Heldinhow/freeride-opencode",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "manual_only",
    "downloadUrl": "/downloads/freeride-opencode",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=freeride-opencode",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "PLAN.md",
      "README.md",
      "SKILL.md",
      "SPECIFICATION.md",
      "TASKS.md",
      "examples/usage.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Open the source page and confirm the package flow manually.",
      "Review SKILL.md if you can obtain the files.",
      "Treat this source as manual setup until the download is verified."
    ],
    "agentAssist": {
      "summary": "Use the source page and any available docs to guide the install because the item currently does not return a direct package file.",
      "steps": [
        "Open the source page via Open source listing.",
        "If you can obtain the package, extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the source page and extracted files."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I tried to install a skill package from Yavira, but the item currently does not return a direct package file. Inspect the source page and any extracted docs, then tell me what you can confirm and any manual steps still required. Then review README.md for any prerequisites, environment setup, or post-install checks."
        },
        {
          "label": "Upgrade existing",
          "body": "I tried to upgrade a skill package from Yavira, but the item currently does not return a direct package file. Compare the source page and any extracted docs with my current installation, then summarize what changed and what manual follow-up I still need. Then review README.md for any prerequisites, environment setup, or post-install checks."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "slug": "freeride-opencode",
      "status": "source_issue",
      "reason": "not_found",
      "recommendedAction": "review_source",
      "checkedAt": "2026-05-01T15:20:12.750Z",
      "expiresAt": "2026-05-02T15:20:12.750Z",
      "httpStatus": 404,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=freeride-opencode",
      "contentType": "text/plain",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=freeride-opencode",
        "contentDisposition": null,
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "freeride-opencode"
      },
      "scope": "item",
      "summary": "Known item issue.",
      "detail": "This item's current download entry is known to bounce back to a listing or homepage instead of returning a package file.",
      "primaryActionLabel": "Open source listing",
      "primaryActionHref": "https://clawhub.ai/Heldinhow/freeride-opencode"
    },
    "validation": {
      "installChecklist": [
        "Open the source listing and confirm there is a real package or setup artifact available.",
        "Review SKILL.md before asking your agent to continue.",
        "Treat this source as manual setup until the upstream download flow is fixed."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/freeride-opencode",
    "agentPageUrl": "https://openagent3.xyz/skills/freeride-opencode/agent",
    "manifestUrl": "https://openagent3.xyz/skills/freeride-opencode/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/freeride-opencode/agent.md"
  },
  "agentAssist": {
    "summary": "Use the source page and any available docs to guide the install because the item currently does not return a direct package file.",
    "steps": [
      "Open the source page via Open source listing.",
      "If you can obtain the package, extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the source page and extracted files."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I tried to install a skill package from Yavira, but the item currently does not return a direct package file. Inspect the source page and any extracted docs, then tell me what you can confirm and any manual steps still required. Then review README.md for any prerequisites, environment setup, or post-install checks."
      },
      {
        "label": "Upgrade existing",
        "body": "I tried to upgrade a skill package from Yavira, but the item currently does not return a direct package file. Compare the source page and any extracted docs with my current installation, then summarize what changed and what manual follow-up I still need. Then review README.md for any prerequisites, environment setup, or post-install checks."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Freeride OpenCode",
        "body": "Configure OpenCode Zen free models with intelligent fallbacks to optimize costs while maintaining reliability.\n\n⚠️ Important: To use this skill, you need two API keys:\n\nOpenCode Zen API key - For OpenCode free models (MiniMax M2.1, Kimi K2.5, GLM 4.7, GPT 5 Nano)\nOpenRouter API key - For OpenRouter free models (Trinity Large and other OpenRouter providers)\n\nConfigure both keys in your OpenCode/Zen settings before applying these configurations."
      },
      {
        "title": "Quick Start",
        "body": "Apply optimal free model configuration with provider diversification:\n\n{\n  \"agents\": {\n    \"defaults\": {\n      \"model\": {\n        \"primary\": \"opencode/minimax-m2.1-free\",\n        \"fallbacks\": [\n          \"openrouter/arcee-ai/trinity-large-preview:free\",\n          \"opencode/kimi-k2.5-free\"\n        ]\n      },\n      \"heartbeat\": {\n        \"model\": \"opencode/glm-4.7-free\"\n      },\n      \"subagents\": {\n        \"model\": \"opencode/kimi-k2.5-free\"\n      }\n    }\n  }\n}"
      },
      {
        "title": "🔑 API Keys Required",
        "body": "This skill uses models from two different providers, so you need both API keys configured:"
      },
      {
        "title": "1. OpenCode Zen API Key",
        "body": "Required for:\n\nopencode/minimax-m2.1-free\nopencode/kimi-k2.5-free\nopencode/glm-4.7-free\nopencode/gpt-5-nano\n\nWhere to get: Sign up at OpenCode Zen and generate an API key."
      },
      {
        "title": "2. OpenRouter API Key",
        "body": "Required for:\n\nopenrouter/arcee-ai/trinity-large-preview:free\nAny other OpenRouter free models you add\n\nWhere to get: Sign up at OpenRouter.ai and generate an API key."
      },
      {
        "title": "Configuration",
        "body": "Add both keys to your OpenCode configuration:\n\n{\n  \"providers\": {\n    \"opencode\": {\n      \"api_key\": \"YOUR_OPENCODE_ZEN_API_KEY\"\n    },\n    \"openrouter\": {\n      \"api_key\": \"YOUR_OPENROUTER_API_KEY\"\n    }\n  }\n}"
      },
      {
        "title": "Fallback Behavior by Provider",
        "body": "If OpenCode models fail → tries next OpenCode fallback or OpenRouter model\nIf OpenRouter models fail → tries next OpenRouter or OpenCode fallback\nConfigure both providers for maximum reliability"
      },
      {
        "title": "Model Selection Guide",
        "body": "See models.md for detailed model comparisons, capabilities, and provider information.\n\nTask TypeRecommended ModelRationalePrimary/GeneralMiniMax M2.1 FreeBest free model capabilityFallback 1Trinity Large FreeDifferent provider (OpenRouter) for rate limit resilienceFallback 2Kimi K2.5 FreeGeneral purpose, balanceHeartbeatGLM 4.7 FreeMultilingual, cost-effective for frequent checksSubtasks/SubagentsKimi K2.5 FreeBalanced capability for secondary tasks"
      },
      {
        "title": "Free Models Available",
        "body": "ModelIDBest ForMiniMax M2.1 Freeopencode/minimax-m2.1-freeComplex reasoning, coding (Primary)Trinity Large Freeopenrouter/arcee-ai/trinity-large-preview:freeHigh-quality OpenRouter option (Fallback 1)Kimi K2.5 Freeopencode/kimi-k2.5-freeGeneral purpose, balance (Fallback 2)"
      },
      {
        "title": "Provider Diversification (v1.2.0)",
        "body": "This version implements provider diversification to maximize resilience against rate limits and service disruptions:\n\n\"fallbacks\": [\n  \"openrouter/arcee-ai/trinity-large-preview:free\",  // Different provider (OpenRouter)\n  \"opencode/kimi-k2.5-free\"                           // Same provider as primary (OpenCode)\n]\n\nWhy Provider Diversification Matters:\n\nRate limit isolation: If OpenCode experiences rate limits, OpenRouter models remain available (and vice versa)\nFirst fallback from different provider: Trinity Large on OpenRouter ensures continuity even if all OpenCode models are rate-limited\nMaximum resilience: By spreading across providers, you avoid a single point of failure\n\nFallback triggers:\n\nRate limits exceeded\nAuth failures\nTimeouts\nProvider unavailability"
      },
      {
        "title": "Fallback Behavior by Provider",
        "body": "If OpenCode models fail → tries OpenRouter fallback first (Trinity Large), then back to OpenCode (Kimi)\nIf OpenRouter model fails → tries OpenCode fallback (Kimi)\nThis cross-provider approach ensures at least one model is usually available"
      },
      {
        "title": "Heartbeat (Every 30 min)",
        "body": "\"heartbeat\": {\n  \"every\": \"30m\",\n  \"model\": \"opencode/gpt-5-nano\"\n}\n\nUse the cheapest model for frequent, lightweight checks."
      },
      {
        "title": "Subtasks/Subagents",
        "body": "\"subagents\": {\n  \"model\": \"opencode/kimi-k2.5-free\"\n}\n\nGood balance for secondary tasks that need reasonable capability."
      },
      {
        "title": "Complete Example",
        "body": "{\n  \"agents\": {\n    \"defaults\": {\n      \"model\": {\n        \"primary\": \"opencode/minimax-m2.1-free\",\n        \"fallbacks\": [\n          \"openrouter/arcee-ai/trinity-large-preview:free\",\n          \"opencode/kimi-k2.5-free\"\n        ]\n      },\n      \"models\": {\n        \"opencode/minimax-m2.1-free\": { \"alias\": \"MiniMax M2.1\" },\n        \"opencode/kimi-k2.5-free\": { \"alias\": \"Kimi K2.5\" },\n        \"openrouter/arcee-ai/trinity-large-preview:free\": { \"alias\": \"Trinity Large\" }\n      },\n      \"heartbeat\": {\n        \"every\": \"30m\",\n        \"model\": \"opencode/glm-4.7-free\"\n      },\n      \"subagents\": {\n        \"model\": \"opencode/kimi-k2.5-free\"\n      }\n    }\n  }\n}"
      },
      {
        "title": "Applying Configuration",
        "body": "Use OpenClaw CLI:\n\nopenclaw config.patch --raw '{\n  \"agents\": {\n    \"defaults\": {\n      \"model\": {\n        \"primary\": \"opencode/minimax-m2.1-free\",\n        \"fallbacks\": [\"openrouter/arcee-ai/trinity-large-preview:free\", \"opencode/kimi-k2.5-free\"]\n      },\n      \"heartbeat\": { \"model\": \"opencode/glm-4.7-free\" },\n      \"subagents\": { \"model\": \"opencode/kimi-k2.5-free\" }\n    }\n  }\n}'"
      },
      {
        "title": "Best Practices",
        "body": "Provider diversification - Always have your first fallback from a different provider (e.g., OpenRouter) to avoid rate limits affecting all models\nKeep fallbacks minimal - 2-3 well-chosen fallbacks are better than many\nMatch model to task - Don't use MiniMax for simple checks\nTest fallback order - Put more capable models first, with provider diversification\nMonitor usage - Track which models get used most"
      },
      {
        "title": "Troubleshooting",
        "body": "Authentication errors (401/403)?\n\nCheck that you have both API keys configured:\n\nOpenCode Zen API key for OpenCode models\nOpenRouter API key for Trinity Large and OpenRouter models\n\n\nVerify keys are valid and have not expired\n\nRate limits still occurring?\n\nAdd provider diversification (ensure first fallback is from different provider)\nConsider reducing heartbeat frequency\n\nResponses too slow?\n\nMove GPT 5 Nano higher in fallback chain\nUse simpler model for subtasks\n\nModel not available?\n\nCheck model ID format: opencode/model-id-free or openrouter/provider/model:free\nVerify model is still free (check models.md)\nEnsure you have the correct API key for the provider\n\nOpenRouter models not working?\n\nVerify OpenRouter API key is configured\nCheck OpenRouter account has credits/access\nSome models may have additional access requirements"
      },
      {
        "title": "models.md",
        "body": "Complete reference of all free models with capabilities, providers, performance comparisons, and error handling."
      },
      {
        "title": "templates.md",
        "body": "Ready-to-use configuration templates for different use cases (minimal, complete, cost-optimized, performance-optimized)."
      },
      {
        "title": "examples/usage.md",
        "body": "Practical examples showing how to use this skill in real scenarios."
      }
    ],
    "body": "Freeride OpenCode\n\nConfigure OpenCode Zen free models with intelligent fallbacks to optimize costs while maintaining reliability.\n\n⚠️ Important: To use this skill, you need two API keys:\n\nOpenCode Zen API key - For OpenCode free models (MiniMax M2.1, Kimi K2.5, GLM 4.7, GPT 5 Nano)\nOpenRouter API key - For OpenRouter free models (Trinity Large and other OpenRouter providers)\n\nConfigure both keys in your OpenCode/Zen settings before applying these configurations.\n\nQuick Start\n\nApply optimal free model configuration with provider diversification:\n\n{\n  \"agents\": {\n    \"defaults\": {\n      \"model\": {\n        \"primary\": \"opencode/minimax-m2.1-free\",\n        \"fallbacks\": [\n          \"openrouter/arcee-ai/trinity-large-preview:free\",\n          \"opencode/kimi-k2.5-free\"\n        ]\n      },\n      \"heartbeat\": {\n        \"model\": \"opencode/glm-4.7-free\"\n      },\n      \"subagents\": {\n        \"model\": \"opencode/kimi-k2.5-free\"\n      }\n    }\n  }\n}\n\n🔑 API Keys Required\n\nThis skill uses models from two different providers, so you need both API keys configured:\n\n1. OpenCode Zen API Key\n\nRequired for:\n\nopencode/minimax-m2.1-free\nopencode/kimi-k2.5-free\nopencode/glm-4.7-free\nopencode/gpt-5-nano\n\nWhere to get: Sign up at OpenCode Zen and generate an API key.\n\n2. OpenRouter API Key\n\nRequired for:\n\nopenrouter/arcee-ai/trinity-large-preview:free\nAny other OpenRouter free models you add\n\nWhere to get: Sign up at OpenRouter.ai and generate an API key.\n\nConfiguration\n\nAdd both keys to your OpenCode configuration:\n\n{\n  \"providers\": {\n    \"opencode\": {\n      \"api_key\": \"YOUR_OPENCODE_ZEN_API_KEY\"\n    },\n    \"openrouter\": {\n      \"api_key\": \"YOUR_OPENROUTER_API_KEY\"\n    }\n  }\n}\n\nFallback Behavior by Provider\nIf OpenCode models fail → tries next OpenCode fallback or OpenRouter model\nIf OpenRouter models fail → tries next OpenRouter or OpenCode fallback\nConfigure both providers for maximum reliability\nModel Selection Guide\n\nSee models.md for detailed model comparisons, capabilities, and provider information.\n\nTask Type\tRecommended Model\tRationale\nPrimary/General\tMiniMax M2.1 Free\tBest free model capability\nFallback 1\tTrinity Large Free\tDifferent provider (OpenRouter) for rate limit resilience\nFallback 2\tKimi K2.5 Free\tGeneral purpose, balance\nHeartbeat\tGLM 4.7 Free\tMultilingual, cost-effective for frequent checks\nSubtasks/Subagents\tKimi K2.5 Free\tBalanced capability for secondary tasks\nFree Models Available\nModel\tID\tBest For\nMiniMax M2.1 Free\topencode/minimax-m2.1-free\tComplex reasoning, coding (Primary)\nTrinity Large Free\topenrouter/arcee-ai/trinity-large-preview:free\tHigh-quality OpenRouter option (Fallback 1)\nKimi K2.5 Free\topencode/kimi-k2.5-free\tGeneral purpose, balance (Fallback 2)\nFallback Strategy\nProvider Diversification (v1.2.0)\n\nThis version implements provider diversification to maximize resilience against rate limits and service disruptions:\n\n\"fallbacks\": [\n  \"openrouter/arcee-ai/trinity-large-preview:free\",  // Different provider (OpenRouter)\n  \"opencode/kimi-k2.5-free\"                           // Same provider as primary (OpenCode)\n]\n\n\nWhy Provider Diversification Matters:\n\nRate limit isolation: If OpenCode experiences rate limits, OpenRouter models remain available (and vice versa)\nFirst fallback from different provider: Trinity Large on OpenRouter ensures continuity even if all OpenCode models are rate-limited\nMaximum resilience: By spreading across providers, you avoid a single point of failure\n\nFallback triggers:\n\nRate limits exceeded\nAuth failures\nTimeouts\nProvider unavailability\nFallback Behavior by Provider\nIf OpenCode models fail → tries OpenRouter fallback first (Trinity Large), then back to OpenCode (Kimi)\nIf OpenRouter model fails → tries OpenCode fallback (Kimi)\nThis cross-provider approach ensures at least one model is usually available\nPer-Task Configuration\nHeartbeat (Every 30 min)\n\"heartbeat\": {\n  \"every\": \"30m\",\n  \"model\": \"opencode/gpt-5-nano\"\n}\n\n\nUse the cheapest model for frequent, lightweight checks.\n\nSubtasks/Subagents\n\"subagents\": {\n  \"model\": \"opencode/kimi-k2.5-free\"\n}\n\n\nGood balance for secondary tasks that need reasonable capability.\n\nComplete Example\n{\n  \"agents\": {\n    \"defaults\": {\n      \"model\": {\n        \"primary\": \"opencode/minimax-m2.1-free\",\n        \"fallbacks\": [\n          \"openrouter/arcee-ai/trinity-large-preview:free\",\n          \"opencode/kimi-k2.5-free\"\n        ]\n      },\n      \"models\": {\n        \"opencode/minimax-m2.1-free\": { \"alias\": \"MiniMax M2.1\" },\n        \"opencode/kimi-k2.5-free\": { \"alias\": \"Kimi K2.5\" },\n        \"openrouter/arcee-ai/trinity-large-preview:free\": { \"alias\": \"Trinity Large\" }\n      },\n      \"heartbeat\": {\n        \"every\": \"30m\",\n        \"model\": \"opencode/glm-4.7-free\"\n      },\n      \"subagents\": {\n        \"model\": \"opencode/kimi-k2.5-free\"\n      }\n    }\n  }\n}\n\nApplying Configuration\n\nUse OpenClaw CLI:\n\nopenclaw config.patch --raw '{\n  \"agents\": {\n    \"defaults\": {\n      \"model\": {\n        \"primary\": \"opencode/minimax-m2.1-free\",\n        \"fallbacks\": [\"openrouter/arcee-ai/trinity-large-preview:free\", \"opencode/kimi-k2.5-free\"]\n      },\n      \"heartbeat\": { \"model\": \"opencode/glm-4.7-free\" },\n      \"subagents\": { \"model\": \"opencode/kimi-k2.5-free\" }\n    }\n  }\n}'\n\nBest Practices\nProvider diversification - Always have your first fallback from a different provider (e.g., OpenRouter) to avoid rate limits affecting all models\nKeep fallbacks minimal - 2-3 well-chosen fallbacks are better than many\nMatch model to task - Don't use MiniMax for simple checks\nTest fallback order - Put more capable models first, with provider diversification\nMonitor usage - Track which models get used most\nTroubleshooting\n\nAuthentication errors (401/403)?\n\nCheck that you have both API keys configured:\nOpenCode Zen API key for OpenCode models\nOpenRouter API key for Trinity Large and OpenRouter models\nVerify keys are valid and have not expired\n\nRate limits still occurring?\n\nAdd provider diversification (ensure first fallback is from different provider)\nConsider reducing heartbeat frequency\n\nResponses too slow?\n\nMove GPT 5 Nano higher in fallback chain\nUse simpler model for subtasks\n\nModel not available?\n\nCheck model ID format: opencode/model-id-free or openrouter/provider/model:free\nVerify model is still free (check models.md)\nEnsure you have the correct API key for the provider\n\nOpenRouter models not working?\n\nVerify OpenRouter API key is configured\nCheck OpenRouter account has credits/access\nSome models may have additional access requirements\nReferences\nmodels.md\n\nComplete reference of all free models with capabilities, providers, performance comparisons, and error handling.\n\ntemplates.md\n\nReady-to-use configuration templates for different use cases (minimal, complete, cost-optimized, performance-optimized).\n\nexamples/usage.md\n\nPractical examples showing how to use this skill in real scenarios."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/Heldinhow/freeride-opencode",
    "publisherUrl": "https://clawhub.ai/Heldinhow/freeride-opencode",
    "owner": "Heldinhow",
    "version": "1.2.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/freeride-opencode",
    "downloadUrl": "https://openagent3.xyz/downloads/freeride-opencode",
    "agentUrl": "https://openagent3.xyz/skills/freeride-opencode/agent",
    "manifestUrl": "https://openagent3.xyz/skills/freeride-opencode/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/freeride-opencode/agent.md"
  }
}