介绍
# FreeRide - Free AI for OpenClaw
## 此技能的功能
配置 OpenClaw 以使用来自 OpenRouter 的**免费** AI 模型。将最佳免费模型设置为主模型，添加排序后的后备模型以避免速率限制打断用户，并保留现有配置。
## 先决条件
在运行任何 FreeRide 命令之前，请确保：
1. **已设置 OPENROUTER_API_KEY。** 使用 `echo $OPENROUTER_API_KEY` 检查。如果为空，用户必须在 https://openrouter.ai/keys 获取免费密钥并进行设置： ```bash export OPENROUTER_API_KEY="sk-or-v1-..." # Or persist it: openclaw config set env.OPENROUTER_API_KEY "sk-or-v1-..." ```
2. **已安装 `freeride` CLI。** 使用 `which freeride` 检查。如果未找到： ```bash cd ~/.openclaw/workspace/skills/free-ride pip install -e . ```
## 主要工作流
当用户需要免费 AI 时，按顺序运行以下步骤：
```bash # Step 1: Configure best free model + fallbacks freeride auto
# Step 2: Restart gateway so OpenClaw picks up the changes 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` 命令显示免费模型
其他所有内容（gateway、channels、plugins、env、customInstructions、命名代理）均被保留。
第一个后备始终是 `openrouter/free` — OpenRouter 的智能路由器，它会根据请求自动选择最佳可用模型。
## 监视器（可选）
如果需要在达到速率限制时自动轮换，用户可以运行：
```bash freeride-watcher --daemon # Continuous monitoring freeride-watcher --rotate # Force rotate now freeride-watcher --status # Check rotation history ```
## 故障排除
| 问题 | 解决方法 | |---------|-----| | `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 tokens | 检查 `freeride status` — 主模型应为 `openrouter/<provider>/<model>:free` |