Claw Roam

🐾 Git 同步你的 AI 人格与记忆

通过 Git 实现 OpenClaw 工作空间跨设备同步,支持本地 Mac 与远程 VPS 无缝切换,保留人格、记忆与技能配置。

收藏
5.1k
安装
2.5k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

claw-roam 是一款面向 OpenClaw 用户的 Git 同步工具,解决 AI 助手在多设备间"断片"的痛点。核心命令仅三条:

  • claw-roam push [message] —— 打包并推送当前工作空间变更至远程仓库
  • claw-roam pull —— 拉取最新状态并重启网关以应用变更
  • claw-roam status —— 查看同步状态与待办建议

显著优点

无缝跨端体验:开发者可在本地 Mac 深度调试后,通过一条命令将完整人格(SOUL.md)、长期记忆(MEMORY.md)及技能集迁移至 VPS,无需手动复制文件或重新配置环境。

版本化备份:Git 底层天然提供变更历史追溯,误删记忆或配置错误时可回滚至任意提交点。

自动化友好:支持 cron 定时推送,实现"无感同步"。

潜在局限与风险

冲突处理依赖手动:虽提供 --strategy=ours 的合并建议,但双向编辑场景仍需用户理解 Git 基础操作,非技术用户可能困惑。

平台差异未完全抽象:SQLite 会话数据库因机器特定未同步,依赖从 memory 文件重建,极端情况下可能出现会话状态轻微不一致。

Webhook 切换需手动:Telegram 等 webhook 地址的 DNS 切换不在工具自动化范围内,切换设备后需额外配置。

适合人群

  • 多设备(本地+云端)开发 OpenClaw 的进阶用户
  • 希望将 AI 助手"随身带走"的数字游牧者
  • 需要版本化备份 Agent 配置的谨慎型用户

常规风险

  • 权限泄露:Git 远程若配置为 HTTPS 明文存储凭证,存在令牌暴露风险;建议优先使用 SSH 密钥
  • 敏感数据入仓:MEMORY.md 可能包含隐私对话,需确保私有仓库或加密存储
  • 服务中断:VPS pull 操作会重启网关,生产环境需注意中断窗口

技术可信度

工具逻辑清晰,基于成熟 Git 工作流,无复杂依赖。但需注意其自述为"系统自动生成占位",未经过独立安全审计。

Claw Roam 内容

scripts文件夹
手动下载zip · 3.4 kB
claw-roam.shtext/x-shellscript
请选择文件