Workspace GitHub 备份

面向 AI Agent 工作区的一键式备份方案，支持将数据备份至私有 GitHub 仓库。

快速开始

首次配置： 告诉我 “setup GitHub backup”，我将引导你完成交互式向导！

已配置完成： 直接说 “backup now” 即可立即触发一次备份。

功能特性

两种备份模式

已备份内容 ✅

未备份内容 ❌

交互式配置向导

当用户说出 “setup GitHub backup” 时，依次提出以下问题：

问题 1：GitHub 用户名

请提供你的 GitHub 用户名。

等待用户回答（例如：“johnsmith”）

问题 2：仓库名称

你希望为备份仓库起什么名字？ 建议名称：ai-workspace-backup 或 agent-workspace

等待用户回答

问题 3：GitHub Token

现在我们来生成一个 GitHub Token：

1. 访问 https://github.com/settings/tokens
2. 点击 “Generate new token (classic)”
3. 注意：Token 名称建议设为 backup-token
4. 勾选 repo 权限（对私有仓库拥有完全控制权）
5. 点击 “Generate token”
6. 复制并在此处粘贴生成的 Token

等待用户提供 Token（格式示例：ghp_xxx）

问题 4：备份时间

你希望自动备份每天在什么时间运行？

• A) 凌晨 3:00（夜猫子时段）
• B) 上午 7:00（清晨时段）
• C) 中午 12:00（正午时段）
• D) 下午 6:00（傍晚时段）

或直接告诉我你偏好的时间（例如：“每天下午 5 点”）

等待用户选择

问题 5：确认配置

配置摘要如下：

• GitHub 用户名：[username]
• 仓库名称：[repo-name]
• 备份时间：[time]

请回复 “confirm” 或 “yes” 开始配置；若需修改，请指出具体项。

确认后将执行以下步骤：

1. 初始化 Git 仓库
2. 执行首次备份
3. 配置 OpenClaw Cron 定时任务

使用命令

手动触发命令

# 立即备份
"backup now"
"backup immediately"
"run backup now"

# 查看状态
"backup status"
"when did we last backup"
"show backup status"

# 恢复工作区
"restore from GitHub"
"recover workspace"

# 修改配置
"change backup time"
"pause auto backup"

触发关键词

当用户或其它 AI Agent 说出以下任一短语时，本 skill 将被激活：

• “setup GitHub backup”
• “backup to github”
• “auto backup”
• “manual backup”
• “backup now”
• “backup status”
• “workspace backup”
• “git backup”
• “scheduled backup”
• “sync to github”

故障排查

常见问题

手动修复命令

# 查看远程仓库配置
git remote -v

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

# 查看当前 Cron 任务列表
openclaw cron list

# 手动执行一次备份
cd /root/.openclaw/workspace
git add skills/ memory/ AGENTS.md SOUL.md USER.md IDENTITY.md TOOLS.md HEARTBEAT.md README.md SYNC.md .gitignore
git commit -m "Backup: $(date +%Y-%m-%d)"
git push origin main

面向其他 AI Agent 的说明

如果你是另一个正在使用本 skill 的 AI Agent，请参考以下流程：

1. 首次备份： 运行配置向导完成初始化设置
2. 后续备份： 使用 openclaw cron add 添加调度任务
3. 手动触发： 执行标准 git add/commit/push 流程
4. 状态检查： 运行 git log -1 查看最近一次备份提交时间

示例 Cron 配置命令：

openclaw cron add --name "workspace-backup" --cron "0 3 * * *" --message "Execute workspace backup" --agent main

安全说明

• Token 存储于 Git 远程 URL 中（不写入任何文件）
• 敏感数据（如 API keys、密码等）不会被备份
• 备份归档中不含任何凭据信息
• 请务必使用私有仓库进行备份
• 若 Token 泄露，请立即前往 GitHub Settings 页面撤销该 Token

恢复指南

当用户需要从备份中恢复工作区时，请按以下步骤操作：

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

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

# 3. 重新配置环境变量
# （敏感信息不在备份中，需手动补充）

作者

由 Jeremy 为 OpenClaw 社区开发。已发布至 ClawHub，供所有人自由使用与改进。