OpenClaw Recovery

跨平台自动备份与健康监控OpenClaw配置，崩溃时自动回滚并发送系统通知，确保服务持续稳定运行。

OpenClaw 自救系统 Skill v2.3.0

适配 OpenClaw 2026.4.x | 更新于 2026-04-10

更新日志

• v2.3.0: 跨平台自动适配（macOS/Linux/Windows）、端口动态读取、密钥脱敏、卸载脚本
• v2.2.0: 真正的健康检查（检查服务响应，不仅仅是进程存在）
• v2.1.0: 适配 OpenClaw 2026.4.x，auth 文件路径更新

跨平台支持

安装时自动检测操作系统，生成适配版本：

• macOS → cron 定时任务 + osascript 通知
• Linux → cron 定时任务 + notify-send 通知
• Windows → 提供 Task Scheduler 命令 + PowerShell 通知

自动备份配置、监控运行状态、崩溃时自动回滚恢复。

功能特性

• 智能备份: 文件变化自动备份 + 每日自动备份
• 健康监控: 每5分钟检查运行状态、磁盘空间、内存使用
• 自动回滚: 崩溃时自动恢复到最近的有效备份
• 系统通知: macOS 弹窗通知恢复状态
• 一键回滚: 手动选择备份时间点恢复
• 保底配置: 所有备份失败时使用安全模式启动
• 配置验证: 备份前自动验证 JSON 格式

安装

bash

# 运行安装脚本
bash ~/.openclaw/workspace/skills/openclaw-recovery/scripts/install-v2.sh

手动操作

bash

# 立即备份
bash ~/.openclaw/workspace/skills/openclaw-recovery/scripts/smart-backup.sh

# 手动检查并恢复
bash ~/.openclaw/workspace/skills/openclaw-recovery/scripts/recover-v2.sh

# 一键回滚（选择备份）
bash ~/.openclaw/workspace/skills/openclaw-recovery/scripts/rollback.sh

# 查看日志
cat ~/.openclaw/logs/recovery.log
cat ~/.openclaw/logs/backup.log

# 卸载
bash ~/.openclaw/workspace/skills/openclaw-recovery/scripts/uninstall.sh

文件说明

• smart-backup.sh - 智能备份（监控变化 + 定时备份）
• recover-v2.sh - 恢复脚本（含健康检查、系统通知）
• rollback.sh - 一键回滚工具
• install-v2.sh - 安装脚本
• safe-mode.json - 保底配置文件

备份策略

• 实时监控: 配置文件变化立即自动备份
• 每日备份: 每天凌晨2点自动备份
• 保留策略:
  • 最近20个备份
  • 7天历史备份（每天保留最新）
• 备份文件: openclaw.json.bak.YYYYMMDD_HHMMSS
• 备份位置: ~/.openclaw/backups/

恢复流程

1. 检测 OpenClaw 运行状态
2. 检查磁盘空间、内存使用
3. 如停止，验证配置文件有效性
4. 无效则尝试回滚（最多10个备份）
5. 所有备份失败则使用保底配置
6. 发送系统通知告知恢复结果

注意事项

• 回滚只影响系统配置（API、端口等）
• 不影响人格设定（SOUL.md）和记忆
• macOS/Linux 需要 cron（系统自带）
• Windows 需要手动设置 Task Scheduler（安装脚本会提示命令）
• fswatch 为可选，用于实时监控配置变化