Free Model Finder - 多平台免费模型发现与配置

核心功能

1️⃣ 模型发现

扫描多个平台的免费/低价模型： - OpenRouter：免费模型聚合（:free 后缀） - HuggingFace：免费 Inference API 额度 - Groq：免费高速推理（Llama、Mixtral 等） - Google AI Studio：Gemini 免费额度 - Ollama：本地运行（完全免费） - 其他平台：可扩展

2️⃣ 模型对比

按以下维度排序： - 价格（免费/每百万 token 成本） - 速度（平均响应时间） - 质量（上下文长度、能力评级） - 稳定性（rate limit 策略）

3️⃣ 自动配置

直接修改 OpenClaw 配置文件
设置主模型 + 备用模型列表
自动重启 Gateway 生效

4️⃣ 监控轮换

检测 rate limit 错误
自动切换到备用模型
记录切换历史

快速开始

# 查看所有平台免费模型清单
free-model-finder list

# 只看 OpenRouter 免费模型
free-model-finder list --platform openrouter

# 自动配置最优免费模型（推荐）
free-model-finder auto

# 切换到指定模型
free-model-finder switch groq/llama-3.1-70b-versatile

# 查看当前配置
free-model-finder status

# 监控 rate limit 并自动轮换
free-model-finder watch --daemon

命令参考

命令	说明
`list [--platform] [--limit]`	列出可用模型
`compare [--top N]`	对比前 N 个模型的性价比
`auto [--platforms]`	自动配置最优模型
`switch <model>`	切换到指定模型
`status`	查看当前配置
`watch [--daemon]`	监控并自动轮换
`refresh`	刷新模型缓存

平台配置

OpenRouter

需要 API Key：https://openrouter.ai/keys

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

Groq

需要 API Key：https://console.groq.com/keys

export GROQ_API_KEY="gsk_..."

Google AI Studio

需要 API Key：https://aistudio.google.com/app/apikey

export GOOGLE_API_KEY="..."

HuggingFace

需要 API Key：https://huggingface.co/settings/tokens

export HF_TOKEN="..."

Ollama

本地运行，无需 API Key：

# 安装后直接可用
ollama pull llama3.1

配置文件位置

OpenClaw 配置：~/.openclaw/openclaw.json - agents.defaults.model.primary：主模型 - agents.defaults.model.fallbacks：备用模型列表

扩展新平台

在 references/platforms.md 中添加新平台支持。

故障排查

问题	解决方案
命令找不到	`pip install -e .` 在技能目录运行
API Key 错误	检查对应平台的环境变量
配置不生效	运行 `openclaw gateway restart`
模型列表为空	运行 `free-model-finder refresh` 刷新缓存

free-model-finder

Installation