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 手动验证最小请求基线：
OpenClaw 跨平台配置备份与网关监控。自动备份 openclaw.json，每分钟检测 gateway 状态，宕机时自动恢复。支持 Linux/macOS/Windows。触发：配置备份、gateway 监控、自动恢复、看门狗、watchdog。
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 模块无效。
