AionClaw数据备份必须覆盖config.yaml、workspace/、memory/、agents/与extensions/四大核心目录，并单独验证QMD记忆数据库路径及内容，缺一不可。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
AionClaw 的数据不能靠复制安装目录来备份——它把配置、记忆、技能、模型参数四类资产分散在不同路径，漏掉任何一个，恢复后就会“失忆”或技能失效。
确认 AionClaw 实际数据根目录位置
安装包只是可执行文件，所有用户数据都存在独立的用户目录下。不同系统路径不同，且默认是隐藏的，必须手动确认，不能凭经验猜测。
- macOS：检查
~/Library/Application Support/AionClaw/（不是~/Applications或/Applications） - Linux：运行
ls -la ~/.aionclaw/，确认存在config.yaml、workspace/、memory/等子目录 - Windows：在运行框输入
%APPDATA%\AionClaw\，看是否能打开并看到agents/和credentials/ - 如果用 Homebrew 或 Snap 安装，路径可能被重定向，务必先执行
aionclaw --info（若支持）或查日志确认真实DATA_DIR
必须备份的四个核心目录及其不可替代性
只备份 config.yaml 或只打包 workspace/ 都不够。这四部分缺一不可，且各自承担不可互换的角色：
-
config.yaml：含模型路由策略、TaoToken 密钥、通讯通道（微信/企微/Telegram）绑定信息；丢失则所有外部连接中断 -
workspace/：存放SOUL.md（人格定义）、USER.md（用户习惯）、HEARTBEAT.md（定时任务），AI 的“行为逻辑”全在这里 -
memory/：按日期命名的 Markdown 文件集合，记录所有对话上下文与学习结论；删掉就等于清空长期记忆 -
agents/和extensions/：已启用的专家技能（如“周报生成器”“竞品监控器”）及其运行时状态；仅重装技能包无法恢复个性化配置
用 tar / PowerShell 打包时必须保留权限和时间戳
直接拖拽复制会丢失隐藏文件（如 .env.local）、破坏符号链接、重置文件修改时间——而 AionClaw 启动时会校验部分文件的 mtime 来判断缓存是否过期。
- macOS/Linux 终端执行：
tar -czf aionclaw_backup_$(date +%Y%m%d_%H%M%S).tar.gz -C $HOME/Library/Application\ Support/ AionClaw/ - Linux 若用
~/.aionclaw路径：tar -cpzf aionclaw_full_$(date +%Y%m%d).tar.gz ~/.aionclaw/（注意-p保权限） - Windows PowerShell：
Compress-Archive -Path "$env:APPDATA\AionClaw" -DestinationPath "$env:USERPROFILE\Desktop\aionclaw_$(Get-Date -Format 'yyyyMMdd_HHmmss').zip" - 生成后立即校验：
tar -tzf aionclaw_backup_*.tar.gz | head -n5确认列出的是目录结构而非报错
QMD 记忆数据库要单独验证路径与内容
AionClaw 默认启用 QMD（Quick Memory Database）作为记忆索引层，它的物理位置由 config.yaml 中 memory.qmd.paths 字段指定，不固定在主目录内——可能指向 /opt/qmd/ 或 ~/Documents/qmd_data/。
- 先读取配置：
grep -A3 "qmd:" ~/.aionclaw/config.yaml，确认实际路径 - 进入该路径，检查是否存在
index.db和按日期命名的*.qmd文件 - 用
sqlite3 index.db ".tables"确认表结构正常（应含mem_entries、mem_tags） - 备份时需额外执行：
cp -r /your/qmd/path ~/Desktop/aionclaw_qmd_backup_$(date +%Y%m%d)/
最常被忽略的是 QMD 路径与主目录分离这件事——很多人恢复后发现记忆“还在”，但搜索失效、标签归类错乱，问题就出在这里。备份脚本里漏掉这一行，等于只备份了记忆的“目录”，没备份“书架”。
