OpenClaw Git 备份

使用此技能为 OpenClaw 仓库构建可复用的每日 Git 备份工作流。

该工作流的功能如下：

• 暂存仓库变更
• 可选地排除调度器产生的噪声或其他路径
• 仅在存在已跟踪的变更时才创建提交
• 提交主题中包含 +added ~modified -deleted 的计数信息
• 提交正文中列出所有变更文件
• 即使未生成新提交，仍执行 git push，以确保此前未推送的本地提交被同步出去
• 与 OpenClaw cron 集成；每次完成配置或修改后，都应强制运行一次

需确认的输入项

在进行任何更改前，请确认以下值：

• 仓库根目录，例如：
• 运行时脚本路径，例如：
• 时区，例如：
• 远程仓库名称，通常为 origin
• 分支行为：当前分支 或 显式指定分支
• 排除模式（如有）
• 是否需要配置 HTTPS Token

若用户已隐含提供了这些值，则无需将其转化为问答式交互流程，直接继续执行即可。

默认值

全新配置下的合理默认值：

• 远程仓库：origin
• 时区：UTC
• 作者姓名：OpenClaw Backup
• 作者邮箱：backup@local
• 分支：当前分支；若处于分离头指针（detached HEAD）状态，则默认为 main
• 排除模式：默认不启用；仅当仓库自身存在调度器产生的自干扰时才需设置

附带脚本

该技能包含脚本 scripts/nightly_git_backup.sh。

建议将该脚本作为实现源码优先使用，再将其复制到用户期望由 cron 任务调用的运行时路径下。

典型安装步骤：

install -D -m 755 /scripts/nightly_git_backup.sh 
bash -n 

配置模型

附带脚本支持以下环境变量：

• BACKUP_REMOTE — 默认值：origin
• BACKUP_BRANCH — 可选，显式指定目标分支
• BACKUP_TZ — 默认值：UTC
• BACKUP_AUTHOR_NAME — 默认值：OpenClaw Backup
• BACKUP_AUTHOR_EMAIL — 默认值：backup@local
• BACKUP_EXCLUDES — 逗号分隔的 Git 路径匹配排除模式，例如：cron,cron/**,.cache,.cache/**

第一个位置参数为仓库路径。若省略，则脚本将依次尝试使用 BACKUP_REPO 环境变量或当前工作目录。

推荐操作流程

1. 检查当前状态

请检查以下内容：

• git -C rev-parse --show-toplevel
• git -C status --short --branch
• git -C remote -v
• openclaw cron list 或等效的 cron 列表命令

2. 安装或更新运行时脚本

将附带脚本复制至 cron 任务将执行的运行时路径。

3. 仅在必要时配置推送认证

若 HTTPS 推送已正常工作，请勿改动现有认证配置。

若用户明确提供了 GitHub HTTPS Token，请优先采用仓库级凭据存储方式，而非将凭据嵌入远程 URL 中：

git -C  config credential.helper 'store --file=/.git/credentials'
git -C  config credential.useHttpPath true
printf 'protocol=httpsnhost=github.comnpath=OWNER/REPO.gitnusername=x-access-tokennpassword=TOKENn' | git -C  credential approve
chmod 600 /.git/credentials
git -C  ls-remote --heads  

相关规则：

• 禁止将 Token 写入远程 URL
• 禁止将真实 Token 存储于本技能内部
• 务必收紧凭据文件权限至 600

4. 创建或更新 cron 任务

参阅 references/cron-job-template.md。

设置任务执行命令如下：

bash -lc ' '

典型的 cron 设置包括：

• 独立 agentTurn
• 低推理开销（low thinking）
• 超时时间：600 秒
• 默认静默交付；仅当用户主动要求时才发送告警

5. 立即强制运行一次

不可止步于“任务已创建”。必须完整测试端到端流程。

强制运行后，请检查以下内容：

• 最新提交的主题（subject）
• 最新提交的正文（body）
• git status --short --branch
• 若预期执行推送，请运行：git rev-list --left-right --count /...HEAD

验证清单

脚本

• bash -n

Git

• git -C status --short --branch
• git -C remote -v
• git -C ls-remote --heads

Cron

• 列出所有任务
• 强制运行备份任务
• 检查最近一次运行结果

预期结果

• 若排除后仍有暂存变更，则创建并推送一个新提交
• 若无新增变更，仍会执行 git push，以同步此前未推送的本地提交
• 排除模式可防止调度器自干扰生成虚假的备份提交

提交信息规范

附带脚本生成的提交格式如下：

主题（Subject）

backup: snapshot YYYY-MM-DD HH:MM:SS +0000 | +A ~M -D

正文（Body）

Added(n)
- ...

Modified(n)
- ...

Deleted(n)
- ...

Renamed(n)
- old -> new

正文内容须保持客观、以文件为中心。

常见陷阱

调度器自干扰（Scheduler self-noise）

部分仓库内含每次运行都会变化的调度器状态。请通过 BACKUP_EXCLUDES 显式排除。

示例：

BACKUP_EXCLUDES='cron,cron/**'

仓库外的运行时状态

Git 仅备份目标仓库目录内的文件。若某工作流还依赖仓库外的目录，则这些目录不会被自动覆盖，除非用户显式添加第二个同步步骤，或将它们镜像进仓库内。

详见 references/backup-scope.md。

错误的成功判定标准

“cron 任务已存在”并不足够。

真正的成功条件是：

1. 强制运行成功
2. 提交格式正确
3. 推送成功
4. 远程仓库与本地同步一致

输出风格

反馈结果时，请保持具体、明确：

• 已配置了哪些内容
• 已测试了哪些环节
• 推送是否成功
• 哪些内容仍在备份范围之外