Unlimited free AI - 零成本AI智能调度，自动防限流

free-ride

OpenRouter免费模型智能管理工具，自动配置降级链防限流，零成本使用优质AI

1.0.11版本 A安全等级 自动化 / Agent支持工具

01 场景说明

什么时候用这个 Skill？

功能概述

FreeRide 是专为 OpenClaw 设计的 OpenRouter 免费 AI 模型管理工具。它自动从 OpenRouter 平台筛选优质免费模型，智能配置主模型与多级降级链，确保用户在遭遇速率限制时无缝切换，实现零成本稳定使用 AI 服务。

核心用法

使用 freeride auto 一键完成最佳免费模型配置，系统自动：

抓取 OpenRouter 实时免费模型列表并按质量排序
设置最优模型为主力（如 qwen3-coder:free）
构建 5 级智能降级链，首位固定为 OpenRouter 智能路由 openrouter/free
更新 OpenClaw 配置并重启网关生效

其他关键命令：

freeride list 查看可用免费模型
freeride switch <model> 手动切换指定模型
freeride rotate 限流死锁时现场测试并重建链
freeride-watcher 后台守护进程，60秒自动探活恢复

显著优点

零成本高质量 AI：接入 OpenRouter 官方免费模型池，覆盖 Qwen、Llama、DeepSeek 等主流开源模型
抗限流设计：多级 fallback + 智能路由，单点限流自动无缝切换，几乎无感知中断
配置安全：仅修改 agents.defaults.model 相关键，完整保留网关、插件、自定义指令等现有配置
多 Key 轮换：内置支持 JSON 数组格式多 API Key，自动轮询分散限流风险
无人值守恢复：可选后台 watcher 进程，自主检测死锁并重建可用链

潜在局限

模型能力边界：免费模型相比付费版本（Pro/Enterprise）存在上下文长度、推理深度、知识时效等差距
速率限制本质：免费层级存在硬性 RPM/TPM 上限，高并发场景仍可能整体受限
可用性波动：免费模型池动态变化，优质模型可能突然下架或调整策略
T3 来源依赖：个人开发者维护，长期更新稳定性需社区验证

适用人群

个人开发者/研究者：降低实验成本，快速验证 AI 工作流
轻量级应用场景：代码补全、文案生成、简单问答等非关键业务
OpenClaw 现有用户：希望无缝迁移至免费模型栈，保留原有生态配置

常规风险与建议

风险场景	缓解措施
全链限流死锁	启用 `freeride-watcher` 后台守护，或配置多 API Key 分散风险
模型突然下架	定期运行 `freeride refresh` 同步最新可用列表
API Key 泄露	通过环境变量或 `openclaw config set` 配置，避免硬编码；利用内置掩码保护
配置冲突	首次使用后执行 `/status` 验证，确认主模型格式为 `openrouter/<provider>/<model>:free`

场景分类：agent openrouterfree-aimodel-managementrate-limitcost-optimizationfallback-chainopenclawpython

02 使用方式

简单 3 步，立即在 AI 工具中使用

1

获取 Skill 文件

通过国内网盘直链下载解压包，或使用上方安装指令。
去下载资源
2

导入你的 AI 工具

在 Cursor / QoderWork / TRAE / Claude 等工具的 Skills 入口导入。
复制安装指令
3

用普通话描述任务

直接说出你的需求，AI 会自动按此 Skill 预设流程落地结果。

快捷方式

复制给 Agent 自动安装

选择你在用的工具，复制下方指令粘贴给 AI，AI 会先说明用途和权限，自动完成安装。

复制给 AI 的指令详细版

Unlimited free AI - 零成本AI智能调度，自动防限流复制给 AI 自动安装

03 风险与前置

使用前注意事项与安全等级

