核心用法
Claw Roam 是一套基于 Git 的 OpenClaw 工作空间同步方案，专为需要在多台机器（如本地 Mac 与远程 VPS）间无缝切换的用户设计。核心命令仅三条：claw-roam push 提交并推送当前工作空间变更、claw-roam pull 拉取远程最新状态并重启网关、claw-roam status 查看同步状态并提示下一步操作。
使用前需完成一次性初始化：在 ~/.openclaw/workspace 目录建立 Git 仓库，配置远程地址，VPS 端通过软链接指向克隆的工作空间。典型工作流为本地为主力开发机，VPS 作为备用或部署节点，通过 push/pull 实现状态接力。
显著优点
1. 零依赖轻量化：纯 Git 方案，无需额外服务或数据库，任何支持 Git 的平台均可使用
2. 完整状态迁移：同步人格（SOUL.md）、长期记忆（MEMORY.md）、每日对话日志、技能库、设备配置等核心资产
3. 灵活的双机协作：支持"本地开发+云端备份"或"本地+VPS 热备"两种模式，通过 webhook 切换 Telegram 机器人指向
4. 自动化友好：提供 crontab 示例，可配置自动推送，降低人工操作成本
潜在缺点与局限性
- 冲突处理粗糙：仅提供
--strategy=ours的简易合并策略，复杂冲突需手动介入 - 非实时同步：依赖定时任务或手动触发，存在同步窗口期，双机同时活跃时易产成分歧
- 二进制文件敏感：SQLite 数据库明确不同步，虽可重建，但频繁切换可能导致会话状态不一致
- 路径硬编码风险：脚本依赖
~/.openclaw/workspace固定路径，非标准安装需额外适配
适合人群
- 拥有固定开发机+云服务器的技术用户
- 需要物理隔离敏感操作（如将某些交互放在 VPS）的隐私意识用户
- 希望版本化管理 AI 人格演进的高级用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据泄露 | Git 远程仓库若设为公开，MEMORY.md 中的对话历史可能暴露 |
| 仓库污染 | auto-push 可能误提交临时文件，需配合 `.gitignore` 使用 |
| 服务中断 | pull 操作会强制重启网关，正在进行的任务可能中断 |
| 凭证暴露 | 远程 URL 若含 token，可能在进程列表或历史记录中残留 |