必须手动验证openrouter免费模型id有效性:先在https://www.php.cn/link/9f564390336e7e1b21904ddeab9b8d32筛选“free tier”且“active”的模型,直接复制右侧“model id”列带:free后缀的id(如stepfun/step-3.5-flash:free),避开-preview/-beta后缀、超大参数及meta-llama/70b+模型;再用openclaw models set和openclaw chat --test实测响应与错误码,仅验证通过的id(如stepfun/step-3.5-flash:free、anthropic/claude-3.5-sonnet、google/gemini-2.0-flash-exp)才写入config.yaml的model字段并重启服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

OpenClaw对接OpenRouter免费模型集市时,需从数十个实时可调用的免费模型中选出真正可用、响应快、不触发429限流的模型ID,而不是盲目复制官网列表里的名字——因为OpenRouter的免费池每小时都在动态变化,有些ID看似存在但实际已下线或需付费权限。
确认当前真实有效的免费模型ID
打开浏览器访问 https://www.php.cn/link/9f564390336e7e1b21904ddeab9b8d32 → 在搜索框输入 free → 页面会列出所有标注“Free tier”且状态为“Active”的模型。
注意:不要点进模型详情页再抄ID,直接看列表右侧「Model ID」列显示的内容,例如 【stepfun/step-3.5-flash:free】 或 【anthropic/claude-3.5-sonnet】 —— 冒号后带 :free 的才是明确标识免费额度的ID,没带的可能需订阅或已限免。
这一步漏掉冒号后缀,后面配置必然失败。OpenRouter对ID大小写和符号极其敏感,copy时多一个空格都会报404。
避开已失效或高延迟的常见陷阱ID
方法一:跳过带 -preview/-exp/-beta 后缀的模型ID
比如 google/gemini-3.1-pro-preview 看起来很新,但它在OpenClaw中实际调用时大概率返回 503 或超时,因为OpenRouter尚未对其开放稳定路由。
方法二:拒绝使用 qwen/qwen-2.5-72b-instruct 这类超大参数模型ID
它虽标着“Free tier”,但实际每天只允许调用3次,且平均响应时间超12秒,OpenClaw任务链会直接超时中断。
方法三:不选 meta-llama/ 开头的70B以上ID
除非你本地有A100显卡,否则OpenClaw通过OpenRouter中转调用时,token生成速度会跌到12 tokens/s以下,连基础问答都卡顿。
Gemini Notebook网页版是一款基于AI的智能笔记工具,其核心功能是让用户上传个人文档(如PDF、文本等),并以此为基础进行交互。它能针对你的资料进行总结、解答疑问、生成新内容,让信息处理更高效。该版本为在线使用,无需下载安装。
验证模型ID是否能在OpenClaw中真正跑通
第一步:终端执行 openclaw models set stepfun/step-3.5-flash:free
第二步:运行 openclaw chat --test 发送一句“你好”
第三步:观察终端是否返回完整响应文本,且无 429 Too Many Requests 或 401 Unauthorized 报错。
如果返回空白或报错,立刻换下一个ID——别纠结。FreeRide Skill已验证当前最稳的三个ID是:【stepfun/step-3.5-flash:free】、【anthropic/claude-3.5-sonnet】、【google/gemini-2.0-flash-exp】,优先试这三个。
这一步必须手动测试,不能只看OpenRouter页面上的“Free tier”标签就认为能用。有些模型对OpenClaw的User-Agent做了拦截,网页能调通,CLI却失败。
把验证通过的ID写入config.yaml(仅当需要持久化配置时)
用文本编辑器打开 ~/.openclaw/config.yaml → 找到 providers → openrouter 区块 → 在 model 字段填入你刚验证成功的ID,例如:model: "stepfun/step-3.5-flash:free"
保存文件后,重启OpenClaw服务:openclaw daemon restart。
⚠️ 注意:config.yaml里 model 字段值必须用英文双引号包裹,且不能有多余空格或中文标点,否则openclaw onboard会解析失败并清空整个配置。









