【Bug已解决】openclaw model not found / Invalid model name — OpenClaw 模型不存在解决方案-北京尧图网络

【Bug已解决】openclaw: model not found / Invalid model name — OpenClaw 模型不存在解决方案1. 问题描述OpenClaw 使用了不存在或已弃用的模型名称# 模型不存在 $ openclaw --model claude-3 task Error: model_not_found Model claude-3 does not exist. # 或模型已弃用 $ openclaw --model claude-2 task Error: model_deprecated Model claude-2 is no longer available. # 或模型名拼写错误 $ openclaw --model Claude-Sonnet task Error: model_not_found Model Claude-Sonnet does not exist. # 或配置中的模型不存在 $ cat .openclaw/config.json {model: claude-3-opus} $ openclaw task Error: model_not_found这个问题在以下场景中特别常见模型名拼写错误大小写使用了已弃用的模型模型名不完整缺少日期后缀配置中的模型名错误版本不支持新模型混淆了不同 API 的模型名2. 原因分析原因分类表原因分类具体表现占比拼写错误大小写/空格约 35%已弃用claude-2约 25%不完整缺少日期约 20%配置错误config.json约 10%版本不支持旧版本约 5%混淆 APIOpenAI 名称约 5%3. 解决方案方案一使用正确的模型名最推荐# 步骤 1查看可用模型 openclaw --list-models # 或 openclaw --help | grep -A20 model # 步骤 2使用正确的名称 openclaw --model claude-sonnet-4-20250514 task openclaw --model claude-opus-4-20250514 task openclaw --model claude-3-haiku-20240307 task # 步骤 3避免错误名称 # 错误: claude-3, Claude-Sonnet, claude-sonnet # 正确: claude-sonnet-4-20250514 # 步骤 4验证 openclaw --model claude-sonnet-4-20250514 --print hello方案二修复配置文件# 步骤 1检查配置 cat .openclaw/config.json | grep model # 步骤 2修复模型名 cat .openclaw/config.json EOF { model: claude-sonnet-4-20250514 } EOF # 步骤 3验证 python3 -m json.tool .openclaw/config.json # 步骤 4测试 openclaw --print hello方案三使用环境变量# 步骤 1设置模型 export OPENCLAW_MODELclaude-sonnet-4-20250514 # 步骤 2永久设置 echo export OPENCLAW_MODELclaude-sonnet-4-20250514 ~/.bashrc source ~/.bashrc # 步骤 3测试 openclaw --print hello # 步骤 4验证模型 openclaw --debug 21 | grep -i model方案四检查大小写# 步骤 1模型名是大小写敏感的 # 正确: claude-sonnet-4-20250514 (全小写) # 错误: Claude-Sonnet-4-20250514 # 错误: CLAUDE-SONNET-4-20250514 # 步骤 2避免空格 # 错误: claude sonnet 4 # 正确: claude-sonnet-4-20250514 # 步骤 3包含日期后缀 # 错误: claude-sonnet-4 # 正确: claude-sonnet-4-20250514 # 步骤 4验证 openclaw --model claude-sonnet-4-20250514 --print hello方案五使用默认模型# 步骤 1不指定模型使用默认 openclaw task # 步骤 2或移除配置中的 model python3 -c import json with open(.openclaw/config.json) as f: config json.load(f) config.pop(model, None) with open(.openclaw/config.json, w) as f: json.dump(config, f, indent2) # 步骤 3使用默认模型 openclaw --print hello # 步骤 4验证 openclaw --debug 21 | grep -i model\|default方案六更新版本# 步骤 1检查版本 openclaw --version # 步骤 2更新 pip install --upgrade openclaw # 步骤 3验证模型支持 openclaw --list-models # 步骤 4测试 openclaw --model claude-sonnet-4-20250514 --print hello4. 各方案对比总结方案适用场景推荐指数难度方案一正确名称通用⭐⭐⭐⭐⭐低方案二修复配置config⭐⭐⭐⭐⭐低方案三环境变量替代⭐⭐⭐⭐低方案四检查大小写拼写⭐⭐⭐⭐⭐低方案五默认模型临时⭐⭐⭐⭐低方案六更新版本⭐⭐⭐低5. 常见问题 FAQ5.1 如何查看可用模型openclaw --list-models5.2 常用的模型名claude-sonnet-4-20250514claude-opus-4-20250514claude-3-haiku-202403075.3 模型名大小写重要吗是的。使用全小写claude-sonnet-4-20250514。5.4 需要日期后缀吗是的。claude-sonnet-4不够需要claude-sonnet-4-20250514。5.5 claude-2 还可用吗不可用。已弃用。5.6 如何在配置中设置{model: claude-sonnet-4-20250514}5.7 可以用环境变量吗export OPENCLAW_MODELclaude-sonnet-4-202505145.8 不指定模型会怎样使用默认模型通常是最新的 Sonnet。5.9 混淆了 OpenAI 模型名不要使用gpt-4o等 OpenAI 模型名。使用claude-*格式。5.10 排查清单速查表□ 1. openclaw --list-models 查看 □ 2. 全小写: claude-sonnet-4-20250514 □ 3. 包含日期后缀 □ 4. 不用 claude-2已弃用 □ 5. 不用 gpt-4oOpenAI 名 □ 6. 修复 config.json model 字段 □ 7. OPENCLAW_MODEL 环境变量 □ 8. 不指定用默认模型 □ 9. python3 -m json.tool 验证 □ 10. pip install --upgrade 更新6. 总结根本原因模型不存在最常见原因是拼写错误35%和已弃用25%最佳实践使用openclaw --list-models查看可用模型正确格式全小写日期后缀如claude-sonnet-4-20250514配置修复在 config.json 中设置正确的模型名最佳实践建议使用环境变量OPENCLAW_MODEL或在 config.json 中设置故障排查流程图flowchart TD A[模型不存在] -- B[openclaw --list-models] B -- C{找到正确名?} C --|是| D[使用正确模型名] C --|否| E[使用默认模型] D -- F[--model claude-sonnet-4-20250514] F -- G[openclaw --print hello 验证] E -- H[openclaw task 不指定] H -- G G -- I{成功?} I --|是| j[✅ 问题解决] I --|否| K[检查配置] K -- L[cat config.json | grep model] L -- M{配置有 model?} M --|是| N[修复配置中的模型名] M --|否| O[添加正确模型名] N -- P[config.json: model: claude-sonnet-4-20250514] O -- P P -- G G -- Q{成功?} Q --|是| j Q --|否| R[检查大小写] R -- S[全小写日期后缀] S -- G G -- T{成功?} T --|是| j T --|否| U[使用环境变量] U -- V[OPENCLAW_MODELclaude-sonnet-4-20250514] V -- G G -- W{成功?} W --|是| j W --|否| X[更新版本] X -- Y[pip install --upgrade openclaw] Y -- G j -- Z[长期: 正确名 config 验证] Z -- AA[✅ 长期方案]

