必须备份~/.openclaw/及自定义workspace路径下的openclaw.json、.credentials、.sessions、workspace/identity.md等核心文件，先停用gateway服务再压缩归档，最后验证包大小、目录结构和文件时间戳一致性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要确保重装系统、迁移设备或升级AionClaw版本后不丢失AI助理的身份设定、对话记忆、已装技能和模型偏好，必须对分散在多个路径下的个人配置数据执行精准备份，不能只复制安装目录或随意打包整个用户文件夹。
确认核心配置路径
打开终端（macOS/Linux）或 PowerShell（Windows），运行以下命令获取真实路径：
openclaw status | grep -E "(State|Workspace)"
若输出中显示 OPENCLAW_STATE_DIR 变量，则以该路径为准；否则默认状态目录为 ~/.openclaw/，工作区目录为 ~/.openclaw/workspace/。这两处是备份主干，缺一不可。
特别注意：workspace 路径可能被自定义。验证方式为执行 cat ~/.openclaw/openclaw.json | jq '.workspace' 2>/dev/null，若返回 null，则按默认路径处理。
停止服务并排除干扰项
在旧设备上执行：openclaw gateway stop。
这一步不可跳过——若网关仍在运行，.sessions 和 .credentials 目录下的会话令牌与临时密钥可能处于写入状态，直接打包会导致校验失败或恢复后登录异常。
验证是否停止成功：openclaw status | grep Gateway，应返回空行或显示 “inactive”。
可选但推荐：执行 rm -rf ~/.openclaw/logs/*.log 清空日志，避免归档体积膨胀且无业务价值。
执行全量备份操作
方法一：Linux/macOS 系统（保留权限与符号链接）
cd ~/.openclaw/.. && tar -czvf aionclaw-full-backup-$(date +%Y%m%d_%H%M%S).tar.gz \
--exclude='.DS_Store' \
--exclude='node_modules' \
--exclude='logs' \
.openclaw/
方法二：Windows 系统（PowerShell 原生命令）
Set-Location "$env:APPDATA" && Compress-Archive -Path ".openclaw" -DestinationPath "$env:USERPROFILE\Desktop\aionclaw-backup-$(Get-Date -Format 'yyyyMMdd_HHmmss').zip"
【注意】Windows 用户务必确认 %APPDATA% 下存在 .openclaw 文件夹，而非 CodeBuddy 或 Clawdbot 等同名目录——AionClaw 默认使用此路径，但部分早期测试版曾写入 %LOCALAPPDATA%。
验证备份完整性
第一步：检查压缩包是否非空
Linux/macOS 执行 ls -lh aionclaw-full-backup-*.tar.gz，大小应 ≥50KB；Windows 在桌面双击 ZIP 文件，确认能展开 .openclaw/ 目录树。
第二步：抽样核对关键文件是否存在
解压后进入 .openclaw/ 目录，必须包含：openclaw.json、.credentials/、.sessions/、workspace/IDENTITY.md、workspace/SOUL.md、workspace/memory/、workspace/skills/。
第三步：快速比对 workspace 内容一致性
在旧设备执行 find ~/.openclaw/workspace -type f | head -n 5 | xargs ls -l，记录时间戳；在解压后的备份中执行相同命令，两组输出应完全一致。
