技能介绍

工作区同步的痛点

OpenClaw 工作区中的文件、配置和元数据散落在本地磁盘，缺乏统一的远程镜像机制。当需要跨机器迁移、做容灾备份，或在多节点间保持一致时，手工复制既容易遗漏，也难以处理增量变化。更棘手的是，agent 系统的运行状态往往包含敏感信息，明文上传到云存储会带来安全风险。

核心能力与工作方式

openclaw-workspace-sync 围绕三种同步模式组织，分别覆盖不同的备份场景：

mailbox 模式：适合将工作区作为消息队列式备份，按时间线追加快照，便于回溯历史状态
mirror 模式：在目标云存储中创建与源工作区结构一致的完整镜像，适合做全量克隆
bisync 模式：双向同步两个工作区，适用于主备节点或开发与生产环境间的对等复制

在数据安全方面，技能在流式传输过程中对内容进行加密，确保备份数据即使被截获也无法直接读取。同步流程采用流式处理，避免一次性加载全部文件到内存，适合大体积工作区。

适用边界与注意事项

该技能依赖 rclone 进行底层云存储操作，因此需要预先配置好 rclone 的认证凭据。mailbox 模式更适合追加型快照，如果频繁删除本地旧文件，远端可能残留历史数据，需要手动清理。bisync 模式对冲突处理有特定要求，不适合两端同时写入的场景。加密在客户端完成，密钥管理仍需自行负责。