FreeRide - 为OpenClaw配置免费AI模型，自动切换备用模型避免中断

freeride by shaivpidadi/freeride

410 周安装量

74 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/shaivpidadi/freeride --skill freeride

AI/机器学习开发自动化

🇨🇳中文介绍

FreeRide - OpenClaw 的免费 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/workspace/skills/free-ride
pip install -e .
```

主要工作流程

当用户需要使用免费 AI 时，按顺序运行以下步骤：

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

FlyClaw：零登录航班聚合查询工具，Python实现多源航班信息与价格搜索

4,000,000 周安装

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

762,600 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

258,600 周安装

Vercel Web界面规范检查工具 - 自动检测代码是否符合Web设计指南

208,300 周安装

# 步骤 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/workspace/skills/free-ride && pip install -e .`
`OPENROUTER_API_KEY not set`	用户需要从 https://openrouter.ai/keys 获取密钥
更改未生效	`openclaw gateway restart` 然后 `/new` 以开始新会话
代理显示 0 个令牌	检查 `freeride status` — 主模型应为 `openrouter/<provider>/<model>:free`

🇺🇸English

FreeRide - Free AI for OpenClaw

What This Skill Does

Configures OpenClaw to use free AI models from OpenRouter. Sets the best free model as primary, adds ranked fallbacks so rate limits don't interrupt the user, and preserves existing config.

Prerequisites

Before running any FreeRide command, ensure:

OPENROUTER_API_KEY is set. Check with echo $OPENROUTER_API_KEY. If empty, the user must get a free key at https://openrouter.ai/keys and set it:
```
export OPENROUTER_API_KEY="sk-or-v1-..."
# Or persist it:
openclaw config set env.OPENROUTER_API_KEY "sk-or-v1-..."
```
Thefreeride CLI is installed. Check with which freeride. If not found:
```
cd ~/.openclaw/workspace/skills/free-ride
pip install -e .
```

Primary Workflow

When the user wants free AI, run these steps in order:

# Step 1: Configure best free model + fallbacks
freeride auto

# Step 2: Restart gateway so OpenClaw picks up the changes
openclaw gateway restart

That's it. The user now has free AI with automatic fallback switching.

Verify by telling the user to send /status to check the active model.

Commands Reference

Command	When to use it
`freeride auto`	User wants free AI set up (most common)
`freeride auto -f`	User wants fallbacks but wants to keep their current primary model
`freeride auto -c 10`	User wants more fallbacks (default is 5)
`freeride list`	User wants to see available free models
`freeride list -n 30`	User wants to see all free models
`freeride switch <model>`

After any command that changes config, always runopenclaw gateway restart.

What It Writes to Config

FreeRide updates only these keys in ~/.openclaw/openclaw.json:

agents.defaults.model.primary — e.g. openrouter/qwen/qwen3-coder:free
agents.defaults.model.fallbacks — e.g. ["openrouter/free", "nvidia/nemotron:free", ...]
agents.defaults.models — allowlist so /model command shows the free models

Everything else (gateway, channels, plugins, env, customInstructions, named agents) is preserved.

The first fallback is always openrouter/free — OpenRouter's smart router that auto-picks the best available model based on the request.

Watcher (Optional)

For auto-rotation when rate limited, the user can run:

freeride-watcher --daemon    # Continuous monitoring
freeride-watcher --rotate    # Force rotate now
freeride-watcher --status    # Check rotation history

Troubleshooting

Problem	Fix
`freeride: command not found`	`cd ~/.openclaw/workspace/skills/free-ride && pip install -e .`
`OPENROUTER_API_KEY not set`	User needs a key from https://openrouter.ai/keys
Changes not taking effect	`openclaw gateway restart` then `/new` for fresh session
Agent shows 0 tokens	Check `freeride status` — primary should be `openrouter/<provider>/<model>:free`

Weekly Installs

410

Repository

shaivpidadi/freeride

GitHub Stars

First Seen

Feb 26, 2026

Security Audits

Gen Agent Trust HubPass SocketFail SnykWarn

Installed on

codex406

opencode406

kimi-cli405

gemini-cli405

amp405

github-copilot405

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

138,300 周安装