必须在新版本上线前固化完整快照，否则无法回退；需确认工作区路径、校验三个MD文件及memory/skills目录，再执行带时间戳的tar全量备份并校验，最后上传至离线存储。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
网站发布后想随时退回旧版，必须在新版本上线前就固化当前可运行的完整快照，否则一旦覆盖就无法还原。
确认当前工作区路径并校验完整性
打开终端，执行 cat /home/admin/.openclaw/openclaw.json | grep workspace，确认实际工作区路径是否为默认的 /home/admin/.openclaw/workspace。若返回为空或路径不同，【必须按实际路径操作，否则备份将遗漏核心数据】。
运行 ls -la /home/admin/.openclaw/workspace/，检查是否存在 IDENTITY.md、SOUL.md、AGENTS.md 三个关键定义文件，以及 memory/ 和 skills/ 目录。任一缺失即表示当前状态异常，不可直接备份。
执行本地全量打包备份
进入 home 目录：cd /home/admin。
执行压缩命令：tar -zcvf aionclaw-workspace-$(date +%Y%m%d-%H%M%S).tar.gz -C /home/admin/.openclaw/ workspace。该命令会生成带时间戳的压缩包，避免覆盖误删。
压缩完成后立即校验：tar -tzf aionclaw-workspace-$(date +%Y%m%d-%H%M%S).tar.gz | head -n 5，确保能看到 workspace/IDENTITY.md 等关键路径。若报错或无输出，说明打包失败，需重试。
上传备份至离线存储介质
方法一：通过 Workbench 上传至本地电脑（限单个文件＜1200MB）
在轻量应用服务器控制台 → 远程连接 → Workbench 登录 → 点击右上角「下载」图标，选择刚生成的 .tar.gz 文件保存到本地桌面。
方法二：超大包用 scp 传输（推荐）
在你自己的电脑终端中执行：scp admin@your-server-ip:/home/admin/aionclaw-workspace-*.tar.gz ./，输入密码后自动拉取。这一步绕过 Workbench 限制，且传输过程可断点续传。
【严禁仅保留在服务器 /home/admin 目录下——重置系统时该目录会被清空】
发布新版本并验证回退路径
第一步：停用 AionClaw 服务systemctl stop aionclaw-gateway，防止备份期间写入新记忆导致不一致。
第二步：部署新网站代码
将新版静态资源拷贝至 Nginx 的 root 目录（如 /usr/share/nginx/html），执行 nginx -t && systemctl reload nginx。
第三步：触发一次最小化测试任务
在飞书或微信中发送“生成本周周报草稿”，确认新版本 AI 仍能正常调用技能、读取历史记忆。若失败，立即执行下一步。
第四步：回退验证（仅当新版本异常时启动）
执行 systemctl stop aionclaw-gateway → 删除当前 workspace 目录 → 解压备份包：tar -zxvf aionclaw-workspace-20261012-*.tar.gz -C /home/admin/.openclaw/ → 启动服务：systemctl start aionclaw-gateway。
