OpenClaw故障时应优先备份并精准恢复核心目录：先压缩~/.openclaw/至桌面，再按需还原配置、记忆或技能；启用openclaw-backup Skill实现自动定时备份；每次备份后须校验完整性；敏感文件须隔离加密存储。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您发现 OpenClaw 突然无法启动、配置错乱或技能异常丢失，则很可能是核心数据目录受损或被误删。以下是恢复与高效使用备份的实操步骤：
一、立即执行全量核心目录备份
备份是所有恢复操作的前提，~/.openclaw/ 目录承载全部关键资产，包括记忆文件、技能扩展、会话历史与主配置。未备份即操作等同于无锚航行。
1、打开终端，执行压缩命令（macOS/Linux通用）：
tar -zcvf ~/Desktop/openclaw_backup_$(date +%Y%m%d).tar.gz ~/.openclaw/
2、确认压缩包生成成功：
ls -lh ~/Desktop/openclaw_backup_*.tar.gz
3、将该压缩包同步至至少两个独立位置（如本地外接硬盘 + 加密网盘），禁止仅保留在系统盘内。
二、按需恢复指定子模块
全量恢复可能覆盖近期有效修改，因此推荐精准恢复策略：依据故障现象定位受损子目录，单独还原对应内容，避免“一刀切”风险。
1、若仅 openclaw.json 报错或缺失：
cp ~/openclaw-backup/20260310/openclaw.json ~/.openclaw/
2、若记忆丢失但配置完好：
cp -r ~/openclaw-backup/20260310/workspace/memory/ ~/.openclaw/workspace/
3、若 Skills 全部失效：
rm -rf ~/.openclaw/extensions/
cp -r ~/openclaw-backup/20260310/extensions/ ~/.openclaw/
三、启用自动定时备份机制
手动备份易遗漏、难持续，必须通过自动化工具建立防御性习惯。openclaw-backup Skill 是唯一经实战验证的原生方案，它不依赖外部调度器，直接嵌入 OpenClaw 生命周期。
1、访问 ClawHub 搜索 openclaw-backup，切勿使用 openclaw install 命令直接安装，须按 Skill 页面说明手动注入配置项。
OpenClaw 基础设施心跳监控与自动恢复：部署/卸载心跳守护进程，配置主机监控（Gateway、磁盘、内存、CPU、进程），设置飞书告警，自动重启故障Gateway。适用关键词：心跳监控、heartbeat daemon、服务器告警、自动重启、健康检查、auto recovery。
2、编辑 ~/.openclaw/openclaw.json，在 "skills" 数组中添加：
{"name": "openclaw-backup", "config": {"interval_hours": 24, "backup_dir": "/path/to/your/backup/folder"}}
3、重启网关使配置生效：
openclaw gatewaystop && openclaw gatewaystart
四、验证备份有效性
未验证的备份等于不存在。每次新备份生成后，必须执行结构校验与最小功能测试，确保压缩包可解压、关键文件可读、路径无权限阻断。
1、新建临时目录并解压最新备份：
mkdir /tmp/oc_test && tar -zxvf ~/Desktop/openclaw_backup_*.tar.gz -C /tmp/oc_test
2、检查核心文件是否存在且非空：
test -s /tmp/oc_test/.openclaw/openclaw.json && echo "配置文件完整" || echo "配置文件损坏"
3、比对 workspace/memory/ 下最近三条记忆条目时间戳与当前系统时间差是否在合理范围内（≤48小时）。
五、隔离敏感数据备份路径
openclaw.json 与身份认证文件（如 tokens.json、oauth_state.json）含 API 密钥等高危信息，不可与普通备份混存。必须实施物理/逻辑隔离策略，防止泄露面扩大。
1、创建专用加密目录：
mkdir -m 700 ~/.openclaw-secrets-backup
2、仅同步敏感项：
cp ~/.openclaw/openclaw.json ~/.openclaw-secrets-backup/
cp ~/.openclaw/.auth/* ~/.openclaw-secrets-backup/ 2>/dev/null || true
3、对该目录启用文件级加密（如 macOS FileVault 或 Linux eCryptfs），严禁以明文形式上传至任何云存储。
