gitbackup

GitBackup 是 OpenClaw 官方推出的本地 Git 仓库备份工具，旨在为用户提供简单可靠的代码历史保护方案。该技能通过创建 Git bundle 文件，将工作区的完整 Git 历史、分支和标签打包为单个文件，存储于 /root/.openclaw/backups 目录，确保版本控制数据的安全性和可移植性。

核心用法十分直观：用户可通过 Telegram 的 /gitbackup 命令或手动执行脚本触发备份流程。工具会自动检测当前工作区是否为有效的 Git 仓库，验证通过后使用 git bundle create --all 命令生成包含所有引用的完整备份包，文件名自动附加 UTC 时间戳以避免覆盖，最终输出文件路径和大小供用户确认。

显著优点在于其极高的安全性和透明度。作为纯本地操作工具，它无需网络连接，不产生任何数据外传风险；代码层面严格遵循安全规范，采用 set -euo pipefail 确保脚本健壮性，无 eval、exec 等危险函数，也无动态代码加载。备份过程只读原仓库，不修改任何文件，且权限申请精准匹配功能需求，无过度授权之忧。

然而，该工具也存在一定局限性。首先，它采用全量备份策略而非增量备份，每次均生成完整的 bundle 文件，长期频繁使用可能导致磁盘空间快速占用。其次，备份文件以明文形式存储，缺乏内置加密机制，不适合对安全性要求极高的敏感代码场景。此外，工具不会自动清理历史备份，需要用户定期手动维护存储目录。

适合的目标群体主要包括：需要定期备份工作区状态的开发者、希望通过 Telegram 快速保护代码历史的 OpenClaw 用户、以及需要离线保存 Git 历史或迁移仓库的场景。对于非 Git 仓库的工作目录，工具会明确报错退出，避免误操作。

使用风险主要涉及存储管理方面。由于备份文件累积在固定路径，长期不清理可能导致磁盘空间耗尽；建议用户建立定期清理策略，并通过 git bundle verify 验证备份完整性。总体而言，这是一个设计简洁、安全可靠的本地备份方案。