GitHub 仓库备份

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

触发方式

触发词	模式	说明
"设置 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

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

---

故障排除

常见问题

问题	原因	解决
Token 无效	token 过期或权限不足	重新生成有 repo 权限的 token
仓库不存在	仓库名拼写错误	检查仓库名是否正确
Push 失败	没有权限或网络问题	检查 token 权限和网络
定时不执行	cron 配置错误	用 openclaw cron list 检查

手动修复命令

# 检查远程仓库
git remote -v

# 重新设置远程
git remote set-url origin https://x-access-token:[email protected]/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" - "配置定时备份"