Freeride Zh

FreeRide - OpenClaw 免费AI

这个技能的作用

配置 OpenClaw 使用 OpenRouter 的免费 AI 模型。将最佳免费模型设置为主模型，添加排名靠前的备用模型以便在限流时不中断用户，同时保留现有配置。

前置条件

在运行任何 FreeRide 命令之前，请确保：

1. 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-..."
   

2. freeride CLI 已安装。 使用 which freeride 检查。如果未找到：

   cd ~/.openclaw/skills/freeride-zh
   pip install -e .
   

主要工作流程

当用户想要免费 AI 时，按顺序执行以下步骤：

# 步骤 1：配置最佳免费模型 + 备用模型
freeride auto

# 步骤 2：重启网关以便 OpenClaw 应用更改
openclaw gateway restart

就这么简单。用户现在拥有了带自动故障切换的免费 AI。

通过告诉用户发送 /status 来验证当前使用的模型。

命令参考

任何更改配置的命令后，都要运行 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    # 检查轮换历史

故障排除