GitHub 仓库备份

自动将工作空间备份到 GitHub 私有仓库的完整解决方案。

触发方式

手动模式：交互式配置向导

当用户说"设置 GitHub 备份"时，进入交互式问答：

问题 1：GitHub 用户名

> 请告诉我你的 GitHub 用户名是什么？

等待用户回答（如：ziqi-jin）

问题 2：仓库名

> 你想用什么名字创建备份仓库？

> 建议：jeremy-agents-backup 或 openclaw-backup

等待用户回答

问题 3：GitHub Token

> 现在需要生成 GitHub Token：

> 1. 访问 https://github.com/settings/tokens

> 2. 点击 "Generate new token (classic)"

> 3. Note 填写：backup-token

> 4. 勾选 repo 权限

> 5. 点击生成，然后复制 Token 给我

等待用户粘贴 Token（验证 Token 格式：ghp_ 开头）

问题 4：备份时间

> 选择每天自动备份的时间：

> - A) 凌晨 3:00

> - B) 早上 7:00

> - C) 中午 12:00

> - D) 下午 6:00

>

> 或者输入你希望的具体时间（如：每天下午 5 点）

等待用户选择或输入

问题 5：确认

> 配置确认：

> - GitHub 用户名：[用户名]

> - 仓库名：[仓库名]

> - 备份时间：[时间]

>

> 确认请回复"确认"或"yes"，修改请回复具体要改的部分

用户确认后，执行初始化并设置定时任务。

自动模式：定时备份

当用户选择自动模式或确认配置后：

1. 执行首次备份

git add AGENTS.md SOUL.md USER.md IDENTITY.md TOOLS.md HEARTBEAT.md skills/ memory/
git commit -m "Initial backup: $(date +%Y-%m-%d)"
git push origin main

2. 设置 OpenClaw Cron

openclaw cron add --name "github-backup" --cron "0 <hour> * * *" --message "执行 GitHub 备份" --agent main

手动触发：立即备份

当用户说"立即备份"或"现在备份"时：

cd /root/.openclaw/workspace
git add AGENTS.md SOUL.md USER.md IDENTITY.md TOOLS.md HEARTBEAT.md skills/ memory/
git commit -m "Manual backup: $(date +%Y-%m-%d_%H:%M)"
git push origin main

完成后告诉用户备份结果。

查看备份状态

当用户说"备份状态"或"上次备份什么时候"时：

cd /root/.openclaw/workspace
git log -1 --format="最后备份: %cd"
git status
git remote -v

显示：

• 最后备份时间
• 当前状态（有/无未提交更改）
• 远程仓库配置

故障排除

常见问题

手动修复命令

# 检查远程仓库
git remote -v

# 重新设置远程
git remote set-url origin https://x-access-token:TOKEN@github.com/user/repo.git

# 查看 cron 任务
openclaw cron list

# 手动运行备份
bash ~/.openclaw/workspace/skills/github-backup/scripts/backup.sh

备份内容

✅ 会备份

• skills/ - 所有已安装的技能
• memory/ - 记忆文件
• AGENTS.md - Agent 配置
• SOUL.md - AI 身份
• USER.md - 用户信息
• IDENTITY.md - 身份信息
• TOOLS.md - 工具配置
• HEARTBEAT.md - 心跳任务
• README.md, SYNC.md - 文档

❌ 不会备份

• .clawhub/ - 缓存
• .openclaw/ - 运行时
• node_modules/ - 依赖
• *.log - 日志
• *.tmp - 临时文件
• API Keys - 敏感信息

恢复指南

用户需要恢复时说"从 GitHub 恢复"：

# 1. 克隆仓库
git clone https://github.com/[user]/[repo].git /tmp/restore

# 2. 恢复文件
cp -r /tmp/restore/* ~/.openclaw/workspace/

# 3. 重新配置环境变量
# (因为敏感信息不在备份中)

交互提示词

触发本技能的关键词：

• "设置 GitHub 备份"
• "备份到 GitHub"
• "自动备份"
• "手动备份"
• "立即备份"
• "备份状态"
• "查看备份"
• "github backup"
• "配置定时备份"