“模型不支持”提示源于模型与API Key不匹配、协议校验失败、环境不兼容、配置文件非法或权重校验异常；需依次核对密钥来源、启用RAW模式、检查Node.js/CUDA版本、验证JSON Schema、重置权重文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 OpenClaw AI 时收到“模型不支持”提示，通常意味着当前配置的模型未被系统识别、协议不兼容、认证信息错配或运行环境不满足基础要求。以下是解决此问题的步骤：
一、确认模型与 API Key 来源严格匹配
OpenClaw 对模型标识与密钥来源实行强绑定校验。若选择 DeepSeek 模型却填入通义千问平台生成的 API Key，即使 Key 本身有效，也会触发“模型不支持”错误。
1、打开 OpenClaw 部署助手 → 进入【AI模型】配置页。
2、查看当前已添加模型的名称（如 deepseek-chat 或 qwen-max）。
3、访问对应平台官网（例如 https://platform.deepseek.com 或 https://dashscope.console.aliyun.com），登录后进入【API 密钥管理】。
4、确认所用 Key 的 provider 字段与模型名完全一致（如 deepseek-chat 要求 Key 来自 DeepSeek 平台，且未过期）。
5、删除错误配置项，重新选择正确模型类型并粘贴对应平台新生成的完整 Key。
二、启用 RAW 模式绕过协议校验
当集成国产大模型、私有部署服务或自定义接口时，“模型不支持”常源于 OpenClaw 内置模式节点无法解析其响应结构。RAW 模式可跳过标准 API 封装与数据模式校验，直接透传原始请求与响应。
1、编辑 ~/.openclaw/openclaw.json 配置文件。
2、定位到目标模型的 model_config 区块。
3、将 mode 字段设为 "raw"，并启用关键参数：
4、添加 "bypass_validation": true 和 "raw_format": true。
5、确保 endpoint 指向真实可用的模型服务地址（如 https://api.deepseek.com/v1/chat/completions）。
三、验证 Node.js 与 CUDA 环境兼容性
底层运行时不匹配会导致模型加载阶段即报“模型不支持”，而非连接失败。OpenClaw v0.4.2 明确要求 Node.js ≥ 22 且 CUDA Runtime 为 11.8 或 12.1 版本。
1、执行 node --version，确认输出为 v22.x 或更高版本。
2、若低于该版本，使用 nvm 升级：nvm install 22 && nvm use 22。
使用聊天补全、重试、结构化输出和明确的 User-Agent 标头运行 AIMLAPI LLM 与推理工作流，适用于 Codex 对 AIMLAPI 模型进行脚本化提示/推理调用的场景。
3、执行 nvcc --version，检查是否显示 release 11.8 或 release 12.1。
4、若为 CUDA 12.3+，卸载系统级 toolkit，改用 conda 安装：conda install cudatoolkit=11.8 -c conda-forge。
5、验证 LD_LIBRARY_PATH（Linux/macOS）或 PATH（Windows）中 CUDA 11.8 路径优先级最高。
四、检查配置文件 Schema 合法性
OpenClaw 启动时会对 openclaw.json 执行严格 JSON Schema 校验。任意字段名拼写错误、嵌套层级错误或值类型不符（如布尔值写成字符串），均会导致模型模块初始化失败并显示“模型不支持”。
1、运行 openclaw logs | grep "config" 提取校验失败详情。
2、定位报错行号及字段名（如 "gateway.mode" 缺失或 "agents.defaults.model.primary" 类型错误）。
3、使用官方校验工具修复：openclaw doctor --fix-config。
4、若无自动修复能力，手动对照文档修改字段，确保所有键名与大小写完全一致。
5、保存后执行 openclaw config validate 确认通过。
五、重置权重文件哈希校验与模型路径
部分模型（如 claw-llama3-8b-q4_k_m.bin）因镜像源传输截断导致 SHA-256 校验失败，OpenClaw 会拒绝加载并返回“模型不支持”。该错误实际发生在本地权重加载阶段，而非远程调用。
1、运行校验脚本：python verify_weights.py --model claw-llama3-8b --hash 9a7f3b1e...（哈希值需从 docs/checksums.md 获取）。
2、若校验失败，删除当前权重文件所在目录（如 ~/.openclaw/models/claw-llama3-8b/）。
3、从官方源 https://openclaw.ai/models 下载原始 .bin 文件，禁止解压后重命名或移动路径层级。
4、将文件放入对应模型目录，确保文件权限为可读（chmod 644 *.bin）。
5、重启 Gateway：openclaw gateway restart。
