AionClaw提示“版本不兼容”90%是安装包与系统架构或OS版本不匹配；需确认芯片类型（M系列选arm64，Intel选x64）、系统≥macOS 13或Windows 10 21H2，并校验签名与SHA256完整性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
直接结论：AionClaw 提示“版本不兼容”，90% 是安装包与当前系统架构或 OS 版本不匹配，不是软件本身坏了，也不是需要重装系统。
确认安装包是否匹配你的 macOS/Windows 架构
macOS 用户最容易踩的坑是下载了 Apple Silicon（arm64）包却装在 Intel（x86_64）设备上，或反过来。Windows 用户则常误选了 ARM64 版本（如 Surface Pro X），而实际是 x64 CPU。
- macOS：打开「关于本机」→「芯片」，显示「M1/M2/M3」就选
AionClaw-macOS-arm64.dmg；显示「Intel」就选AionClaw-macOS-x64.dmg - Windows：右键「此电脑」→「属性」→ 查看「系统类型」，明确写「基于 x64 的处理器」才用
AionClaw-win-x64.exe；若写「ARM64」，必须用对应 ARM 包，不能强行运行 x64 版 - 别信文件名里的“通用”“全平台”字样——AionClaw 官方目前未发布真正跨架构二进制，所有“通用”描述都指向 Electron + 自动更新机制，而非单个安装包兼容多架构
检查系统最低版本要求是否满足
AionClaw 2.0.0 起已放弃对 macOS 12（Monterey）及以下、Windows 10 21H1 以下版本的支持。报错时如果弹窗含 dyld: Library not loaded（macOS）或 MSVCP140.dll 丢失（Windows），基本可锁定为系统过旧。
- macOS 用户：必须 ≥ 13.0（Ventura），升级前先确认设备支持——M1 及更新机型均支持 Ventura，但部分 2017 款 MacBook Pro 需手动启用“允许安装不兼容更新”选项
- Windows 用户：需 ≥ Windows 10 21H2 或 Windows 11 21H2 起，且 .NET Desktop Runtime 6.0 或 8.0 必须已安装（官网下载页提供独立安装包链接）
- 不要尝试用兼容模式运行——Electron 22+ 已移除对旧版 Windows 兼容层的支持，强行启用只会触发更隐蔽的
failed to load app错误
验证安装包完整性与签名状态
国内网络环境下，下载中断或 CDN 缓存污染会导致安装包损坏，表现为“无法打开”“已损坏”“开发者无法验证”等提示，本质是签名失效或二进制截断。
- macOS：终端执行
xattr -l /Applications/AionClaw.app，若无com.apple.quarantine或输出为空，说明签名未正确附着；用spctl --assess --type execute /Applications/AionClaw.app检查评估结果是否为accepted - Windows：右键安装包 →「属性」→「数字签名」→ 点击签名查看「颁发给」是否为
Hangzhou Quyuan Artificial Intelligence Co., Ltd.；若显示「未知发布者」或「此文件没有数字签名」，请删除并从官网https://aionclaw.com/download重新下载 - 校验和比对：官网下载页底部提供 SHA256 值，Windows 用户可用
certutil -hashfile AionClaw-win-x64.exe SHA256，macOS 用户用shasum -a 256 AionClaw-macOS-arm64.dmg
真正容易被忽略的是：AionClaw 的「版本兼容性」判断不仅发生在安装阶段，首次启动时还会检测本地 ~/.aionclaw/config.json 中记录的上一版运行环境参数。如果曾用旧版生成过配置，又跳过卸载直接覆盖安装，残留字段可能触发静默降级保护，导致界面卡在加载页——此时删掉该 config 文件再启动，比重装更有效。
