在使用OpenClaw调用大模型接口时，如果系统返回 404 Model Not Found、model_not_found、The model does not exist、404 Not Found、Requested model not found，说明当前请求的模型名称在Provider接口中不存在，或者OpenClaw没有正确映射该模型。该错误通常由模型名称错误、Provider不匹配、API Base URL错误、Alias映射错误、模型未添加、接口不支持该模型、本地模型名称错误、OpenAI兼容接口不完整、缓存未刷新、版本不支持等原因导致。

解决OpenClaw Model Not Found 404错误，需要逐项检查模型配置、Provider绑定、API地址、模型列表、Alias映射、Docker环境变量、本地模型接口以及OpenClaw版本兼容性。

一、模型名称写错导致404

最常见原因是模型名称拼写错误。

错误示例：

gpt4
gpt4o
gpt-4-mini
claude3
gemini-pro

正确示例：

gpt-4o
gpt-4o-mini
gpt-4.1
claude-3-sonnet-20240229
gemini-1.5-pro

解决方法：

• 进入Models列表
• 复制真实名称
• 不要手动猜测

二、Provider不匹配导致404

模型和Provider必须一致。

错误：

model = gpt-4o
provider = anthropic

正确：

provider = openai

错误：

model = claude-3
provider = openai

正确：

provider = anthropic

规则：

• openai → gpt
• anthropic → claude
• google → gemini
• ollama → llama
• custom → openai兼容

三、模型未添加到OpenClaw

OpenClaw必须先注册模型。

进入：

• Models
• Add Model

示例：

name = gpt-4o-mini
provider = openai

未添加直接调用会404。

四、Alias映射错误

Alias如果指向不存在模型，会404。

错误：

fast -> gpt4

正确：

fast -> gpt-4o-mini

检查：

• Models
• Alias

五、API Base URL错误

如果接口地址不支持该模型，也会404。

错误：

https://api.openai.com

正确：

https://api.openai.com/v1

本地API：

http://127.0.0.1:8000/v1

必须支持：

/models

六、自定义API不支持该模型

很多OpenAI兼容接口只支持部分模型。

测试：

curl http://127.0.0.1:8000/v1/models

查看返回列表。

如果没有：

gpt-4o

就不能调用。

七、本地模型名称错误

Ollama必须使用完整名称。

错误：

llama3

正确：

llama3:8b
llama3:70b

检查：

ollama list

八、Workflow使用旧模型

Workflow保存旧名称。

进入：

• Workflows
• Edit

检查：

model = old_model

修改为：

model = fast

九、Agent绑定不存在模型

Agent模型不存在会404。

进入：

• Agents
• Edit

修改模型。

十、Fallback模型不存在

如果fallback不存在，会404。

fallback = claude

但未添加Claude。

十一、Key没有权限访问模型

部分Key无法访问高级模型。

例如：

• 没有GPT4权限
• 没有Vision权限

测试：

curl https://api.openai.com/v1/models

十二、版本不支持新模型

旧版OpenClaw不识别新模型。

升级：

docker pull openclaw/openclaw:latest

重启：

docker compose up -d

十三、缓存未刷新

修改模型后未重启。

docker restart openclaw

或：

rm -rf cache

十四、数据库仍保存旧配置

sqlite3 data.db

select * from models;

删除错误记录。

十五、多Provider冲突

多Provider时必须指定。

provider=openai
provider=anthropic
provider=ollama

否则404。

十六、推荐正确配置

gpt-4o-mini
provider=openai

claude-3-sonnet
provider=anthropic

llama3:8b
provider=ollama

gemini-1.5-pro
provider=google

Alias：

fast
smart
local
vision

使用正确模型名、正确Provider、正确Alias、正确API地址，可以避免OpenClaw Model Not Found 404错误。