🦞 ClawSync

WorkBuddy (OpenClaw) 龙虾记忆迁移与合并工具

换了新电脑？创建了新工作区？想把两只调教好的龙虾的经验合并？ClawSync 帮你搞定。

---

为什么需要这个工具？

WorkBuddy（OpenClaw）的核心身份和记忆分散在一组 Markdown 文件中：

• ~/.workbuddy/SOUL.md — AI 的价值观和行为准则
• ~/.workbuddy/IDENTITY.md — AI 的名字、性格
• ~/.workbuddy/USER.md — 用户画像
• ~/.workbuddy/skills/ — 已安装的 Skills
• {workspace}/.workbuddy/memory/MEMORY.md — 长期记忆

每次在新设备、新工作区或新 WorkBuddy 实例中使用时，都需要手动重建这些文件，非常耗时。ClawSync 让这个过程一键完成。

---

功能

🗃️ Export · 记忆快照

将一只龙虾的所有记忆打包成 .clawsnap 文件。

clawsync export
clawsync export --output ~/my-claw.clawsnap
clawsync export --no-daily        # 不含每日日志
clawsync export --since 2026-01-01  # 仅包含指定日期后的日志

📥 Import · 记忆恢复

将快照恢复到新龙虾，快速完成初始化。

clawsync import my-claw.clawsnap               # 交互式选择策略
clawsync import my-claw.clawsnap --strategy overwrite      # 直接覆盖（推荐全新龙虾）
clawsync import my-claw.clawsnap --strategy skip-existing  # 跳过已有文件（安全模式）
clawsync import my-claw.clawsnap --dry-run     # 预演，不实际写入

🔀 Merge · 记忆合并 ⭐

将两只龙虾的记忆智能合并——这是 ClawSync 的核心创新功能。

clawsync merge claw-a.clawsnap claw-b.clawsnap
clawsync merge claw-a.clawsnap claw-b.clawsnap --output merged.clawsnap
clawsync merge claw-a.clawsnap claw-b.clawsnap --preview   # 仅展示 diff 预览

合并策略：

• SOUL.md / IDENTITY.md / USER.md / MEMORY.md：章节级 Markdown 结构化合并，相同章节去重，独有内容保留并标注来源
• 每日日志：按日期时间线合并，同一天的日志追加不重复内容
• Skills：两者都保留，同名文件取较新版本

---

快速开始

方式一：Shell 脚本（无需安装，立即可用）

git clone https://github.com/your-username/clawsync.git
cd clawsync

# 导出当前龙虾记忆
./scripts/claw-export.sh

# 在新设备/新工作区恢复
./scripts/claw-import.sh claw-snapshot-20260327.tar.gz

方式二：TypeScript CLI（功能完整版）

# 安装依赖
cd packages/cli
npm install

# 构建
npm run build

# 全局安装
npm link

# 使用
clawsync export
clawsync import my-claw.clawsnap
clawsync merge claw-a.clawsnap claw-b.clawsnap

---

快照文件结构

.clawsnap 本质上是一个 ZIP 文件，内部结构如下：

snapshot.clawsnap
├── manifest.json          # 快照元信息（版本、时间、文件列表）
├── identity/              # 身份文件
│   ├── SOUL.md
│   ├── IDENTITY.md
│   └── USER.md
├── skills/                # Skills
│   └── SKILL-*.md
├── memory/                # 工作区记忆
│   ├── MEMORY.md
│   └── daily/
│       └── YYYY-MM-DD.md
└── config/                # 配置文件（可选）
    ├── settings.json
    └── mcp.json

---

安全提示

⚠️ .clawsnap 文件包含个人信息（用户名、城市、项目偏好、工作记录等）。

• 不要将快照文件提交到公开的 Git 仓库
• 不要随意分享快照文件
• .gitignore 已默认排除 *.clawsnap 和 *.tar.gz

---

开发路线图

• Phase 1：Shell 脚本 MVP（export / import）
• Phase 2：TypeScript CLI 框架
• Phase 3：记忆合并引擎（Markdown 章节级合并）
• Phase 4：AI 辅助语义合并（SOUL.md 智能合并）
• Phase 5：自动定时快照
• Phase 6：WorkBuddy 官方 Skill 集成

---

项目结构

clawsync/
├── packages/
│   └── cli/               # TypeScript CLI 工具
│       ├── src/
│       │   ├── commands/  # export / import / merge
│       │   ├── core/      # 快照引擎 + 合并引擎
│       │   └── utils/     # 工具函数
│       └── package.json
├── scripts/               # Shell 脚本（快速版）
│   ├── claw-export.sh
│   └── claw-import.sh
├── PROJECT-DESIGN.md      # 完整设计文档
└── README.md

---

License

MIT

---

ClawSync — 让每只龙虾都能继承最好的记忆。