GitHub 仓库备份
自动将工作空间备份到 GitHub 私有仓库的完整解决方案。
触发方式
| 触发词 | 模式 | 说明 |
|---|---|---|
| "设置 GitHub 备份" | 手动 | 运行交互式配置向导 |
| "自动备份到 GitHub" | 自动 | 设置定时任务 |
| "立即备份" | 手动 | 立即执行一次备份 |
| "查看备份状态" | 手动 | 检查备份状态 |
手动模式：交互式配置向导
当用户说"设置 GitHub 备份"时，进入交互式问答：
问题 1：GitHub 用户名
请告诉我你的 GitHub 用户名是什么？
等待用户回答（如：ziqi-jin）
问题 2：仓库名
你想用什么名字创建备份仓库？ 建议：
jeremy-agents-backup或openclaw-backup
等待用户回答
问题 3：GitHub Token
现在需要生成 GitHub Token：
- 访问 https://github.com/settings/tokens
- 点击 "Generate new token (classic)"
- Note 填写：
backup-token- 勾选
repo权限- 点击生成，然后复制 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
显示：
- 最后备份时间
- 当前状态（有/无未提交更改）
- 远程仓库配置
故障排除
常见问题
| 问题 | 原因 | 解决 |
|---|---|---|
| Token 无效 | token 过期或权限不足 | 重新生成有 repo 权限的 token |
| 仓库不存在 | 仓库名拼写错误 | 检查仓库名是否正确 |
| Push 失败 | 没有权限或网络问题 | 检查 token 权限和网络 |
| 定时不执行 | cron 配置错误 | 用 openclaw cron list 检查 |
手动修复命令
# 检查远程仓库
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"
- "配置定时备份"