必须停用所有agent进程后同步workspace，优先使用agent context sync配对增量同步，手动镜像仅限离线场景且需重建初始化；同步前须校验路径一致性、清理旧目录、确认无文件句柄占用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让多个设备上的 Agent Space Workspace 文件保持内容一致，必须绕过文件系统级的简单复制，因为 Agent 运行时会独占锁定数据库、持续写入日志、动态生成技能 Markdown，直接拷贝极易损坏状态。
确认 Workspace 实际路径与活动状态
在每台设备上运行 openclaw doctor，查看输出中 “Active workspace” 对应的真实路径。注意：若设置了 OPENCLAW_PROFILE，路径可能为 ~/.openclaw/workspace-<profile></profile>；若存在 ~/openclaw 等旧目录，【openclaw doctor 会明确警告】，此时必须先归档或删除旧目录，否则同步后会出现身份混淆和记忆漂移。
打开 ~/.openclaw/openclaw.json，确认 agent.workspace 字段值与 doctor 显示的活动路径完全一致——这是同步前唯一可信的基准。
禁用运行时写入，进入安全同步窗口
关闭所有正在运行的 OpenClaw Agent 实例（包括后台网关进程），等待 5 秒后执行 lsof -p $(pgrep -f 'openclaw.*gateway') | grep workspace（macOS/Linux）或资源监视器搜索 workspace 关键字（Windows），确保无任何进程持有该目录下文件句柄。
这一步不可跳过：Windows 上 SQLite 数据库被插件以独占方式锁死时，强行同步会导致 state.db 损坏，下次启动将触发完整重置。
选择同步方式并执行
方法一：使用 Agent Context Sync（推荐）
免提语音助手，支持 OpenClaw ESP32‑S3‑BOX‑3，本地唤醒，可切换 xAI Grok / ElevenLabs 语音识别与合成，无需 Home Assistant。
1. 在任一设备上访问 http://localhost:8080 打开 Agent Context Sync Web 管理界面 → 进入「Workspace 管理」→ 点击「配对新设备」获取一次性配对码。
2. 在其他设备上启动 Agent 时，命令行追加 --sync-token=xxx（xxx 替换为配对码）→ 启动后自动完成增量拉取与本地写入校验。
3. 同步完成后，各设备 workspace/ 下的 AGENTS.md、SOUL.md、skills/ 子目录内容严格一致，plans/ 中的规划任务也按时间戳合并去重。
方法二：手动镜像（仅限离线或调试场景）
将已停机的源 Workspace 目录整体压缩为 workspace.tar.gz，通过加密通道传输至目标设备 → 解压覆盖前，先备份目标 workspace/ 为 workspace.bak → 执行 tar -xzf workspace.tar.gz -C ~/.openclaw/ → 最后运行 openclaw setup --reinit 重建符号链接与沙盒种子。
注意：手动方式不处理 state.db 的事务一致性，仅适用于全新初始化或纯配置文件同步。
验证同步结果
在每台设备上分别执行：find ~/.openclaw/workspace -name "*.md" -exec sha256sum {} \; | sort，比对输出的哈希值列表是否完全相同。
启动 Agent 后，检查会话日志中是否出现 [sync] applied 3 new skills, merged 2 plans 类似提示——说明 Workspace 内容已注入上下文并生效。
