必须结构化备份配置、技能、记忆及模型参数以保留AI行为逻辑与历史状态，涵盖全量压缩、选择性导出、模型专项备份、定时自动化及跨平台验证五步流程。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在使用OpenClaw并希望在设备更换、系统重装或团队协作场景下保留全部AI行为逻辑与历史状态，则必须对分散存储的配置、技能、记忆及模型连接参数进行结构化备份与精准迁移。以下是覆盖全路径、多环境、高兼容性的操作流程：
一、全量目录压缩备份
该方法保留完整的目录结构、文件权限与隐藏配置，适用于灾难恢复、跨设备封存或版本冻结前的最终快照，确保所有组件（含未显式识别的扩展依赖）零遗漏归档。
1、打开终端（macOS/Linux）或PowerShell（Windows），执行压缩命令：
macOS/Linux：
tar -zcvf ~/Desktop/openclaw_full_backup_$(date +%Y%m%d_%H%M%S).tar.gz ~/.openclaw/
Windows PowerShell：
Compress-Archive -Path "$env:USERPROFILE\.openclaw" -DestinationPath "openclaw_backup_$(Get-Date -Format 'yyyyMMdd_HHmmss').zip"
2、验证压缩包完整性，确认其非空且包含预期层级：
ls -lh ~/Desktop/openclaw_full_backup_*.tar.gz
3、将生成的压缩包立即复制至至少两个物理隔离位置，例如外接固态硬盘 + 企业级加密云盘，严禁仅保留在系统盘内。
二、关键配置选择性导出
该方法聚焦于高价值、低体积的核心资产，规避日志、缓存与临时文件等冗余内容，便于人工校验、Git版本管理或敏感字段脱敏处理，特别适合生产环境合规审计与快速重建。
1、安全导出主配置文件并格式化可读结构：
jq '.' ~/.openclaw/openclaw.json > openclaw_config_$(date +%Y%m%d).json
2、单独导出凭证目录（如飞书App Secret、公众号Token等）：
tar -czvf openclaw_credentials_$(date +%Y%m%d).tar.gz -C ~/.openclaw credentials/
3、对导出的明文配置文件执行AES-256加密：
openssl enc -aes-256-cbc -salt -in openclaw_config_$(date +%Y%m%d).json -out openclaw_config_$(date +%Y%m%d).json.enc -k 您的高强度主密码
4、删除原始明文文件，仅保留加密副本：
rm openclaw_config_$(date +%Y%m%d).json
三、模型关联配置专项备份
针对Qwen3-4B、QwQ-32B、GLM-4.7-Flash或百川2-13B-4bits等不同后端模型，其连接参数、量化路径与本地缓存位置各不相同，需按模型特性分离处理，避免因路径硬编码或权限错位导致加载失败。
1、提取openclaw.json中models.providers段落，单独保存为model_endpoint.json：
jq '.models.providers' ~/.openclaw/openclaw.json > model_endpoint.json
2、若使用vLLM本地服务，备份其启动脚本与端口配置文件（如start_vllm.sh、vllm_config.yaml）：
cp ~/vllm_config.yaml ./backup/ && cp ~/start_vllm.sh ./backup/
3、对于百川2-13B-4bits等量化模型，同步其缓存目录（注意保留原属主权限）：
rsync -avzP ~/.cache/clawd/models/baichuan2-13b-chat-4bits/ ./backup/models/baichuan2-13b-chat-4bits/
4、执行权限修复，防止迁移后因UID/GID不一致导致拒绝访问：
sudo chown -R $(whoami) ./backup/models/
四、自动化定时备份（cron/systemd方案）
通过系统级调度器实现无人值守备份，确保每日配置变更被持续捕获，适用于长期稳定运行的开发节点或轻量级生产环境，消除人为遗忘风险。
1、编辑当前用户crontab：
crontab -e
2、添加以下行（每日凌晨2:15执行精简备份）：
15 2 * * * tar -czvf ~/openclaw_backup/$(date +\%Y\%m\%d)_config.tar.gz -C ~/.openclaw openclaw.json workspace/ credentials/ models/providers/ >/dev/null 2>&1
3、验证cron是否生效，并检查最近一次备份时间戳：
ls -lt ~/openclaw_backup/ | head -n 5
4、为增强可靠性，额外配置systemd timer作为备用通道，避免cron服务异常时备份中断。
五、跨平台迁移验证步骤
完成备份后，在目标设备上执行还原操作前，必须严格验证环境一致性与路径映射正确性，否则将引发技能加载失败、记忆丢失或模型连接超时等不可逆故障。
1、在新设备安装与源环境完全一致版本号的OpenClaw（如v2026.3.31），禁止使用beta或nightly构建版；
2、安装完成后，先不启动服务，直接定位新工作区路径：
Windows：C:\Users\[用户名]\.openclaw\workspace\
macOS：~/.openclaw/workspace/
Linux：~/.openclaw/workspace/
3、将备份的workspace/目录完整覆盖至新路径，禁止解压至子目录或重命名父文件夹；
4、手动比对openclaw.json中baseUrl、apiKey引用方式是否与新环境匹配（如旧环境用http://localhost:8000，新环境改用https://api.example.com）；
5、启动OpenClaw后，立即执行诊断命令验证核心组件连通性：
openclaw doctor AI写代码bash
