问题大概率出在模型ID、Key来源与协议兼容性校验链错位:需严格匹配模型ID与对应平台Key,Base URL须为https://taotoken.net/api(无参数),并确认Node.js≥v20.12.0、CUDA≥12.4(多模态场景)及settings.json字段拼写正确。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

当你在 AionClaw 中更换模型后仍持续报错,问题大概率不在界面点击动作本身,而藏在模型标识、密钥来源与协议兼容性的三重校验链中——任何一个环节错位,系统都会直接拦截请求并返回模糊提示。
确认模型 ID 与 Key 来源是否严格匹配
第一步:打开 AionClaw 客户端 → 进入【设置】→【AI 模型】页,查看当前选中的模型 ID(例如 deepseek-r1 或 qwen2.5-72b)。
第二步:登录该模型对应平台的控制台,核对 API Key 的生成来源。比如选的是 deepseek-r1,Key 就必须来自 https://platform.deepseek.com;若 Key 是从阿里云 DashScope 控制台复制的,则只支持 qwen-max 等通义系模型,混用必报“模型不支持”。
第三步:删除当前错误配置项,重新添加——不要复用旧 Key,务必在目标平台新建一个 Key 并完整粘贴,旧 Key 可能已被平台自动轮转失效。
检查 Base URL 是否启用 RAW 模式
方法一:使用 TaoToken 统一通道时,Base URL 必须为 https://taotoken.net/api,且不能带任何 UTM 参数或斜杠结尾。
方法二:若直连厂商接口(如 DeepSeek),需确认是否开启 RAW 兼容模式。部分新版模型要求在 Base URL 后追加 /v1,例如 https://api.deepseek.com/v1;漏掉会导致 404 或协议解析失败。
注意:AionClaw 默认走 OpenAI 兼容协议,所有非 OpenAI 原生接口都必须经 TaoToken 或自行启用 RAW 模式,否则模型识别层直接跳过加载。
验证本地运行环境是否满足模型要求
① 打开终端,执行 node -v,确认 Node.js 版本 ≥ v20.12.0;低于此版本会触发权重校验异常,报错无明确提示。
② 若调用的是视觉或多模态模型(如 qwen2-vl-7b),需额外检查 CUDA 驱动版本是否 ≥ 12.4,且 AionClaw 是否以 GPU 模式启动(Windows 下需右键快捷方式 → 属性 → 目标末尾添加 --gpu)。
③ 运行 openclaw doctor(需先进入 AionClaw CLI 容器),它会自动扫描 JSON Schema 合法性、模型路径可读性、权限状态三项。只要其中任一栏显示 ❌,就别继续填模型参数了——先解决底层健康问题。
排查配置文件中的非法字段
打开 AionClaw 安装目录下的 settings.json,定位到 "model" 节点,检查是否存在以下任一情况:
• 字段名拼写错误,例如写成 "modle" 或 "model_id"(正确应为 "model");
• Model ID 中混入不可见空格或全角字符,尤其从网页复制时容易带入;
• 在非 TaoToken 场景下误填了 "provider": "taotoken" 字段——这个字段仅 TaoToken 自身配置需要,直连厂商时必须删除。


















