GitHub Memory Sync 技能

GitHub Memory Sync 技能

📝 将 OpenClaw 的 memory 文件同步到 GitHub 仓库进行备份和版本控制。

同步范围

1. MEMORY.md - 长期记忆文件（workspace 根目录）
2. memory/*.md - 日常记忆文件（memory 子目录）

功能特性

1. 📤 推送到 GitHub - 将本地 memory 文件推送到 GitHub 仓库
2. 📥 从 GitHub 拉取 - 从 GitHub 拉取最新的 memory 文件
3. 📊 查看状态 - 检查本地和远程的差异
4. 📋 列出文件 - 显示 memory 目录下的所有文件
5. 🔧 初始化仓库 - 首次设置 GitHub 仓库连接

配置要求

必需配置

GitHub Token:

• 需要一个 Personal Access Token
• 权限要求：repo（仓库读写权限）
• 生成地址：https://github.com/settings/tokens/new

GitHub 仓库:

• 格式：username/repository-name
• 示例：myusername/openclaw-memory-backup
• 建议设为 Private（私有仓库），因为 memory 可能包含敏感信息

配置方式

方案 A：使用环境变量（推荐用于测试）

export GITHUBTOKEN="ghp_xxxxxxxxxxxxxxxxx"
export GITHUB_REPO="yourusername/your-repo"

方案 B：配置文件（推荐用于生产）

在 ~/.openclaw/openclaw.json 中添加：

{
  "skills": {
    "entries": {
      "github-memory-sync": {
        "enabled": true,
        "apiKey": "ghp_xxxxxxxxxxxxxxxxx",
        "env": {
          "GITHUBTOKEN": "ghp_xxxxxxxxxxxxxxxxx",
          "GITHUB_REPO": "username/memory-backup",
          "GITHUB_BRANCH": "main",
          "WORKSPACE_DIR": "/root/.openclaw/workspace"
        }
      }
    }
  }
}

使用示例

首次初始化

用户："初始化 GitHub memory 仓库"
AI: [获取 Token 和仓库信息后执行初始化]

推送更新

用户："同步 memory 到 GitHub"
AI: [执行推送操作]

拉取更新

用户："从 GitHub 拉取最新 memory"
AI: [执行拉取操作]

查看状态

用户："检查 memory 同步状态"
AI: [显示本地和远程的差异]

安全提醒

⚠️ 重要安全注意事项：

1. Token 保护

   • ❌ 不要把 Token 发送到任何公开渠道
   • ❌ 不要在代码中硬编码 Token
   • ✅ 使用环境变量或配置文件
   • ✅ 定期轮换 Token

2. 仓库隐私

   • 🔒 建议将 GitHub 仓库设为 Private（私有）
   • 👁 memory 可能包含敏感信息
   • 📝 审查 memory 内容再上传

3. 权限最小化

   • 只给 Token 必要的权限（repo）
   • 避免使用具有广泛权限的 Token
   • 设置 Token 过期时间（不要永不过期）

激活技能

当用户提到以下关键词时激活此技能：

• "GitHub memory"
• "同步 memory"
• "备份 memory"
• "GitHub 备份"
• "memory 同步"
• "github-memory-sync"

配置流程

1. 获取配置信息

   • 向用户询问 GitHub Token
   • 向用户询问 GitHub 仓库地址（或帮其创建）

2. 保存配置

   • 将 Token 和仓库信息保存到配置文件或环境变量
   • 提醒用户注意安全事项

3. 执行操作

   • 根据用户请求执行 init/push/pull/status 操作
   • 显示操作结果

注意事项

• 首次使用必须先执行 init 初始化
• 推送前建议先拉取，避免冲突
• 定期检查 Token 是否过期
• 建议启用 GitHub 的两因素认证