刚下载安装完aionclaw卡在转圈界面，需完成三项关键设置：确认本地运行环境（win10/11 64位或macos，≥4gb内存，关闭chrome/edge进程）、配置taotoken模型接入通道（base url为https://taotoken.net/api，填入api key并测试连接）、初始化工作区与系统权限（指定可写路径、授予权限、启用rpa，最后启动gateway）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
刚下载安装完 AionClaw，双击打开却卡在转圈界面、日志刷屏报错、Gateway 一直显示“未就绪”，根本进不了主界面——这不是安装失败，而是首次启动前必须完成三项关键设置：本地运行环境确认、模型接入通道打通、基础权限与路径初始化，缺一不可。
确认本地运行环境是否达标
打开软件前先验证硬件和系统基础条件，否则 Gateway 启动会直接失败。
第一步：检查内存与系统版本。AionClaw 要求 Windows 10/11 64 位或 macOS 全系列（M/Intel），【最低需 4GB 可用内存，低于此值会导致 Gateway 初始化崩溃】。
第二步：确认无残留浏览器沙箱冲突。若曾以管理员身份运行过其他自动化工具，需手动关闭所有 Chrome/Edge 进程，避免端口 9222 被占用。
这一步操作起来很简单，直接按 Ctrl+Shift+Esc 打开任务管理器 → 结束所有“chrome.exe”“msedge.exe”进程即可。
配置 TaoToken 模型接入通道
没有可用的大模型通道，AionClaw 就是空壳，所有技能和数字专家都无法推理执行。
方法一：通过客户端内嵌设置页快速绑定（推荐）
启动 AionClaw → 出现登录页时暂不输入账号 → 点击右下角「跳过登录，进入设置」→ 在「模型服务」页选择「TaoToken」→ 粘贴 Base URL https://taotoken.net/api 和你从 https://taotoken.net/console/api-keys 创建的 API Key → 点击「测试连接」，看到绿色“✓ Connected”即成功。
方法二：手动修改配置文件（仅当 UI 不响应时使用）
关闭 AionClaw → 找到安装目录下的 settings.json 文件 → 定位到 "llm" 节点 → 将 "base_url" 改为 "https://taotoken.net/api"，"api_key" 填入你的 sk-xxxxxxxx 密钥 → 保存后重启软件。
【注意：API Key 只显示一次，丢失需重新在 TaoToken 控制台生成】
初始化工作区与系统权限
这一步决定后续所有文件读写、定时任务、本地 Excel 操作能否真正落地。
① 首次启动时，软件会自动弹出「本地工作区初始化向导」，默认路径为 ~/AionClaw-Workspace；如需指定其他盘符（例如 D:\AI-Work），请在此处手动修改并确保该路径存在且可写。
② 向导中勾选「授予文件系统完全访问权限」，否则后续读取本地 Word、Excel、PDF 时会提示“Permission denied”。
③ 勾选「启用桌面自动化（RPA）」，这是控制鼠标键盘、操作飞书/钉钉/浏览器的前提开关，不开启则所有“自动填表”“批量发消息”类技能全部失效。
④ 点击「完成并启动 Gateway」，等待状态栏出现绿色「安全保护中」标识，且左下角显示「Gateway: running」，此时即可关闭向导，进入登录页。
