恢复AionClaw本地备份前必须确认版本兼容，否则将导致数据结构错位、记忆加载失败或技能丢失；需通过backup_meta.json或config.json反推备份版本，用图形界面或npm run version获取当前版本，再按主版本一致、次版本差值≤3、Schema匹配三阶比对确保安全。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
恢复AionClaw本地备份前必须确认当前运行版本与备份生成时的版本兼容，否则可能触发数据结构错位、记忆模块加载失败或技能配置丢失等不可逆损坏。备份文件本身不携带版本签名，仅依赖AionClaw启动时对memory.db、skills/目录结构和config.json字段的校验逻辑，一旦版本跨度过大（如从v1.8.3直接恢复至v2.0.5），程序会在首次读取备份时静默清空部分关键表，且无二次确认。
确认备份生成版本号
打开备份压缩包，进入根目录下的backup_meta.json文件（若不存在则该备份为v1.7.x及更早版本生成）→ 查看"aionclaw_version"字段值，例如"2026.7.15"或"v1.9.2"。
若压缩包内无backup_meta.json，需检查config.json中"build_timestamp"字段，结合AionClaw历史发布日志反推版本区间——2026年6月29日前发布的备份大概率对应v1.8.x系列，2026年8月31日后生成的备份基本为v2.0+格式。
核对当前运行环境版本
方法一：图形界面查看
启动AionClaw → 点击左下角齿轮图标 → 选择「关于」→ 记录显示的完整版本字符串，注意区分v2.0.0-beta与v2.0.0（后者为正式构建，前者不兼容v2.0+备份）。
方法二：命令行验证
在安装目录终端执行：npm run version → 输出结果中第一行为应用版本，第二行为Electron底层版本，【Electron版本必须≥29.4.0才支持v2.0+备份的AES256密钥轮换机制】。
执行三阶兼容性比对
第一步：判断主版本是否一致
提取备份版本号中的主干（如2026.7.15→2026，v1.9.2→v1，v2.0.0→v2），当前版本主干必须与备份主干相同；【v1.x备份不可用于v2.x环境，反之亦然】。
第二步：检查次版本跨度
若主干同为v2，计算当前版本与备份版本的次版本差值（如备份v2.0.1，当前v2.0.5，差值为4），差值≤3可安全恢复；差值≥4需先降级至中间版本再逐级升级备份。
第三步：验证功能层适配项
打开当前AionClaw的「设置→高级→诊断」页面 → 检查「记忆数据库格式」是否显示v2.1或legacy；若备份生成于OpenClaw 2.0正式版（2026年8月31日）之后，而当前显示legacy，说明尚未完成Schema迁移，必须先执行aionclaw migrate --force命令再恢复。
