OpenClaw Backup

备份与恢复 OpenClaw 数据。适用于创建备份、设置自动备份计划、从备份恢复或管理备份轮转。处理 ~/.openclaw 目录归档并包含适当的排除规则。

安装

概览

OpenClaw Backup 是一个专为 OpenClaw 应用设计的本地数据备份与恢复工具,旨在保护用户的配置、凭证和工作环境。它通过自动化脚本和灵活的调度机制,确保关键数据在本地安全存储,并支持快速还原。该工具默认将备份归档至用户主目录下的 `~/openclaw-backups/` 文件夹,并以时间戳命名文件(如 `openclaw-2025-04-05_1430.tar.gz`),便于版本管理。

备份内容覆盖 OpenClaw 运行所需的核心组件,包括主配置文件 `openclaw.json`、API 密钥与认证信息所在的 `credentials/` 目录、智能体(agent)的配置及身份资料、工作区中的记忆数据、SOUL.md 文件以及用户上传或生成的文件。此外,Telegram 会话状态和定时任务配置也被纳入保护范围。为减少冗余并提升效率,系统自动排除日志文件和缓存目录(如 `completions/` 和所有 `.log` 文件),避免重复备份无意义的数据。

除了手动执行外,OpenClaw Backup 支持通过 Cron 实现每日自动备份,例如设定每天凌晨 3 点触发备份任务,并在完成后向用户发送通知。同时,脚本内置轮转策略,仅保留最近七份备份,既节省磁盘空间又防止历史版本过多造成混乱。一旦发生意外丢失或误操作,用户可通过简单命令快速恢复整个运行环境,无需重新配置或重新登录第三方服务。

核心功能特点

  1. 自动创建带时间戳的压缩备份包,默认保存于 ~/openclaw-backups/
  2. 完整覆盖配置文件、API 凭证、智能体设置、工作区数据及 Telegram 会话
  3. 内置备份轮转机制,自动清理超过7天的旧备份以控制存储空间
  4. 支持通过 Cron 定时触发每日备份任务并推送结果通知
  5. 提供一键式快速恢复流程,无需复杂配置即可还原整个 OpenClaw 环境

适用场景

OpenClaw Backup 特别适合需要长期稳定运行 OpenClaw 并重视数据安全性的个人开发者或小型团队。对于频繁使用 AI 代理进行创作、研究或自动化任务的场景,一旦原始数据损坏或误删,可能导致数小时甚至数天的工作成果丢失。此时,定期备份能极大降低风险。例如,当用户更新了多个智能体的提示词或自定义了复杂的工作流时,一份可靠的备份可在系统崩溃后迅速还原全部上下文。

此外,该工具也适用于希望在不同设备间迁移 OpenClaw 配置的场合。虽然官方未直接支持跨机器同步,但借助备份文件,用户可以轻松将一台设备上的个性化设置、已授权的 API 密钥和重要文档复制到另一台设备上,实现无缝切换。尤其适合远程工作者或经常更换办公环境的用户,确保其数字工作空间的一致性与连续性。

对于依赖自动化流程的用户而言,结合 Cron 设置每日自动备份尤为实用。无论是夜间批处理任务还是持续运行的代理会话,定时备份都能在不干扰日常操作的前提下提供“后悔药”——即使某次更新引发问题,也能回滚到前一日正常状态,保障业务连续性。整体来看,OpenClaw Backup 是一款轻量但功能完备的数据守护工具,填补了 OpenClaw 生态中本地数据保护的关键空白。