安全等级 A：已整理并检查，正常使用无明显风险。 ## 功能概述 FreeRide 是专为 OpenClaw 设计的 OpenRouter 免费 AI 模型管理工具。它自动从 OpenRouter 平台筛选优质免费模型，智能配置主模型与多级降级链，确保用户在遭遇速率限制时无缝切换，实现零成本稳定使用 AI 服务。 ## 核心用法使用 `freeride auto` 一键完成最佳免费模型配置，系统自动： - 抓取 OpenRouter 实时免费模型列表并按质量排序 - 设置最优模型为主力（如 `qwen3-coder:free`） - 构建 5 级智能降级链，首位固定为 OpenRouter 智能路由 `openrouter/free` - 更新 OpenClaw 配置并重启网关生效其他关键命令： - `freeride list` 查看可用免费模型 - `freeride switch <model>` 手动切换指定模型 - `freeride rotate` 限流死锁时现场测试并重建链 - `freeride-watcher` 后台守护进程，60秒自动探活恢复 ## 显著优点 1. **零成本高质量 AI**：接入 OpenRouter 官方免费模型池，覆盖 Qwen、Llama、DeepSeek 等主流开源模型 2. **抗限流设计**：多级 fallback + 智能路由，单点限流自动无缝切换，几乎无感知中断 3. **配置安全**：仅修改 `agents.defaults.model` 相关键，完整保留网关、插件、自定义指令等现有配置 4. **多 Key 轮换**：内置支持 JSON 数组格式多 API Key，自动轮询分散限流风险 5. **无人值守恢复**：可选后台 watcher 进程，自主检测死锁并重建可用链 ## 潜在局限 - **模型能力边界**：免费模型相比付费版本（Pro/Enterprise）存在上下文长度、推理深度、知识时效等差距 - **速率限制本质**：免费层级存在硬性 RPM/TPM 上限，高并发场景仍可能整体受限 - **可用性波动**：免费模型池动态变化，优质模型可能突然下架或调整策略 - **T3 来源依赖**：个人开发者维护，长期更新稳定性需社区验证 ## 适用人群 - 个人开发者/研究者：降低实验成本，快速验证 AI 工作流 - 轻量级应用场景：代码补全、文案生成、简单问答等非关键业务 - OpenClaw 现有用户：希望无缝迁移至免费模型栈，保留原有生态配置 ## 常规风险与建议 | 风险场景 | 缓解措施 | |---------|---------| | 全链限流死锁 | 启用 `freeride-watcher` 后台守护，或配置多 API Key 分散风险 | | 模型突然下架 | 定期运行 `freeride refresh` 同步最新可用列表 | | API Key 泄露 | 通过环境变量或 `openclaw config set` 配置，避免硬编码；利用内置掩码保护 | | 配置冲突 | 首次使用后执行 `/status` 验证，确认主模型格式为 `openrouter/<provider>/<model>:free` |

report_id: CLS-2026-0507-FREERIDE
report_date: "2026-05-07T03:24:28Z"
scanner_version: CLS-Certify v2.1.0
scan_mode: Full Scan
skill_name: freeride
skill_version: 1.0.11
skill_path: /tmp/bss_skill_tq3ig2m4
maintainer: Shaishav Pidadi
license: MIT
scan_duration: 45.2s
code_stats: 1658 lines · 8 files · Python
trust_level: T3
trust_level_text: 个人开发者/社区项目
grade: A
score: 78
evaluation: 标准安全级别，功能与声明一致，可放心使用
stamp_color: green
total_风险发现: 3
sample_hash: sha256:c9612bb4e68a88bffded601f59ae14ec09f3bc155ef22b2c54ecdcef6c1b6611
disclaimer: 本认证结果不代表对 Skill 功能正确性的保证，仅反映安全风险评估。建议结合自身安全策略使用。
radar:

name: 静态代码分析
short: STATIC
score: 85
status: pass
detail: 未发现危险函数或恶意代码模式，代码结构清晰
name: 动态行为分析
short: DYNAMIC
score: 80
status: pass
detail: 运行时行为与声明功能一致，无异常系统调用
name: 依赖审计
short: DEPS
score: 90
status: pass
detail: 仅依赖 requests>=2.31.0，无已知 CVE 漏洞
name: 网络流量分析
short: NETWORK
score: 75
status: pass
detail: 仅访问 openrouter.ai 官方 API，使用 HTTPS 加密
name: 隐私合规检查
short: PRIVACY
score: 80
status: pass
detail: API Key 处理规范，敏感数据有掩码保护
name: 威胁情报
short: THREAT
score: 70
status: warn
detail: T3 来源（个人开发者），建议关注后续更新

compliance:

text: GDPR 数据最小化原则
status: pass
text: 用户同意机制
status: pass
text: 敏感数据保护
status: pass
text: 第三方数据共享限制
status: pass
text: 数据可携带性
status: pass
text: 代码透明性
status: pass

风险模式

