🦞 克隆龙虾 - OpenClaw 配置自动备份

将 OpenClaw/CatPaw 的配置、上下文、Skills 和系统改动自动备份到 Git 仓库。

前置要求

1. 已配置 SSH 密钥可访问 Git 仓库
2. 设置备份仓库地址环境变量：CLONE_LOBSTER_REPO_URL

备份内容

使用方式

自动备份（推荐）

在对话中检测到以下变更时，自动触发备份：

• 修改了 AGENTS.md, SOUL.md, USER.md 等工作区文件
• 安装了新的 skill
• 修改了 openclaw.json 配置
• 修改了系统配置（supervisor, 桌面环境等）
• 用户明确要求"备份"

执行备份：

export CLONE_LOBSTER_REPO_URL="ssh://git@git.sankuai.com/~lipingjiang/catclaw_configuration.git"
bash scripts/backup.sh "描述本次变更"

手动恢复

export CLONE_LOBSTER_REPO_URL="ssh://git@git.sankuai.com/~lipingjiang/catclaw_configuration.git"

# 恢复全部
bash scripts/restore.sh --all

# 仅恢复工作区
bash scripts/restore.sh --workspace

# 仅恢复配置
bash scripts/restore.sh --config

# 仅恢复 Skills
bash scripts/restore.sh --skills

自动触发规则

Agent 在以下情况下应主动运行备份脚本：

1. 配置变更后：修改了 openclaw.json、workspace 文件、或安装了 skill
2. 系统变更后：修改了 supervisor 配置、安装了新软件包、修改了桌面环境
3. 对话结束前：如果本次对话中有重要变更，在结束前执行一次备份
4. 用户请求时：用户说"备份"、"保存"、"同步"等关键词
5. 心跳检查时：可在 HEARTBEAT.md 中添加定期备份任务

注意事项

• 备份脚本会自动排除 node_modules、__pycache__ 等无需备份的目录
• 敏感信息（API keys、密码）在 openclaw.json 中，确保仓库访问权限受控
• 首次使用需确保 Git 仓库已创建且 SSH 密钥有读写权限
• 备份脚本是幂等的，重复运行不会产生问题