Claw Roam

核心用法

Claw Roam 是一套基于 Git 的 OpenClaw 工作空间同步方案，主要解决多设备间 AI 助手状态迁移问题。核心命令 trio 包括：claw-roam status（查看同步状态）、claw-roam push [message]（提交并推送变更）、claw-roam pull（拉取并应用远程更新）。推荐采用三分支模型：main 作为共享基线，remote/local 分别对应服务器与本地机器，支持 merge-from 跨分支合并。

典型工作流为"本地主力 + VPS 备用"：日常在 Mac 端使用，关机前执行 push；临时切换至 VPS 时先 pull 更新；返程时反向同步。支持 cron 自动推送，实现近实时备份。

显著优点：

• 完整保留 AI 人格连续性（SOUL.md）、长期记忆（MEMORY.md 及 memory/*.md 日志）、技能库（skills/）等核心资产
• 无需依赖专有云服务，Git 托管自由度高
• 冲突处理简单，提供 --strategy=ours 快速兜底方案

潜在缺点与局限：

• 会话级 SQLite 数据库不同步，重启后需从记忆文件重建上下文
• 机器特定配置（如绝对路径）需手动适配
• 高频自动推送可能产生冗余 commit 历史
• 依赖用户自行维护 Git 认证与仓库权限

适合人群：多设备开发者、需要本地+云端双环境备份的 OpenClaw 重度用户、对数据主权敏感的技术人员。

常规风险：

• 若未配置忽略规则，敏感 token 可能随 Git 历史泄露（当前文档未提及 .gitignore 建议）
• 跨平台符号链接/路径差异可能导致配置失效
• 自动重启 gateway 的 VPS 模式若失败可能造成服务中断

安全等级综合评定为 A，来源可信度 T2（官方技能但无独立安全审计）。

核心用法

Claw Roam 是专为 OpenClaw 设计的跨设备工作空间同步工具，基于 Git 版本控制实现。用户通过简洁的 claw-roam push、pull、status 三条核心命令，即可完成 AI 代理人格（SOUL.md）、长期记忆（MEMORY.md）、技能库及对话历史的无缝迁移。推荐采用三分支模型：main 作为共享基线，remote 和 local 分别对应服务器与个人设备，通过 merge-from 指令实现分支合并。

显著优点

架构简洁可靠：纯 Bash 脚本实现，零第三方依赖，仅调用标准 Git 命令，代码透明可审计。同步粒度精准：明确区分需同步的配置文件与机器特定的运行时状态，避免配置冲突。工作流高度契合场景：针对"本地开发+云端备用"的典型模式设计，配合 cron 自动推送，实现真正的无感同步。数据主权完全归属：用户自主托管 Git 仓库，无需信任第三方云服务。

潜在局限

Git 学习门槛：用户需具备基础 Git 操作知识，理解分支、合并、冲突解决等概念。网络依赖：远程仓库可达性直接影响同步体验，弱网环境下可能失败。无自动冲突解决：双端同时编辑可能产生合并冲突，需手动介入处理。VPS 重启成本：pull 操作后会重启 OpenClaw 网关以应用变更，中断当前会话。平台限定：当前文档主要针对 macOS 与 Linux VPS 场景，Windows 支持未明确。

适合人群

多设备开发者：频繁在本地笔记本与远程服务器间切换的工程师。数字游民：需要保持 AI 助手连续记忆的移动办公人群。自托管优先者：拒绝 SaaS 同步、偏好数据自主可控的技术用户。OpenClaw 重度用户：已深度定制人格与技能、视其为生产力核心组件的人群。

常规风险提示

性能方面：大型记忆文件或历史提交过多时，Git 操作可能产生秒级延迟。依赖项风险：依赖系统 Git 版本（建议 2.30+），老旧版本可能不支持部分特性。凭证管理：用户需自行配置 SSH 密钥或 Personal Access Token，凭证泄露将导致仓库暴露。数据一致性：自动推送脚本若配置不当，可能在编辑中途提交半成品状态。无回滚机制：误操作 push 后无内置撤销功能，需通过 Git 原生命令恢复。