
你好,我是郑工长。
前两天朋友甩给我一张账单,一个月大模型 API 花了 ¥300+。
我说你傻啊,OpenRouter 有免费模型你不知道?同样的调用量,成本直接归零。
他一脸懵:"还有这种好事?"
说实话,知道的人确实不多。但白嫖这事儿,得会折腾。今天我把完整配置流程给你,6 步搞定,照着做就行。
先泼盆冷水: 免费模型共享额度,用的人多了会限流。但如果你调用量不大,或者能接受偶尔卡一下,这就是真香现场。
第一步:搞到 OpenRouter API Key
简单,但容易踩坑。
- 打开 openrouter.ai
- 注册账号(邮箱/Google/GitHub 都行)
- 进 Settings → API Keys
- 点 Create Key,复制生成的 Key
⚠️ 注意:
- Key 只显示一次,存好别丢
- 建议起个有意义的名字,比如 "openclaw-home"
- 不用绑卡,但最好开两步验证
第二步:配置环境变量
编辑环境变量文件:
vim ~/.openclaw/.env
加上:
OPENROUTER_API_KEY=sk-or-v1-你的key
保存后激活:
source ~/.zshrc
验证一下:
echo $OPENROUTER_API_KEY
有输出就对了。
第三步:在 OpenClaw 里加 Provider
提示:你如果没有将api-key定义到.env中,可以直接定义到openclaw.json,结果是一样的!
编辑 ~/.openclaw/openclaw.json,找到 models.providers,加上:
"openrouter": {
"baseUrl": "https://openrouter.ai/api/v1",
"apiKey": "${OPENROUTER_API_KEY}",
"api": "openai-completions",
"models": [
{
"id": "minimax/minimax-m2.5:free",
"name": "MiniMax M2.5 (OpenRouter Free)",
"reasoning": false,
"input": ["text"],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 128000,
"maxTokens": 8192
}
]
}
重点:
apiKey用${OPENROUTER_API_KEY}引用环境变量cost全设 0,OpenClaw 才知道这是免费的contextWindow和maxTokens按实际模型填
第四步:加个别名(强烈建议)
在 defaults.models 里加:
"openrouter/minimax-m2.5:free": {
"alias": "openrouter-minimax"
}
为啥?省事儿。以后切模型直接 /model openrouter-minimax,不用记那一长串 ID。
第五步:重启 OpenClaw
配置完必须重启:
openclaw restart
等个 5-10 秒,看到 "started successfully" 就 OK。
第六步:验证
重启后测试:
/model openrouter-minimax
发条消息试试:
你好,证明你是 MiniMax
正常回复就搞定了。
目前可用的免费模型
我整理了几个比较稳的:
| 模型 | 中文 | 代码 | 推荐度 |
|---|---|---|---|
| minimax-m2.5:free | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| qwen3-coder:free | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| qwen3.6-plus:free | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| glm-4.5-air:free | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ |
| gemma-3-27b:free | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ |
我的选择:
- 日常聊天用 MiniMax M2.5(中文真的强)
- 写代码用 Qwen3 Coder(理解力在线)
- 通用场景 Qwen3.6 Plus(综合实力最好,但可能排队)
常见问题
429 错误(限流)
用的人太多,等 1-2 分钟重试,或者换个模型。
401 错误(认证失败)
检查 ~/.openclaw/.env 里的 Key 对不对,别有多余空格。
模型不存在
可能下架了,查一下当前可用列表:
curl -s "https://openrouter.ai/api/v1/models" \
-H "Authorization: Bearer $OPENROUTER_API_KEY" | \
python3 -c "import sys,json; models=json.load(sys.stdin)['data']; free=[m['id'] for m in models if ':free' in m['id']]; print('\n'.join(sorted(free)))"

适合谁用?
适合:
- 个人学习/折腾
- 一天调用几百次
- 非关键业务
- 想省钱的
不适合:
- 高频生产环境
- 对延迟敏感的
- 需要 SLA 保障的
OpenRouter 免费模型是真能白嫖,但有限制。个人用户完全可以上手,按这 6 步走就行。
有问题留言,看到回。





