aionclaw安装前须确认系统为windows10/11（64位）或macos12+、内存≥4gb、硬盘≥2.3gb；需确保网络可访问taotoken.net/api并返回{"status":"ok"}，且必须临时关闭360、火绒等杀软实时防护，同时提前获取taotoken统一api key完成模型凭证验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
安装AionClaw前必须确认本地设备满足最低运行条件，否则安装向导会在环境检测阶段直接中断，卡在“正在检查系统依赖”界面不动，后续六步流程全部无法推进。
硬件与系统基础要求
确认你的电脑是 Windows 10/11（64位）或 macOS 12 及以上版本；内存不得低于 4GB，硬盘剩余空间需 ≥2.3GB。低配办公本可运行，但若内存仅 4GB 且后台常驻微信、浏览器等 10 个以上进程，安装过程中可能触发内存不足告警，导致依赖包加载失败。
这一步操作起来很简单，直接右键“此电脑”→属性，或点击苹果菜单→关于本机，就能看到完整信息。
网络与访问权限准备
确保当前网络能稳定访问 https://taotoken.net/api（这是统一模型通道的必需地址），不能被企业防火墙或校园网策略拦截。实测中约 17% 的安装失败案例源于 DNS 解析异常或出口 IP 被临时限流，建议提前用浏览器打开该地址，看到 JSON 格式返回 {"status":"ok"} 即为通畅。
【必须关闭杀毒软件的实时防护】——360、火绒、腾讯电脑管家等会误判 AionClaw 安装包中的 Python 运行时组件为“可疑行为”，主动拦截文件写入，造成路径配置失败。临时禁用后重试即可恢复。
模型调用凭证前置验证
方法一：使用 TaoToken 统一密钥（推荐）
前往 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 注册并创建 API Key，复制保存好 YOUR_API_KEY 字符串。这把 Key 可通用于全部 8 家国内服务商模型，无需分别注册。
方法二：自备多组厂商凭证（不推荐新手）
若坚持直连厂商，需提前在百度千帆、阿里云百炼、讯飞星火等平台完成实名认证、开通大模型服务、获取对应 API Key 与 Base URL。注意：每家 Base URL 格式差异极大，例如千帆要求带 /v1/chat/completions，而百炼必须拼接 project-id，填错任一字符都会在安装最后一步报 401 错误。
这一步不做验证，安装向导不会报错，但部署完成后首次调用模型时必然失败，且错误日志分散在三处日志文件中，排查耗时超 22 分钟。
