必须同时备份配置目录与workspace工作区,因AionClaw的AI人格、技能逻辑和对话记忆均存储于隐藏路径中;需先用openclaw status确认真实数据根路径,再执行全量或选择性备份,并对敏感文件AES-256加密后异地存放。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要防止AionClaw重装系统或换电脑后丢失所有AI人格、技能调用逻辑和对话记忆,必须同时备份配置目录与workspace工作区——只复制安装包或桌面快捷方式毫无意义,那些只是启动器,真正的“大脑”和“履历”全藏在隐藏路径里。
确认AionClaw实际数据根路径
不同系统默认路径不同,且用户可能自定义过。先验证真实路径,避免备份空目录:
macOS执行:openclaw status | grep -E "(State|Workspace)"
Windows PowerShell执行:openclaw status | Select-String "State|Workspace"
Linux终端执行同macOS命令。
若输出中出现OPENCLAW_STATE_DIR变量值,以该路径为准;否则默认为~/.openclaw/(macOS/Linux)或$env:APPDATA\.openclaw(Windows)。
这一步跳过会导致后续所有备份失效,因为AionClaw 2.0.0已支持多workspace切换,【默认路径可能已被覆盖】。
全量打包:一劳永逸的物理快照
适用于系统重装、设备迁移或紧急封存场景,保留权限、隐藏文件、未提交的调试状态等全部细节。
macOS/Linux终端中,进入上一级目录后执行:tar -czvf aionclaw-full-$(date +%Y%m%d_%H%M%S).tar.gz -C ~ .openclaw/
Windows PowerShell中,先定位后压缩:
Set-Location "$env:APPDATA"<br>Compress-Archive -Path ".openclaw" -DestinationPath "$env:USERPROFILE\Desktop\aionclaw-full-$(Get-Date -Format 'yyyyMMdd_HHmmss').zip"
生成后立即校验:
macOS/Linux运行ls -lh aionclaw-full-*.tar.gz,确认大小非零;
Windows双击ZIP查看是否含openclaw.json、workspace/、credentials/三个核心项。
选择性备份:仅同步AI的“人格”与“记忆”
当你只想Git管理、人工审核或快速复位AI行为逻辑时,跳过会话状态、渠道登录态等临时数据,体积更小、可读性更强。
第一步:创建干净备份目录mkdir -p ~/aionclaw-selective-backup
第二步:精准提取四大核心资产
复制workspace全部内容:cp -r ~/.openclaw/workspace ~/aionclaw-selective-backup/
导出主配置并格式化:jq '.' ~/.openclaw/openclaw.json > ~/aionclaw-selective-backup/openclaw_config.json
单独打包凭证(含飞书AppSecret、公众号Token等):tar -czvf ~/aionclaw-selective-backup/credentials.tar.gz -C ~/.openclaw credentials/
提取SOUL.md与MEMORY.md(若存在):cp ~/.openclaw/workspace/SOUL.md ~/.openclaw/workspace/MEMORY.md ~/aionclaw-selective-backup/ 2>/dev/null
注意:【不要复制logs/、node_modules/、.DS_Store】,这些既无业务价值又易污染Git仓库。
加密与异地存放
凭证和记忆文件含敏感信息,明文存放风险极高。
用AES-256加密主配置:openssl enc -aes-256-cbc -salt -in ~/aionclaw-selective-backup/openclaw_config.json -out ~/aionclaw-selective-backup/openclaw_config.json.enc -k你的高强度主密码
加密后立刻删除原始明文:rm ~/aionclaw-selective-backup/openclaw_config.json
最终将备份包复制到两个物理隔离位置:外接SSD + 加密云盘(如腾讯云COS启用KMS密钥的桶),任一位置损坏都不影响恢复。


















