核心用法
Clawdbot Sync 是一款专为多实例 AI 代理设计的分布式同步工具，通过 SSH/rsync 通道实现记忆、偏好配置和技能文件的双向同步。用户通过 /sync 系列命令管理对等节点，支持一键全量同步、定向推送/拉取、差异预览等操作。
典型工作流：配置对等节点 → 建立 SSH 密钥互信 → 执行 /sync now [peer] 完成同步。数据范围涵盖 memory/ 目录、MEMORY.md、USER.md，可选同步 skills/，而 IDENTITY.md 和 config/ 保持实例隔离。
显著优点
1. 架构简洁：基于成熟的 rsync 差量传输，效率高、带宽友好
2. 冲突智能处理：时间戳优先+日志追加合并+人工审查多策略
3. 网络友好：Tailscale 组网，无需公网 IP 或复杂防火墙配置
4. 安全设计：全链路 SSH 加密，无密码存储，路径沙箱限制
潜在局限
- 依赖外部网络：Tailscale 或直连网络可用性决定同步可靠性
- 密钥管理负担：多实例场景需维护 SSH 密钥对的生命周期
- 无版本控制：冲突解决依赖时间戳，复杂编辑冲突可能需人工介入
- 单点写入风险：无分布式锁机制，高频并发修改同一文件可能丢数据
适合人群
- 跨设备使用 Clawdbot 的开发者/高级用户
- 需要本地-服务器双活备份的场景
- 团队协作中共享技能与记忆库的小团队
常规风险
| 风险项 | 说明 |
|--------|------|
| 密钥泄露 | SSH 私钥被盗可导致对等实例数据被拉取 |
| 网络嗅探 | 若未强制 Tailscale/SSH，中间人可截获传输 |
| 误覆盖 | 时间戳策略可能导致意外旧版本覆盖新内容 |
| 路径穿越 | handler.sh 需严格校验 `$WORKSPACE` 边界，防路径遍历 |