AionClaw模型不可见是因定义或启用环节断裂：需确保models.providers中完整定义name、base_url（精确到/v1）、api_key及models数组，且agents.defaults.models中provider和model字段严格匹配定义项，最后用curl或debug日志验证接口可达性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你在AionClaw的模型列表里找不到想用的模型，不是插件没装好、也不是界面卡顿刷新问题，而是模型定义和启用两个环节至少断了一环——【定义了但没启用】或【启用了但定义不合法】，系统直接跳过加载，连报错都懒得打。
确认模型是否已正确定义在 providers 节点
打开 ~/.aionclaw/aionclaw.json（Windows为 %USERPROFILE%\.aionclaw\aionclaw.json），定位到 models.providers 区域。这里必须包含你目标模型的完整 provider 描述，至少要有四项：name（唯一标识符，如 taotoken）、base_url（精确到 /v1，例如 https://taotoken.net/api/v1）、api_key（TaoToken 控制台生成的 sk-xxx）、models 数组（每个元素含 id 和可选 alias）。缺任意一项，后续启用就成无源之水。
注意：base_url 末尾不能是 /v1/models 或 /api，否则请求会变成 /v1/models/models，返回 404；也不能漏掉 /v1，否则 OpenClaw 内部拼接后变成 /models，同样 404。
这一步操作起来很简单，直接把文件拖进去就行，但改完别急着重启——先验证定义本身是否语法合法：用 JSONLint 粘贴内容校验，避免一个逗号错误导致整个配置被忽略。
检查 agents.defaults.models 是否引用了该模型
模型定义再完整，没被 agents.defaults.models 列表点名，它就永远不会出现在 /models 命令输出里。这个节点才是真正的“上架清单”。
第一步：找到 agents.defaults.models 数组；
第二步：确认其中至少有一项的 provider 字段值与 models.providers 中某个 name 完全一致；
第三步：该项的 model 字段值，必须与对应 provider 的 models 数组中某个 id 完全一致（大小写、连字符、前缀都不能差）；
第四步：保存文件，重启 AionClaw 服务（aionclaw restart 或杀进程重开）。
常见坑：有人把 model 写成 qwen-max，但 TaoToken 文档明确要求填 qwen-max-202609；也有人把 provider 写成 tao_token，而定义里写的是 taotoken——这两个字符串不等价，引用即失效。
用 curl 验证模型接口是否真实可达
方法一：直连验证（推荐）
在终端执行：curl -X GET "https://taotoken.net/api/v1/models" -H "Authorization: Bearer sk-xxxxxxxx"，把 URL 和 Key 替换成你配置里的实际值。如果返回空数组或 "data":[]，说明 TaoToken 后台没为你开通该模型权限；如果返回 401 Unauthorized，Key 已失效或格式错误；如果返回 404 Not Found，Base URL 层级错误。
方法二：绕过 AionClaw 查日志
启动 AionClaw 时加 --log-level debug 参数，启动后立刻执行 /models，然后翻看终端输出或 ~/.aionclaw/logs/aionclaw.log，搜索 list models failed 或 http status 4xx。日志里会明确写出它到底往哪个地址发了什么请求、收到了什么响应体——这才是第一手证据，比猜强十倍。
