必须手动删除旧版残留配置并重置权限才能解决启动卡顿问题：先清除AppData或Library中的AionClaw目录，再以管理员身份运行或解除Mac签名校验，最后执行--reset-init命令触发全新初始化。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
新版本AionClaw安装后启动卡在初始化阶段，界面长时间显示“正在配置环境”或直接报错退出，说明本地运行链路在权限、依赖或残留数据层面出现阻断，必须针对性清除干扰项才能继续。
确认是否为残留旧版冲突
打开文件资源管理器（Windows）或访达（Mac），进入AionClaw默认工作目录：【C:\Users\用户名\AppData\Roaming\AionClaw】（Windows）或【~/Library/Application Support/AionClaw】（Mac）。检查该目录下是否存在 config.json、cache/、models/ 等子目录。若存在且创建时间早于新版本安装时间，说明旧版配置未被自动清理。
手动删除整个 AionClaw 文件夹——这一步不可跳过，新版本初始化会读取旧配置并尝试复用，但结构已不兼容，导致健康检查失败。
重置系统级运行权限
方法一：Windows 用户右键点击 AionClaw 安装程序 → 选择“以管理员身份运行”，启动后等待弹窗提示“请求系统级操作权限”，勾选“始终允许此应用进行更改”并确认。
方法二：Mac 用户首次启动时若弹出“无法验证开发者”警告，先前往「系统设置 → 隐私与安全性」，在底部找到“已阻止使用……”提示，点击“仍要打开”。随后在终端执行：xattr -d com.apple.quarantine /Applications/AionClaw.app，否则签名校验会中断初始化流程。
注意：Mac M系列芯片设备还需额外验证 Rosetta 兼容性。若启动后立即崩溃，在“应用程序”中右键 AionClaw → “显示简介” → 勾选“使用 Rosetta 打开”，再重启。
强制触发全新初始化流程
第一步：彻底关闭所有 AionClaw 进程。Windows 按 Ctrl+Shift+Esc 打开任务管理器 → 结束所有名为 AionClaw 或 openclaw 的进程；Mac 打开活动监视器 → 搜索并强制退出对应进程。
第二步：在命令行工具中执行初始化重置指令。Windows 用户打开 PowerShell（无需管理员权限），输入：cd "$env:LOCALAPPDATA\Programs\AionClaw" ; .\aionclaw.exe --reset-init；Mac 用户打开终端，输入：/Applications/AionClaw.app/Contents/MacOS/AionClaw --reset-init。
第三步：等待终端输出 Initialization reset completed. Launching clean setup... 后，直接双击桌面快捷方式启动，此时将进入全新向导流程，不再加载任何旧版缓存或插件状态。
