🎢 FreeRide

停止为AI付费。开始免费畅游。

---

FreeRide 通过自动管理 OpenRouter 的免费模型，在 OpenClaw 中为您提供无限的免费 AI。

You: *hits rate limit* FreeRide: "I got you." *switches to next best model* You: *keeps coding*

问题

您正在使用 OpenClaw。您很喜欢它。但是：

• 💸 API 成本快速累积
• 🚫 免费模型有速率限制
• 😤 手动切换模型很烦人
• 🤷 您不知道哪个免费模型实际上很好

解决方案

一个命令。免费 AI。永久免费。

freeride auto

就是这样。FreeRide：

1. 查找 OpenRouter 上的 30+ 个免费模型
2. 按质量 对它们进行排名（上下文长度、功能、速度）
3. 设置 最好的模型作为您的主要模型
4. 配置 智能备用模型，当您达到速率限制时使用
5. 保留 您现有的 OpenClaw 配置

安装

npx clawhub@latest install freeride
cd ~/.openclaw/workspace/skills/free-ride
pip install -e .

就是这样。freeride 和 freeride-watcher 现在可以作为全局命令使用。

快速开始

1. 获取免费的 OpenRouter 密钥

前往 openrouter.ai/keys → 创建账户 → 生成密钥

无需信用卡。无需试用。真正免费。

2. 设置您的密钥

export OPENROUTER_API_KEY="sk-or-v1-..."

或者将其添加到您的 OpenClaw 配置中：

openclaw config set env.OPENROUTER_API_KEY "sk-or-v1-..."

3. 运行 FreeRide

freeride auto

4. 重启 OpenClaw

openclaw gateway restart

5. 验证它是否工作

在 WhatsApp/Telegram/Discord 或仪表板上向您的代理发送消息：

You: /status Agent: (shows the free model name + token count)

完成。您现在正在运行带有自动回退功能的免费 AI。

您将获得什么

Primary Model: openrouter/nvidia/nemotron-3-nano-30b-a3b:free (256K context) Fallbacks: 1. openrouter/free ← Smart router (auto-picks best available) 2. qwen/qwen3-coder:free ← Great for coding 3. stepfun/step-3.5:free ← Fast responses 4. deepseek/deepseek:free ← Strong reasoning 5. mistral/mistral:free ← Reliable fallback

当您达到速率限制时，OpenClaw 会自动尝试下一个模型。您可以继续工作。没有中断。

命令

专业技巧

# 已经有你喜欢的模型？只需添加备用模型：
freeride auto -f

# 想要更多备用模型以确保最大运行时间？
freeride auto -c 10

# 编程？切换到最佳编程模型：
freeride switch qwen3-coder

# 查看可用模型：
freeride list -n 30

# 更改后总是重启OpenClaw：
openclaw gateway restart

如何对模型进行排名

FreeRide根据以下因素为每个模型评分(0-1)：

智能备用模型openrouter/free总是排在第一位 - 它会根据您的需求自动选择。

使用您的OpenClaw Agent进行测试

运行freeride auto和openclaw gateway restart后：

# 检查OpenClaw是否能看到模型
openclaw models list

# 验证配置
openclaw doctor --fix

# 打开仪表板并进行聊天
openclaw dashboard
# 或在WhatsApp/Telegram/Discord上给您的代理发送消息

有用的代理命令来验证：

观察者（自动轮换）

FreeRide包含一个观察者守护进程，用于监控速率限制并自动轮换模型：

# 运行一次（检查 + 如需要则轮换）
freeride-watcher

# 作为守护进程运行（持续监控）
freeride-watcher --daemon

# 强制轮换到下一个模型
freeride-watcher --rotate

# 检查观察者状态
freeride-watcher --status

# 清除速率限制冷却时间
freeride-watcher --clear-cooldowns

常见问题

这真的是免费的吗？

是的。OpenRouter为许多模型提供免费层级。您只需要一个账户（不需要信用卡）。

那速率限制呢？

这正是整个要点。FreeRide配置了多个备用模型。当一个模型对您进行速率限制时，OpenClaw会自动切换到下一个。

它会搞乱我的OpenClaw配置吗？

不会。FreeRide只修改agents.defaults.model和agents.defaults.models。您的网关、频道、插件、工作区、自定义说明 - 都会被保留。

哪些模型是免费的？

运行freeride list查看当前可用性。它会变化，这就是为什么FreeRide存在的原因。

更改后我需要重启OpenClaw吗？

是的。在任何更改您配置的FreeRide命令后，运行openclaw gateway restart。

数学原理

不客气。

要求

• 已安装 OpenClaw (Node ≥22)
• Python 3.8+
• 免费的 OpenRouter 账户 (获取密钥)

架构

┌──────────────┐ ┌──────────────┐ ┌──────────────────┐ │ 您 │ ──→ │ FreeRide │ ──→ │ OpenRouter API │ │ "freeride │ │ │ │ (30+ 免费 │ │ auto" │ │ • 获取 │ │ 模型) │ └──────────────┘ │ • 排序 │ └──────────────────┘ │ • 配置 │ └──────┬───────┘ │ ▼ ┌──────────────┐ │ ~/.openclaw/ │ │ openclaw.json│ └──────┬───────┘ │ openclaw gateway restart │ ▼ ┌──────────────┐ │ OpenClaw │ │ (免费 AI!) │ └──────────────┘

贡献

发现错误？想要新功能？欢迎提交 PR。

cd ~/.openclaw/workspace/skills/free-ride

# 测试命令
freeride list
freeride status
freeride auto --help

相关项目

• OpenClaw - AI 编程助手
• OpenRouter - 模型路由器
• ClawHub - 技能市场

许可证

MIT - 随你处置。

---

停止付费，开始免费使用。

⭐ 在 GitHub 上给我们加星 · 🔑 获取 OpenRouter 密钥 · 🦞 安装 OpenClaw