认证失败需逐层排查：一查TaoToken控制台Key状态是否Active；二查AionClaw中Base URL是否为https://taotoken.net/api（不可多斜杠或路径）；三查请求头是否被自定义覆盖，确保Authorization格式正确；四用curl直连验证Key与URL；五查AionClaw debug日志确认实际发送的Authorization头内容。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在AionClaw中配置模型后点击“测试连接”或执行任务时弹出「认证失败」提示，说明请求已发出但TaoToken网关拒绝了鉴权，不是网络不通、也不是模型不存在——而是凭证本身未被识别。这个问题必须从请求源头逐层验证，不能只改AionClaw界面里的字段。
第一步：确认TaoToken控制台Key状态是否有效
打开 https://www.php.cn/link/5dec1dd9c7ca4454ec07671f1bc8f941 → 登录后进入「API Keys」页面 → 找到你填进AionClaw的那个Key → 检查右侧状态栏是否为【Active】。如果显示「Revoked」或「Expired」，立刻点击右侧「Regenerate」生成新Key，并复制新Key值。旧Key一旦失效，所有已配置的智能体都会持续报401，且不会提示具体原因。
第二步：检查AionClaw中Base URL格式是否多加了斜杠或路径
进入AionClaw设置 → 模型配置 → Base URL栏必须严格填写为：https://taotoken.net/api。常见错误是填成 https://taotoken.net/api/v1、https://taotoken.net/api/（末尾多斜杠）、或直接粘贴了带?model=gpt-4o参数的完整URL。TaoToken的OpenAI兼容接口只接受根路径/api，任何额外路径或查询参数都会导致401响应。
第三步：验证请求头是否被AionClaw自动覆盖
AionClaw 2.3.7及以上版本默认启用「自动注入鉴权头」功能，它会强制在请求中添加Authorization: Bearer <key>。但如果你在「高级设置」里手动勾选了「自定义请求头」，又没写对格式，就会覆盖掉这个默认头。此时需确认：① 不勾选「自定义请求头」；② 或者勾选后，在文本框中只写一行：Authorization: Bearer your_actual_api_key_here（注意Bearer和Key之间有空格，且Key必须是纯字符串，不带引号）。【切勿写成 Authorization: "Bearer xxx" 或 Authorization: 'Bearer xxx'】。
第四步：用curl绕过AionClaw直连验证
打开终端，执行以下命令（把your_api_key_here替换成你控制台复制的真实Key）：
curl -X POST https://taotoken.net/api/chat/completions \-H "Content-Type: application/json" \-H "Authorization: Bearer your_api_key_here" \-d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "hi"}]}'
如果返回JSON含"id"字段，说明Key和URL完全正确，问题出在AionClaw自身配置或缓存；如果返回{"error": {"message": "Unauthorized", ...}}，说明Key无效或URL错位，回到前两步重检。
第五步：检查AionClaw日志中的原始请求细节
启动AionClaw时加--log-level debug参数（Windows双击快捷方式属性→目标栏末尾追加；macOS在终端用open -n -a AionClaw --args --log-level debug），触发一次失败调用 → 查看日志文件logs/aionclaw.log → 搜索req.header → 找到实际发出的Authorization头内容。如果这里显示的是Bearer null或Bearer undefined，说明AionClaw根本没读取到你填的Key，需检查配置项是否位于「当前启用的模型配置组」中，而不是被折叠在未激活的Tab页里。
