freeride-zh

freeride-zh is a skill for Claude Code, Codex from L-LesterYu/OpenClaw-hot-skills-zh. It costs 70 tokens per session (1,039 once invoked), scanned A, original, MIT.

A tool for configuring OpenClaw, an AI service, to use free models available through OpenRouter. It ranks models, sets backup choices, and updates OpenClaw's configuration.

In plain words
What is it for?
Use it to list free models, choose a main model, add fallback models, switch models, inspect the setup, or refresh the cached model list.
Why use it?
It helps keep OpenClaw running when a model is rate-limited, while supporting a setup based on free models and lower usage costs.

Skill for Claude CodeCodex

Which agent this was written for is unclear — built for openclaw. Also seen: built for openclaw.

Good fit Use it to list free models, choose a main model, add fallback models, switch models, inspect the setup, or refresh the cached model list.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/l-lesteryu/openclaw-hot-skills-zh/freeride-zh
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add L-LesterYu/OpenClaw-hot-skills-zh --skill freeride-zh
Clone the repo
git clone --depth 1 https://github.com/L-LesterYu/OpenClaw-hot-skills-zh

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for freeride-zh

README.md
[![agentmods](https://agentmods.dev/badge/skills/l-lesteryu/openclaw-hot-skills-zh/freeride-zh/github.svg)](https://agentmods.dev/skills/l-lesteryu/openclaw-hot-skills-zh/freeride-zh)
Your own site
<a href="https://agentmods.dev/skills/l-lesteryu/openclaw-hot-skills-zh/freeride-zh"><img src="https://agentmods.dev/badge/skills/l-lesteryu/openclaw-hot-skills-zh/freeride-zh/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for freeride-zh

Your own site · 80×15
<a href="https://agentmods.dev/skills/l-lesteryu/openclaw-hot-skills-zh/freeride-zh"><img src="https://agentmods.dev/badge/skills/l-lesteryu/openclaw-hot-skills-zh/freeride-zh.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 70 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,039 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00070 $0.01039
Opus 5 $0.00035 $0.00519
Sonnet 5 $0.00014 $0.00208
Haiku 4.5 $0.00007 $0.00104

Measured 13d ago against content hash 444e2bc29c2b, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

freeride-zh scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 13d ago.

The scan reads SKILL.md. This mod also ships 3 executable files (main.py, setup.py, watcher.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/freeride-zh/SKILL.md · 92 lines

How it starts

The opening of the file, as written. The whole thing — 92 lines — stays where its author put it; the contents beside it link to each section on GitHub.

FreeRide - OpenClaw 免费AI

这个技能的作用

配置 OpenClaw 使用 OpenRouter 的免费 AI 模型。将最佳免费模型设置为主模型,添加排名靠前的备用模型以便在限流时不中断用户,同时保留现有配置。

前置条件

在运行任何 FreeRide 命令之前,请确保:

  1. OPENROUTER_API_KEY 已设置。 使用 echo $OPENROUTER_API_KEY 检查。如果为空,用户需要在 https://openrouter.ai/keys 获取免费密钥并设置:

    export OPENROUTER_API_KEY="sk-or-v1-..."
    # 或者持久化保存:
    openclaw config set env.OPENROUTER_API_KEY "sk-or-v1-..."
    
  2. freeride CLI 已安装。 使用 which freeride 检查。如果未找到:

    cd ~/.openclaw/skills/freeride-zh
    pip install -e .
    

主要工作流程

当用户想要免费 AI 时,按顺序执行以下步骤:

# 步骤 1:配置最佳免费模型 + 备用模型
freeride auto

# 步骤 2:重启网关以便 OpenClaw 应用更改
openclaw gateway restart

就这么简单。用户现在拥有了带自动故障切换的免费 AI。

通过告诉用户发送 /status 来验证当前使用的模型。

命令参考

命令 使用场景
freeride auto 用户想要设置免费 AI(最常用)
freeride auto -f 用户想要添加备用模型但保留当前主模型
freeride auto -c 10 用户想要更多备用模型(默认是 5 个)
freeride list 用户想要查看可用的免费模型
freeride list -n 30 用户想要查看所有免费模型
freeride switch <model> 用户想要指定特定模型(如 freeride switch qwen3-coder
freeride switch <model> -f 仅将特定模型添加为备用
freeride status 检查当前 FreeRide 配置
freeride fallbacks 仅更新备用模型
freeride refresh 强制刷新缓存的模型列表

任何更改配置的命令后,都要运行 openclaw gateway restart

它写入配置的内容

FreeRide 只更新 ~/.openclaw/openclaw.json 中的这些键:

  • agents.defaults.model.primary — 例如 openrouter/qwen/qwen3-coder:free
  • agents.defaults.model.fallbacks — 例如 ["openrouter/free", "nvidia/nemotron:free", ...]
  • agents.defaults.models — 白名单,使 /model 命令显示免费模型

其他所有内容(网关、通道、插件、环境变量、自定义指令、命名代理)都会保留。

第一个备用模型始终是 openrouter/free — OpenRouter 的智能路由器,根据请求自动选择最佳可用模型。

监控器(可选)

对于限流时的自动轮换,用户可以运行:

freeride-watcher --daemon    # 持续监控
freeride-watcher --rotate    # 立即强制轮换
freeride-watcher --status    # 检查轮换历史

故障排除

问题 解决方案
freeride: command not found cd ~/.openclaw/skills/freeride-zh && pip install -e .
OPENROUTER_API_KEY not set 用户需要从 https://openrouter.ai/keys 获取密钥
更改未生效 openclaw gateway restart 然后使用 /new 开启新会话
代理显示 0 tokens 检查 freeride status — 主模型应该是 openrouter/<provider>/<model>:free

Read the full file on GitHub · 92 lines

Files

What ships with it

6 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 13d ago First seen · 92 lines · 70 tokens per session scan A 444e2bc29c2b

Subscribe to this mod's changes

freeride-zh is a skill published in the GitHub repository L-LesterYu/OpenClaw-hot-skills-zh (54 stars, last pushed 5mo ago), licensed MIT. It adds 70 tokens to every session and 1,039 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

agent-platform-rag-engine-management

Manage and query Agent Platform RAG Engine Corpora and retrieve grounded contexts using the Google GenAI SDK. Use when listing RAG corpora or files, inspecting a corpus, retrieving contexts, or generating content grounded in a RAG corpus. Do not use for standard database queries (use SQL/Spanner skills), Google…

google/skills · 85 tokens

agent-platform-model-registry

Agent Platform Model Registry Management. Use when you need to upload, list, describe, update, or delete machine learning models (and their versions) in the Agent Platform Model Registry. Don't use for model training, model deployment to endpoints, or managing non-Agent Platform models.

google/skills · 60 tokens

foundry-config-setup

Resolve missing setup caused by a hardcoded Foundry project endpoint or model in a sample. Use when a sample fails because it uses a placeholder/hardcoded projectendpoint (for example "https://your-project.services.ai.azure.com") or a hardcoded model instead of reading them from the environment.

microsoft/agent-framework · 65 tokens

google-cloud-solution-agentic-analytics-spark-knowledge-catalog

Discovers requirements and generates guidance to design and deploy a governed, secure agentic-analytics solution for data that's distributed across Google Cloud, other cloud providers, or on-premises. Data that's outside Google Cloud (such as data from Databricks, Snowflake, Salesforce, SAP, or Oracle systems) is…

google/skills · 138 tokens

training-check

Interactively monitor training metrics from the current Codex session, periodically checking WandB or fallback logs for NaN, divergence, plateaus, and broken runs.

wanshuiyin/Auto-claude-code-research-in-sleep · 35 tokens

nemo-automodel-launcher-config

Configure NeMo AutoModel job launches for interactive runs, Slurm clusters, and SkyPilot cloud execution.

NVIDIA/skills · 30 tokens