Clawdbot Sync

核心用法

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` 边界，防路径遍历 |

核心功能

clawdbot-sync 是一款专为多 Clawdbot 实例设计的双向数据同步 Skill，通过 SSH/rsync 在 Tailscale 网络内实现记忆文件、用户配置和技能数据的无缝同步。核心命令包括 /sync now [peer] 执行同步、/sync push/pull 单向推送/拉取、/sync diff 预览变更，以及智能冲突解决机制（时间戳优先、日志文件自动合并）。

显著优点

1. 架构设计合理：采用 Unix 哲学，依赖成熟的 rsync/ssh/jq 系统工具，无第三方包引入供应链风险
2. 网络层安全：基于 Tailscale 的零信任网络叠加 SSH 加密传输，形成双重防护
3. 灵活可控：支持选择性同步（IDENTITY.md 等实例特有文件默认排除）、dry-run 预览模式、自动/手动同步切换
4. 冲突处理完善：提供 newest-wins、merge、skip、manual-review 四级策略，适应不同数据类型

潜在局限与风险

| 风险点 | 详情 | 缓解建议 |

|--------|------|----------|

| SSH 配置缺陷 | `StrictHostKeyChecking=no` 跳过主机密钥验证，存在 MITM 风险 | 改为 `accept-new` 或预配 known_hosts |

| 输入验证不足 | peer 名称、主机地址等参数未严格过滤，潜在命令注入 | 自行审查输入、使用数组传参 |

| 来源可信度 | T3 级个人开发者，维护信息透明度有限 | 隔离环境测试、订阅更新 |

| 日志审计缺失 | 缺少安全事件详细记录 | 自行添加审计日志 |

适合人群

• 多设备 Clawdbot 用户：在 Mac、Linux 服务器、远程主机间保持记忆一致性
• 团队协作场景：小团队共享基础技能配置和领域知识
• 备份需求用户：利用 rsync 增量特性实现高效数据备份

常规风险提醒

• 必须在受信任网络（Tailscale/内网）使用，禁止暴露于公网
• 首次使用前务必审查 scripts/handler.sh 完整代码
• 建议配合 StrictHostKeyChecking=accept-new 手动修复后使用
• 涉及 $WORKSPACE 环境变量访问，注意文件权限隔离