info: 功能型 Skill - OpenRouter 免费模型管理
low: 文件系统写入受限 (~/.openclaw/ 目录)
low: 网络访问受限 (openrouter.ai)
info: 依赖单一且可信 (requests)
warn: T3 来源 - 个人开发者项目

分析摘要

功能与行为一致性良好: FreeRide Skill 实现与声明功能完全一致，用于管理 OpenRouter 免费 AI 模型，自动配置 OpenClaw 的模型切换和降级链，无隐藏功能或后门代码。
代码安全质量高: 经过静态代码分析，未发现危险函数（eval/exec/system/subprocess 等）、SQL 注入、路径遍历或命令注入等常见安全漏洞。代码结构清晰，遵循 Python 最佳实践。
网络访问规范: 所有网络请求均指向 OpenRouter 官方 API (openrouter.ai)，使用 HTTPS 加密传输，包含适当的请求头身份标识，无数据外泄风险。
敏感信息处理得当: API Key 从环境变量安全读取，存储时无硬编码密钥，输出时进行掩码处理（仅显示前8位和后4位），符合安全最佳实践。
来源可信度 T3: 该 Skill 由个人开发者（Shaishav Pidadi）维护，非知名组织或企业项目。虽代码质量良好，但建议用户关注后续更新和社区反馈。

外部接口

Endpoint	Method	Reputation	Encryption	Data Types	Provider
https://openrouter.ai/api/v1/models	GET	Official	TLS 1.2+	Model metadata	OpenRouter
https://openrouter.ai/api/v1/chat/completions	POST	Official	TLS 1.2+	Chat messages	OpenRouter

风险发现

RISK-001

severity: low
category: file_write
title: 配置文件写入操作
location: main.py:309-312, main.py:274-279
description: Skill 需要写入 ~/.openclaw/openclaw.json 和 ~/.openclaw/.freeride-cache.json 以保存配置和缓存。这是功能必需操作，但属于敏感系统配置文件。代码使用 pathlib 进行安全文件操作，包含目录创建和原子写入（watcher.py:38-43）。
recommendation: 写入操作仅限于 ~/.openclaw/ 目录，未访问其他系统路径。建议用户确认该路径的访问符合预期。

RISK-002

severity: low
category: env_access
title: 环境变量读取
location: main.py:98-117
description: Skill 读取 OPENROUTER_API_KEY 环境变量以进行 API 认证。代码支持单密钥和 JSON 数组格式的多密钥配置。API Key 仅用于向 OpenRouter 发起请求，未发送至其他第三方。
recommendation: API Key 处理规范，有掩码显示保护（main.py:678-684）。建议用户通过环境变量或 OpenClaw 配置安全设置密钥，避免硬编码。

RISK-003

severity: info
category: source_trust
title: T3 来源可信度
location: N/A
description: 该 Skill 由个人开发者 Shaishav Pidadi 维护（GitHub: Shaivpidadi），属于 T3 级别来源（个人开发者/社区项目）。非知名公司或顶级开源基金会背书。代码开源透明，但更新和维护依赖个人开发者。
recommendation: 建议关注 GitHub 仓库的更新动态和社区反馈。对于生产环境使用，建议进行额外代码审查或等待更多社区验证。

改进建议

1. 保持依赖更新

定期更新 requests 库以获取安全补丁。当前依赖 requests>=2.31.0 已包含最新安全修复，建议关注该库的 CVE 公告。

2. API Key 轮换机制

Skill 已内置多 API Key 支持和自动轮换功能（main.py:52-64）。建议用户配置多个 OpenRouter API Key 以提高可用性和分散速率限制风险。

3. 监控配置变更

由于 Skill 会修改 ~/.openclaw/openclaw.json，建议用户在首次使用后验证配置文件的变更是否符合预期，特别是 agents.defaults.model 相关配置。

4. 关注来源更新

作为 T3 来源项目，建议订阅 GitHub 仓库的 Release 通知，及时获取安全更新和功能改进。

04 会员优势

国内网盘直下载与运维维护

国内网盘直下载

百度/夸克直链转存，无需翻墙或挂代理。

国内镜像与版本固定

固定有效版本，经过实测排查，避免代码变动导致失效。

失效自动补链

专人维护网盘地址，发现链接失效 24h 内完成补链。

更新提醒与省心省时

随时获取最新修复说明，帮非技术用户节省大把调优时间。

源码与文件预览（7 个文件）

/main.py

正在加载代码…