GitHub 备份与版本控制

概述

将 /home/node/.openclaw/workspace 目录集中托管至私有仓库 nz365guy/openclaw-backup，确保所有配置文件、记忆笔记及自定义技能均纳入版本管理。方案包含自动化备份工作流脚本、Token 使用指南，以及面向常规快照和技能专属变更的提交规范。

快速启动检查清单

1. 认证已加载 — 运行 source .env.local 以暴露 GITHUB_TOKEN（需具备 repo 和 workflow 权限）。切勿提交 .env.local 文件。
2. 远程仓库校验 — 执行 git remote -v 应显示 origin https://github.com/nz365guy/openclaw-backup.git；若缺失，请运行 git remote add origin ... 补充配置。
3. 工作区状态检查 — 每次备份前执行 git status -sb，人工审查 diff 输出，确认无敏感信息泄露。
4. 参考文档 — 详见 references/repo-setup.md，其中包含仓库详细配置、Token 轮换步骤及安全守则。

常规备份工作流

1. 检查变更内容

   cd /home/node/.openclaw/workspace
   git status -sb
   git diff
   

2. 运行辅助脚本（推荐用于自动化）：

   skills/github-backup/scripts/backup_openclaw.sh "Backup: <简明摘要>"
   

   • 自动加载 .env.local，按 .gitignore 规则暂存全部变更，完成提交并使用 Token 认证 URL 推送至远程仓库。
   • 若无任何修改，则提前退出，不执行后续操作。
3. 手动回退方式（如需自定义暂存范围）：

   git add 
   git commit -m ""
   source .env.local
   git push https://nz365guy:${GITHUB_TOKEN}@github.com/nz365guy/openclaw-backup.git main
   

4. 在 GitHub 上验证 — 运行 gh repo view 或直接打开仓库 URL，确认新提交已成功抵达。

技能与仓库规范

• 提交信息格式 — 修改 /skills/** 下内容时，提交信息前缀为 Skill:；修改 workspace 配置时使用 Config:；更新记忆笔记时使用 Memory:。备份脚本支持任意自定义消息，当变更超出常规快照范畴（例如新增功能或重大调整），请传入具有描述性的摘要。
• 新增技能 — 创建或更新技能文件夹后，请重新运行备份工作流，确保打包后的资源与 workspace 其余部分一同持久化至 GitHub。
• Token 轮换 — 更新 .env.local 中的 Token 后，需重新加载 Shell 环境，并在执行下一次推送前，使用 references/repo-setup.md 中提供的 curl 片段进行测试验证。
• 敏感文件管理 — 严禁将 .env.local 及任何原始密钥文件纳入 Git 版本控制。如有新增密钥类文件，请同步扩展 .gitignore 规则。

相关资源

• scripts/backup_openclaw.sh：一键式备份辅助脚本（暂存 → 提交 → 推送），从 .env.local 读取 Personal Access Token（PAT），目标分支为 main。
• references/repo-setup.md：权威的仓库与 Token 元数据说明、安全防护机制及验证命令集合。