Claw Roam

核心功能

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 可能包含个人隐私，需确保私有仓库或加密存储

核心用法

claw-roam 是 OpenClaw 生态的轻量级 Git 同步工具，解决多设备工作流的核心痛点：人格（SOUL.md）、长期记忆（MEMORY.md）、技能（skills/）等关键数据的无缝迁移。

一键同步命令：

claw-roam sync    # 完整工作流：commit → merge main → push

分支模型（推荐）：

• main — 共享主分支
• local / remote — 各设备专属分支

典型场景：
1. 下班前（Mac）：claw-roam push 提交当日记忆
2. 旅途中（VPS）：claw-roam pull 拉取最新状态，切换 webhook 指向
3. 回归本地：反向推送 VPS 更新，完成闭环

显著优点

| 优势 | 说明 |

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

| **零配置依赖** | 纯 Bash 实现，无第三方依赖，兼容任意支持 Git 的平台 |

| **原子化操作** | `sync` 单命令完成 commit-merge-push 完整链路，避免手动 Git 失误 |

| **记忆连续性** | MEMORY.md、SOUL.md、对话日志（memory/*.md）全量同步，跨设备人格一致 |

| **灵活分支策略** | 支持多设备分支模型，也支持极简单分支模式 |

| **透明可审计** | 所有变更进入 Git 历史，可随时回滚或对比差异 |

潜在缺点与局限性

1. Git 操作门槛：冲突解决需用户理解 git checkout --ours/theirs
2. 无实时同步：依赖手动或 cron 触发，非即时双向同步
3. 大文件限制：Git 不适合管理二进制大文件（图片、模型等）
4. Webhook 需手动切换：Telegram bot webhook 地址需用户自行更新，非自动
5. 会话状态丢失：SQLite 会话数据库不同步（但可从 memory 文件重建）

适合人群

• 双机开发者：本地 Mac 主力开发 + 远程 VPS 7×24 在线
• 数字游牧者：频繁切换设备，需保持 OpenClaw 人格连续性
• 备份意识用户：希望 Git 化备份 SOUL/MEMORY 等核心配置

常规风险

| 风险类型 | 说明 | 缓解措施 |

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

| **数据泄露** | 误推至公开仓库导致记忆/对话暴露 | 强制使用私有仓库，配置 .gitignore |

| **凭证泄露** | SSH 密钥或 PAT 管理不当 | 使用操作系统密钥链，避免硬编码 |

| **合并冲突** | 多设备同时编辑同一文件 | 养成「push → 换机 → pull」习惯 |

| **仓库污染** | 误将大文件/敏感日志纳入版本 | 预置 .gitignore，定期审查 status 输出 |

安全认证亮点

• A 级评分（78/100）：静态分析 85 分，动态行为 80 分，依赖审计 95 分
• 零恶意代码：无危险函数、无敏感信息硬编码、无提示词投毒
• 纯 Bash 实现：消除供应链攻击面，行为完全可审计