openclaw-backup-skill

这是一个可复用的 OpenClaw skill 项目。它的作用是让用户在对话里直接说一句自然话，例如：

• 帮我备份 openclaw 到 GitHub
• 同步 openclaw 备份
• 把 openclaw 最新改动推到 GitHub

说完一句话之后发生什么

skill 会自动完成这些动作：

• 同步选定的 ~/.openclaw 内容到备份仓库
• 检查 Git 变更
• 生成中文更新概述
• 生成中文 commit message
• 执行 git add、git commit、git push
• 返回成功、无变更或失败结果

适合谁

这个项目适合以下场景：

• 想把 OpenClaw 的精选资产持续备份到 GitHub
• 想保留“自然语言触发 + 固定脚本执行”的工作流
• 想把这套备份 skill 分享给团队其他伙伴复用

备份范围

默认会备份这些内容：

• workspace/
• skills/
• extensions/
• 可选的说明文档文件

默认不会备份这些运行态或敏感内容：

• identity/
• devices/
• 日志
• delivery queue
• 数据库文件
• 不应进入 Git 的密钥或认证真值

项目结构

openclaw-backup-skill/
  README.md
  docs/
    agent-backup-instructions.md
  skills/
    openclaw-backup-github/
      SKILL.md
      scripts/
        backup-openclaw-to-github.sh
      tests/
        backup-openclaw-to-github.test.sh

安装到 OpenClaw

你可以把这个仓库 clone 到任意位置，然后把 skill 目录软链接到 ~/.openclaw/skills：

ln -s /path/to/openclaw-backup-skill/skills/openclaw-backup-github ~/.openclaw/skills/openclaw-backup-github

如果当前 OpenClaw 会话没有立刻识别到新 skill，重新开一个 session 一次即可。

使用前提

使用前请确保这些条件已经满足：

• 本机安装了 git
• 本机安装了 rsync
• 已经准备好了一个 Git 备份仓库，例如 ~/Documents/agent-backup
• 这个备份仓库已经能正常推送到 GitHub

快速开始

方式一：在对话里直接用 skill

完成安装后，在支持本地 skills 的对话里直接说：

• 帮我备份 openclaw 到 GitHub

或者：

• 同步 openclaw 备份
• 把 openclaw 最新改动推到 GitHub

方式二：不用 skill，直接手工执行脚本

如果 skill 没触发，或者你想手工排查，可以直接运行：

bash /path/to/openclaw-backup-skill/skills/openclaw-backup-github/scripts/backup-openclaw-to-github.sh

常用环境变量

这个脚本支持通过环境变量适配不同机器和目录：

• OPENCLAW_SOURCE_ROOT
  • 默认为 ~/.openclaw
• OPENCLAW_BACKUP_REPO_ROOT
  • 默认为 ~/Documents/agent-backup
• OPENCLAW_BACKUP_SUBDIR
  • 默认为 openclaw
• OPENCLAW_INSTRUCTIONS_SOURCE
  • 可选，用来指定要同步进备份仓库的说明文档源文件
• OPENCLAW_INSTRUCTIONS_DEST
  • 可选，用来指定说明文档在备份仓库中的目标路径

例如：

OPENCLAW_SOURCE_ROOT=~/.openclaw \
OPENCLAW_BACKUP_REPO_ROOT=~/Documents/agent-backup \
bash /path/to/openclaw-backup-skill/skills/openclaw-backup-github/scripts/backup-openclaw-to-github.sh

测试方法

运行：

bash skills/openclaw-backup-github/tests/backup-openclaw-to-github.test.sh

这个测试会使用临时目录和临时 bare Git 远端，不会动你的真实 GitHub 仓库。

配套文档

更详细的使用说明见：

• docs/agent-backup-instructions.md