【Bug已解决】openclaw model not found / Invalid model name — OpenClaw 模型不存在解决方案

相关推荐

NanoPi NEO3 单网口旁路由配置：OpenWrt 25.12 防火墙3条规则详解

AI自我改进系统：从递归提升到Zenith架构的工程实践

Unity跨平台开发：条件编译与自定义宏实战指南

更多资讯

高级电工证拿多少补贴最新政策解读

钦州电工证不能查了上岗必须要这个证吗

电工作业的职业危害6官方报名入口与备考攻略

乌市特种工查询怎么报名，工地太忙根本没时间复习考试

特级电工作业工作证怎么考，上岗必备流程全解析

证书过期了不知道怎么复审延期？真实经历告诉你欧盟防爆电工证怎么搞

今日更新

普宁电工证在哪报名官方回应怕考不过白交培训费？这些避坑干货你必须知道

高压电工证登高练习题在哪考合格率高？怕考不过白交培训费

电工作业登记表通过率揭秘：怕考不过白交培训费？洛阳学员亲测经验全公开

本周精选

普宁电工证在哪报名官方回应怕考不过白交培训费？这些避坑干货你必须知道

高压电工证登高练习题在哪考合格率高？怕考不过白交培训费

电工作业登记表通过率揭秘：怕考不过白交培训费？洛阳学员亲测经验全公开

本月热门

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

基于DRV8818与STM32的双极步进电机驱动方案实战解析

DRV8818PWPR+PIC18F45K80双极步进电机控制方案实战

读完文章，想聊聊您的网站？

相关推荐

NanoPi NEO3 单网口旁路由配置：OpenWrt 25.12 防火墙3条规则详解

AI自我改进系统：从递归提升到Zenith架构的工程实践

Unity跨平台开发：条件编译与自定义宏实战指南

更多资讯

高级电工证拿多少补贴最新政策解读

钦州电工证不能查了 上岗必须要这个证吗

电工作业的职业危害6官方报名入口与备考攻略

乌市特种工查询怎么报名，工地太忙根本没时间复习考试

特级电工作业工作证怎么考，上岗必备流程全解析

证书过期了不知道怎么复审延期？真实经历告诉你欧盟防爆电工证怎么搞

今日更新

普宁电工证在哪报名官方回应怕考不过白交培训费？这些避坑干货你必须知道

高压电工证登高练习题在哪考合格率高？怕考不过白交培训费

电工作业登记表通过率揭秘：怕考不过白交培训费？洛阳学员亲测经验全公开

本周精选

普宁电工证在哪报名官方回应怕考不过白交培训费？这些避坑干货你必须知道

高压电工证登高练习题在哪考合格率高？怕考不过白交培训费

电工作业登记表通过率揭秘：怕考不过白交培训费？洛阳学员亲测经验全公开

本月热门

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

基于DRV8818与STM32的双极步进电机驱动方案实战解析

DRV8818PWPR+PIC18F45K80双极步进电机控制方案实战

读完文章，想聊聊您的网站？

钦州电工证不能查了上岗必须要这个证吗