通过Git实现OpenClaw工作区多端同步，一键迁移人格、记忆与技能，支持本地Mac与远程VPS无缝切换。
说明：
## 核心功能
**claw-roam** 是专为 OpenClaw 设计的多设备工作区同步工具，基于 Git 实现版本控制与跨机器迁移。核心能力包括：
– **一键全量同步**：`claw-roam sync` 单命令完成提交、合并、推送的完整工作流
– **分支隔离策略**：推荐 `local`/`remote` 双分支 + `main` 共享基线的模型，避免直接冲突
– **状态感知**：`claw-roam status` 实时显示未推送提交、未提交变更及建议操作
– **服务热重启**：VPS 模式下自动停止并重启网关以应用变更
### 显著优点
1. **零配置迁移**：SOUL.md（人格）、MEMORY.md（长期记忆）、skills/（技能）等核心状态全量保留
2. **冲突可控**：推荐的分支模型将多设备编辑冲突收敛到 `main` 分支合并环节，并提供 `–ours`/`–theirs` 快捷解决指令
3. **自动化友好**：支持 cron 定时自动推送，实现”关机即备份”
4. **低开销**：基于现有 Git 基础设施，无需额外服务端
### 局限与风险
| 方面 | 说明 |
|——|——|
| **技术门槛** | 要求用户具备 Git 基础操作知识，分支策略理解成本较高 |
| **冲突处理** | 自动合并失败时需手动介入，无图形化冲突解决界面 |
| **二进制数据** | SQLite 会话数据库不直接同步（虽可从 memory 重建，但存在重建风险）|
| **网络依赖** | 依赖 Git 远程可达性，断网场景无法同步 |
| **权限管理** | 若使用 HTTP 协议存储凭证，存在令牌泄露风险 |
### 适合人群
– 需要在 **Mac 本地开发** 与 **VPS 生产环境** 间频繁切换的开发者
– 重视 **OpenClaw 人格连续性**、不愿重复配置的多设备用户
– 已具备 Git 工作流经验的运维人员
### 常规风险提示
– **强制推送风险**：脚本未设置 `–force-with-lease`，不当操作可能覆盖远程
– **Webhook 漂移**：VPS/本地切换后需手动更新 Telegram webhook 指向，易遗漏
– **敏感信息**：SOUL.md、MEMORY.md 可能包含个人隐私，需确保私有仓库或加密存储
会员专属
