fullbackup 是一个专为 OpenClaw 系统设计的本地完整备份工具，通过运行内置的 backup-local.sh 脚本，能够自动创建包含工作区和配置文件的完整系统镜像。该工具主要用于应对突发故障、系统升级前的数据保护或满足用户主动请求的完整备份需求。所有生成的备份文件均存储在 /root/.openclaw/backups 目录下，确保与核心组件隔离且易于管理。
该脚本已预置安全排除规则，自动跳过缓存、日志等临时性文件，避免备份冗余数据的同时提升效率。执行完成后会输出备份文件的路径和大小信息，方便用户快速确认备份结果。值得注意的是，系统建议保留最新备份，不建议手动删除旧版本归档以防止误操作导致恢复困难。
作为 Telegram 机器人指令 /fullbackup 的底层实现方案，此工具既支持自动化触发也兼容手动调用，适用于需要高可靠性本地数据快照的场景。其轻量级设计不依赖外部服务，完全基于本地资源运行，保障了隐私性和部署灵活性。
核心功能特点
- 自动创建包含工作区与配置的完整本地备份
- 预置智能排除规则，跳过缓存和日志等非必要文件
- 输出备份文件路径及容量信息便于验证
- 支持通过 Telegram 命令 /fullbackup 触发执行
- 备份文件集中存储于独立目录防止污染主数据
- 建议保留最新备份并避免手动清理历史记录
适用场景
当 OpenClaw 系统遭遇意外崩溃或需要迁移到新环境时，fullbackup 提供的本地归档可作为关键恢复依据。例如管理员在更新系统前使用此功能保存当前状态，可在升级失败时快速回滚至稳定版本。对于频繁修改配置的用户而言，定期执行完整备份能有效防范误操作带来的不可逆损失。
此外，该工具特别适合对数据主权要求较高的场景——由于全程离线运行且不传输至第三方服务器，避免了敏感信息外泄风险。结合 Telegram 集成能力，远程运维人员也能随时发起备份指令，极大提升了分布式部署环境下的管理便利性。无论是日常维护还是应急响应，它都是保障 OpenClaw 系统连续性的重要防线。