openclaw模型列表为空是因api key来源不匹配、base url层级错误或模型id非官方支持所致;需严格核对key提供方与模型标识一致性,base url须精确到/v1,且模型id须与平台文档完全一致。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

OpenClaw配置完API Key后模型列表为空、界面不显示可用模型,说明系统未能成功识别或加载对应模型服务,不是单纯界面刷新问题。
确认模型标识与 API Key 来源严格匹配
第一步:打开 OpenClaw 部署助手 → 进入【AI模型】配置页 → 查看当前已添加模型的名称(如 deepseek-chat 或 qwen-max)。
第二步:访问该模型所属平台官网(例如 DeepSeek 平台 或 通义千问控制台),登录后进入【API 密钥管理】。
第三步:核对所用 Key 的 provider 字段是否与模型名完全一致——deepseek-chat 要求 Key 必须来自 DeepSeek 平台且未过期,qwen-max 则必须使用阿里云 DashScope 生成的 Key。填错来源的 Key 即使格式正确也会被拒绝。
第四步:删除当前错误配置项,重新选择模型类型(不能只改 Key),再粘贴对应平台新生成的完整 Key。旧 Key 若已失效或绑定其他项目,即使来源正确也无法触发模型加载。
检查 Base URL 是否填写完整且层级正确
方法一:直接查看 OpenClaw 日志输出(启动终端或日志文件),搜索 “failed to list models” 或 “404” 错误,定位实际请求地址。
方法二:用 curl 手动验证最小请求基线:
统一LLM网关 - 一个API对接70+AI模型,使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
curl https://your-base-url/v1/models \-H "Authorization: Bearer YOUR_API_KEY"
注意:Base URL 必须精确到 /v1 级别(如 https://api.deepseek.com/v1),不能是 https://api.deepseek.com(缺/v1)或 https://api.deepseek.com/v1/models(多了一层路径)。OpenClaw 内部会自动拼接 /models 路径,填错会导致 404。
如果 curl 返回 401 或空数组,说明 Key 或 Base URL 至少有一项不匹配;若返回 404,基本可断定 Base URL 层级错误。
验证模型 ID 是否为服务商真实支持的 ID
打开对应平台文档,查找「模型列表」或「可用模型」页面,确认你填入 OpenClaw 的 model 名称(如 qwen-max、deepseek-chat、ernie-bot-4)是否出现在官方支持列表中。
很多平台展示的是产品名(如“通义千问 Qwen2.5-Max”),但 API 实际要求的是内部模型 ID(如 qwen-max),大小写、连字符、版本号都不能错。填错一个字符,OpenClaw 就无法拉取该模型元信息。
特别提醒:部分国产模型(如文心一言)需在配置中显式启用子模块,例如在 config.toml 中补全 [llm.ernie] 区块并填入 base_url 和 api_key,仅填通用 llm 模块无效。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!









