首次启动AionClaw需手动配置API Key，否则报“connection refused”或“invalid api key”；须登录TaoToken控制台生成sk-开头32位密钥，核对config.toml中base_url、api_key、model_id三项无误，并通过脚本、curl或日志验证生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
首次启动AionClaw时，必须手动填写自己的API Key才能完成初始化，否则服务会卡在加载阶段并持续报错“connection refused”或“invalid api key”，整个智能体无法进入可交互状态。
确认TaoToken统一API通道已就绪
打开浏览器访问 https://www.php.cn/link/ecd058faafa18f55f81d730b142f8fd3，登录后检查左侧菜单是否显示「API Keys」和「Models」两个入口。如果看不到，说明账号未激活或权限不足，需联系管理员开通企业级API访问权限。
点击「API Keys」→「新建密钥」，生成后立即复制整串以【sk-开头的32位密钥】并粘贴到记事本中——该密钥仅显示一次，关闭页面即不可再查。
接着点开「Models」页面，确认你要用的模型（如 qwen2.5-72b、claude-4-haiku）状态为「可用」且未标灰。若显示「配额耗尽」或「未授权」，即使Key正确也会在AionClaw启动时返回 403 错误。
校验AionClaw配置文件中的三项核心参数
进入AionClaw安装目录下的config.toml文件，用VS Code或记事本打开，逐行核对以下三处是否填写完整且无空格、换行、中文引号：
① base_url = "https://taotoken.net/api"—— 注意结尾不能带斜杠，也不能加任何查询参数（如?v=1），否则请求会 404；
② api_key = "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"—— 必须与控制台复制的密钥完全一致，大小写敏感，前后不能有空格；
③ model_id = "qwen2.5-72b"—— 必须与「Models」页显示的模型ID一字不差，大小写、连字符、数字均不可改动。
验证配置是否生效
方法一：运行内置连通性检测脚本
在AionClaw安装目录下执行：./scripts/test_api.sh 或 Windows 下双击 test_api.bat。脚本会尝试发起一次真实请求，并输出 HTTP 状态码与响应体。
方法二：手动curl验证（适合调试）
终端中执行：curl -X POST https://taotoken.net/api/chat/completions -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json" -d '{"model":"qwen2.5-72b","messages":[{"role":"user","content":"hi"}]}'
注意：curl命令中必须使用你自己的sk-密钥和model_id，否则返回401或404。
方法三：检查backend.log日志
启动AionClaw后，打开 logs/backend.log，滚动到底部查找三行连续的INFO日志：【LLM provider initialized】、【Model qwen2.5-72b is ready】、【Backend service started on :8080】。三者全部存在，才表示配置真正就绪。
