OpenClaw工作区同步

技能简介

claw-roam 通过 Git 实现 OpenClaw 工作区在多台机器间的同步，支持本地 Mac 与远程 VPS 之间的无缝切换，保持记忆、人格和技能的连续性。

业务背景

解决团队在多设备协作时的数据孤岛问题。通过Git版本控制，确保OpenClaw工作区的记忆、人格配置和技能资产在Mac本地与VPS云端实时同步，避免重复配置或状态丢失，保障业务连续性。

落地案例：某运维人员白天在公司Mac上调试OpenClaw工作流，下班前执行claw-roam sync推送变更；夜间家中VPS自动拉取最新配置继续运行定时任务。次日回公司后再次同步，即可无缝衔接昨晚的进度，无需手动迁移文件或重新训练模型人格。

能做什么

• 关机前将工作区变更推送到远程仓库
• 在新机器上拉取最新工作区
• 检查多机之间的同步状态
• 完整迁移 OpenClaw 到另一台机器

使用说明

安装前提：需已安装 Git，且 OpenClaw 工作区位于 ~/.openclaw/workspace

初始化设置：

1. 进入工作区目录：cd ~/.openclaw/workspace
2. 初始化 Git 仓库：git init
3. 添加远程仓库：git remote add origin <你的仓库地址>
4. 创建初始提交并推送：git add -A && git commit -m "initial" && git push -u origin main

VPS 机器配置：

cd ~
git clone <你的仓库地址> openclaw-workspace
ln -s openclaw-workspace ~/.openclaw/workspace

分支策略（推荐）：

• main = 共享基线
• remote = 服务器专属
• local = 笔记本/桌面专属

常用命令：

• claw-roam status — 查看当前分支、提交状态及未推送变更
• claw-roam push [消息] — 提交并推送当前分支（无消息则使用时间戳）
• claw-roam pull — 拉取远程最新变更并重启网关
• claw-roam sync — 一键完整同步：提交推送当前分支 → 合并 main → 推送到 main
• claw-roam merge-from local|remote — 将指定设备分支合并到当前分支

日常 workflow：每台机器运行 claw-roam sync 即可确保变更保存、获取其他机器更新、共享自身变更。

输入与输出

见下方输入与输出表格。

风险提示

• 合并冲突时需手动解决，建议提前备份重要数据
• sync 命令会重启 OpenClaw 网关，请确保无正在进行的任务
• 首次配置错误可能导致工作区链接失效
• 多人同时修改同一文件可能产生冲突

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/ryanhong666/claw-roam/SKILL.md
来源类型：GitHub 开源项目