clawdbot-sync

Clawdbot Sync 是一款专为多设备场景设计的智能同步工具，旨在解决用户在不同终端间使用 Clawdbot 时的数据一致性问题。通过整合 SSH 加密通道与 rsync 高效同步协议，并依托 Tailscale 构建安全组网，该工具实现了记忆文件、用户偏好及技能配置的双向实时同步，让多台 Agent 实例保持高度一致。

核心用法围绕 /sync 命令体系展开。用户可通过简单指令完成 peer 设备的添加、连接状态检查、差异预览及实际同步操作。系统支持多种工作模式：双向智能合并适合日常保持多设备数据一致；单向推送（push）和拉取（pull）适用于特定场景的数据迁移；Dry-run 差异预览模式允许用户在执行前查看具体变更，有效避免误操作。配置完成后，用户只需执行 /sync now [peer] 即可触发同步，系统会自动处理基于时间戳的冲突解决，对日志类追加写入文件执行智能合并，确保数据完整性。

显著优点体现在其架构设计与用户体验的精妙平衡。安全性方面，采用 SSH 密钥认证替代密码传输，结合 Tailscale 的零配置虚拟组网技术，既保证了端到端加密传输，又大幅降低了复杂网络环境下的配置门槛。功能层面，选择性同步机制允许用户灵活控制同步范围，自动排除实例特定配置（如 IDENTITY.md），有效避免身份冲突；而完善的命令行界面配合结构化的 JSON 输出，便于与其他自动化工具集成。此外，智能冲突解决机制减少了人工干预需求，dry-run 模式更是提供了额外的操作安全保障。

潜在缺点与局限性主要集中于安全细节与来源可信度。作为 T3 级社区/个人开发者项目，虽代码结构清晰，但缺乏企业级组织背书与长期维护承诺。技术层面存在三处关键风险点：SSH 配置中禁用了 StrictHostKeyChecking，虽提升了首次连接便利性，却可能使连接暴露于中间人攻击；用户输入参数（peer 名称与主机地址）缺乏严格的格式过滤与校验，存在潜在命令注入风险；rsync 同步过程中启用了 --delete 标志，会强制删除目标端不存在于源端的文件，若配置失误可能导致数据不可逆丢失。

适合的目标群体包括：拥有多台工作设备的进阶用户、已部署 Tailscale 组网的技术爱好者，以及需要在隔离网络环境（如家庭内网或企业私网）中保持多 Agent 状态一致的专业人士。典型应用场景涵盖：开发者在个人笔记本与远程服务器间同步开发环境记忆、研究人员在不同工作站间共享知识库与实验记录、以及需要在主力机与备用机间保持配置一致的重度用户。

使用该技能存在的常规风险涵盖多个维度。网络基础设施层面，要求设备间具备稳定 IP 连通性（通过 Tailscale 或直连网络），且必须预先正确配置 SSH 密钥认证，否则同步链路将无法建立。数据安全层面，尽管传输过程加密，但用户需警惕从不受信任或对端设备拉取数据可能引入的恶意文件污染。操作风险方面，rsync 的删除机制与自动化冲突解决策略可能在特定边界情况下（如时钟不同步、文件名冲突）导致非预期数据覆盖，建议首次使用前务必通过 /sync diff 命令预览变更，并建立定期独立备份的习惯。此外，作为社区维护项目，其长期技术支持、安全更新频率与功能迭代存在不确定性，不适合对稳定性要求极高的生产环境关键业务。