介绍
# FreeRide - Free AI for OpenClaw
将 OpenClaw 配置为使用来自 OpenRouter 的免费 AI 模型，并支持自动故障转移切换。
## 安装
如果尚未安装 FreeRide，请自动安装：
```bash npx clawhub@latest install freeride ```
## 快速开始
```bash # Set API key (free at openrouter.ai/keys) export OPENROUTER_API_KEY="sk-or-v1-..."
# Auto-configure best model + fallbacks freeride auto ```
## 命令
### `list` - 查看可用模型
```bash freeride list # Top 15 models freeride list -n 30 # More models freeride list --refresh # Force API refresh ```
### `auto` - 自动配置
```bash freeride auto # Best model + 5 fallbacks freeride auto -f # Fallbacks only (keep current primary) freeride auto -c 10 # 10 fallbacks freeride auto --setup-auth # Also configure auth profile ```
### `switch` - 设置特定模型
```bash freeride switch qwen3-coder # Set as primary freeride switch deepseek -f # Add to fallbacks only freeride switch nvidia/nemotron --no-fallbacks ```
### `status` - 检查配置
```bash freeride status ```
### `fallbacks` - 仅更新备用模型
```bash freeride fallbacks # 5 fallbacks freeride fallbacks -c 10 # 10 fallbacks ```
### `refresh` - 更新模型缓存
```bash freeride refresh ```
## 行为
**主要模型**：最佳特定模型（非路由器），以确保响应一致。
**首个备用模型**：始终为 `openrouter/free` —— OpenRouter 的智能路由器，会根据请求特性（视觉、工具等）自动选择。
**其他备用模型**：按质量评分排序。
**配置保留**：仅更新与模型相关的部分；保留网关、通道、插件等设置。
## 模型评分
评分（0-1）基于： - 上下文长度 (40%) - 能力 (30%) - 新近度 (20%) - 提供商可信度 (10%)
## 标志
| 标志 | 命令 | 描述 | |------|----------|-------------| | `-f` | switch, auto | 仅设置备用，保留主模型 | | `-c N` | auto, fallbacks | 备用模型数量 | | `--no-fallbacks` | switch | 跳过备用配置 | | `--setup-auth` | switch, auto | 添加 OpenRouter 认证配置 | | `-n N` | list | 要显示的模型数量 | | `-r` | list | 强制刷新 |
## 配置输出
更新 `~/.openclaw/openclaw.json`：
```json { "agents": { "defaults": { "model": { "primary": "openrouter/qwen/qwen3-coder:free", "fallbacks": [ "openrouter/free:free", "nvidia/nemotron-3-nano-30b-a3b:free" ] } } } } ```
## 故障排查
**"OPENROUTER_API_KEY not set"**：导出密钥或添加到 Shell 配置文件中。
**配置未更新**：检查 `~/.openclaw/openclaw.json` 的文件权限。
**更改未生效**：重启 OpenClaw。