gitbackup

创建 OpenClaw 工作区仓库的本地 Git bundle 备份。适用于在 Telegram 中运行 /gitbackup 或用户要求将 Git 历史/引用备份到本地文件时使用。

安装

概览

Git Backup 是一个专为 OpenClaw 工作区设计的本地 Git 备份工具,主要功能是生成一个自包含的 Git bundle 文件,用于完整保存仓库的历史记录和引用信息。该工具将备份文件存储在 `/root/.openclaw/backups` 目录下,确保数据集中管理且易于访问。当用户在 Telegram 中执行 `/gitbackup` 命令或收到手动备份请求时,系统会自动触发此脚本。整个过程无需额外配置,只需运行预置的 shell 脚本即可完成操作。输出结果会清晰显示生成的 bundle 文件路径及其大小,文件名采用 UTC 时间戳命名,便于按时间追溯和管理多个备份版本。

核心功能特点

  1. 自动生成自包含的 Git bundle 备份文件
  2. 备份文件存储于固定目录 `/root/.openclaw/backups`
  3. 文件名包含 UTC 时间戳,支持按时间排序
  4. 仅保留最新备份,不自动清理旧文件
  5. 对非 Git 仓库环境提供明确错误提示

适用场景

Git Backup 特别适用于需要定期或在特定事件后保存工作区代码历史记录的场合。例如,当开发者在完成重要功能开发、发布前准备阶段或面临系统升级风险时,可通过执行 `/gitbackup` 快速生成一份完整的本地备份。由于 bundle 文件包含了所有提交历史和分支引用,它可以在未来任何时间被重新导入为独立仓库,极大提升了代码恢复的灵活性。此外,该工具也适合团队协作场景,当成员希望离线审查完整变更历史或迁移项目时,bundle 提供了一种轻量级、无需网络依赖的传输方式。对于依赖自动化流程的用户而言,该脚本可直接集成到定时任务中,实现无人值守的周期性备份保障。