by 运行时依赖
版本
OpenClaw gateway re启动
安装命令
点击复制技能文档
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 时，按照以下步骤运行： # 步骤 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 用户想要特定的模型（例如 freeride switch qwen3-coder） freeride switch -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: 命令未找到 cd ~/.openclaw/workspace/skills/free-ride && pip install -e . OPENROUTER_API_KEY 未设置 用户需要从 https://openrouter.ai/keys 获取一个密钥 更改不生效 openclaw gateway restart 然后 /new 以获取新的会话 代理显示 0 个令牌 检查 freeride 状态 — 主模型应该是 openrouter//:free