alfred-github-backup

GitHub 仓库备份技能 - 将 OpenClaw 工作空间备份到 GitHub 私有仓库。 支持两种模式：(1) 自动模式 - 定时自动备份 (2) 手动模式 - 交互式配置向导。 自动引导用户完成：GitHub Token 配置 → 仓库创建 → 初始化备份 → 设置定时任务。 用途：(1) 首次设置 (2...

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:[e-mail]/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"
• "配置定时备份"