Menu
管理 OpenRouter 的免费 AI 模型为 OpenClaw 提供服务。自动按质量排名模型、配置限流故障切换、更新 openclaw.json 配置。当用户提到免费 AI、OpenRouter、模型切换、限流或想降低 AI 成本时使用此技能。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
中国公文格式化。按照党政机关公文格式标准，规范正文字体、标题层级、页面设置、落款、附件等格式要素。
使用 summarize CLI 对 URL 或文件进行摘要（网页、PDF、图片、音频、YouTube）的中文版本
AI 智能体的自进化引擎。分析运行时历史以识别改进点，并应用协议约束的进化机制。
通过 yt-dlp 提取 YouTube 视频字幕，支持视频摘要、问答和内容提取，仅适用于有字幕的视频
OpenClaw 原生安全插件——通过 MoltGuard API 检测工具结果与消息中的提示注入，可选本地净化网关在发送前脱敏 PII（银行卡/密码等），首次使用自动注册 API 密钥
从 10,000+ Nano Banana Pro 图像生成提示词中推荐合适的提示词，基于用户需求进行推荐。 针对 Nano Banana Pro (Gemini) 优化，但提示词同样适用于 Nano Banana 2、Seedream 5.0、 GPT Image 1.5、Midjourney、DALL-E、Flux、Stable Diffusion 以及任何文本到图像AI模型。 当用户想要以下内容时使用此技能： - 使用AI生成图像（任何模型 — Nano Banana Pro、Gemini、GPT Image、Seedream 等） - 找到经过验证的AI图像生成提示词和提示词模板 - 获取特定用例的提示词建议（肖像、产品、社交媒体、海报等） - 为文章、视频、播客或营销内容创建插图 - 浏览带有示例图像的精选提示词库 - 翻译和理解提示词技术 还提供："ai-image-prompts" 技能 — 此库的模型无关版本，适用于通用图像生成。
| name | freeride-zh |
| description | 管理 OpenRouter 的免费 AI 模型为 OpenClaw 提供服务。自动按质量排名模型、配置限流故障切换、更新 openclaw.json 配置。当用户提到免费 AI、OpenRouter、模型切换、限流或想降低 AI 成本时使用此技能。 |
配置 OpenClaw 使用 OpenRouter 的免费 AI 模型。将最佳免费模型设置为主模型，添加排名靠前的备用模型以便在限流时不中断用户，同时保留现有配置。
在运行任何 FreeRide 命令之前，请确保：
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-..."
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:freeagents.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 |