🦞 克隆龙虾 - OpenClaw 配置自动备份
将 OpenClaw/CatPaw 的配置、上下文、Skills 和系统改动自动备份到 Git 仓库。
前置要求
- 已配置 SSH 密钥可访问 Git 仓库
- 设置备份仓库地址环境变量：
CLONE_LOBSTER_REPO_URL
备份内容
| 类别 | 路径 | 说明 |
|---|---|---|
| 工作区 | ~/.openclaw/workspace/ |
AGENTS.md, SOUL.md, USER.md, MEMORY.md, memory/ 等 |
| 配置 | ~/.openclaw/ |
openclaw.json, exec-approvals.json |
| Skills | ~/.openclaw/skills/ |
所有用户安装的 skills |
| 系统 | /etc/supervisor/ 等 |
supervisord.conf, 桌面启动脚本, SSH 配置 |
| 上下文 | ~/.openclaw/data/ |
session 数据库和 memory 索引 |
使用方式
自动备份（推荐）
在对话中检测到以下变更时，自动触发备份：
- 修改了 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 在以下情况下应主动运行备份脚本：
- 配置变更后：修改了 openclaw.json、workspace 文件、或安装了 skill
- 系统变更后：修改了 supervisor 配置、安装了新软件包、修改了桌面环境
- 对话结束前：如果本次对话中有重要变更，在结束前执行一次备份
- 用户请求时：用户说"备份"、"保存"、"同步"等关键词
- 心跳检查时：可在 HEARTBEAT.md 中添加定期备份任务
注意事项
- 备份脚本会自动排除
node_modules、__pycache__等无需备份的目录 - 敏感信息（API keys、密码）在 openclaw.json 中，确保仓库访问权限受控
- 首次使用需确保 Git 仓库已创建且 SSH 密钥有读写权限
- 备份脚本是幂等的，重复运行不会产生问题