OpenClaw更换stepfun/step-3.5-flash模型报错Unknown model 解决核心漏加前缀摘要本文聚焦OpenClaw更换stepfun/step-3.5-flash:free模型时高频报错「Unknown model」的核心解决方法——忘记给主模型ID添加「modelstudio/」前缀精简实操步骤新手可快速上手。关键词OpenClawstepfun/step-3.5-flashUnknown modelmodelstudio前缀一、前言使用OpenClaw 2026.3.13版本更换OpenRouter免费模型stepfun/step-3.5-flash:free时频繁出现「Unknown model」报错排查后发现核心原因主模型ID未添加「modelstudio/」前缀整理极简解决步骤如下。环境说明OpenClaw版本2026.3.13模型stepfun/step-3.5-flash:freeOpenRouter系统Windows 10/11PowerShell操作二、核心报错及根源重点核心报错Unknown model: stepfun/step-3.5-flash:free报错截图【截图位置1粘贴该报错的PowerShell完整截图包含「Agent failed before reply: Unknown model: stepfun/step-3.5-flash:free」】错误根源唯一关键忘记给主模型ID添加「modelstudio/」前缀。核心规则必记OpenRouter官方模型IDstepfun/step-3.5-flash:free必须带「:free」不可删OpenClaw主模型ID必须在官方ID前加「modelstudio/」即modelstudio/stepfun/step-3.5-flash:free否则无法识别。三、极简解决步骤3步搞定步骤1停止网关避免冲突# 停止OpenClaw网关openclaw gateway stop# 强制杀死残留进程确保完全关闭taskkill/f/im openclaw.exe操作截图【截图位置2粘贴PowerShell执行上述命令的截图】步骤2修改配置文件核心添加前缀配置文件路径C:\Users\Administrator\.openclaw\openclaw.json替换Administrator为你的用户名打开命令notepad%userprofile%\.openclaw\openclaw.json重点修改1处其他内容不变找到「agents.defaults.model.primary」添加「modelstudio/」前缀agents:{defaults:{model:{primary:modelstudio/stepfun/step-3.5-flash:free// 关键添加前缀},workspace:C:\\Users\\Administrator\\.openclaw\\workspace}}配置修改截图【截图位置3粘贴记事本截图框选修改后的主模型ID突出「modelstudio/」前缀】保存文件并关闭。步骤3重启网关验证成功# 重启网关openclaw gateway restart# 验证配置输出正确前缀ID即成功openclaw config get agents.defaults.model.primary验证成功输出「modelstudio/stepfun/step-3.5-flash:free」启动网关无报错。操作截图【截图位置4粘贴PowerShell重启验证的截图框选验证结果】启动网关验证openclaw gateway run启动成功截图【截图位置5粘贴网关启动成功截图无Unknown model报错】四、常见踩坑仅1个核心坑核心踩坑主模型ID漏加「modelstudio/」前缀 → 解决按步骤2添加前缀无需修改其他配置。五、总结OpenClaw更换stepfun/step-3.5-flash:free模型报错「Unknown model」的核心原因就是忘加「modelstudio/」前缀无需复杂操作3步修改配置即可解决新手可直接照搬。六、需要截图的位置汇总共5处截图1Unknown model: stepfun/step-3.5-flash:free 报错截图截图2执行停止网关、杀死进程命令的截图截图3配置文件修改截图框选带前缀的主模型ID截图4重启网关验证配置的截图框选验证结果截图5网关启动成功、无报错的截图。注文档部分内容可能由 AI 生成