QClaw与OpenClaw数据双向同步有四种方法：一、一键关联本地龙虾，自动扫描标准路径并提示关联；二、手动指定非标路径的配置根目录；三、通过符号链接桥接锁定目录；四、导出导入config.yaml及skills文件夹实现离线迁移。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您已安装本地 OpenClaw（“龙虾”），但在使用 QClaw 时发现历史配置、Skills 或对话记录未自动出现，则可能是同步机制未触发或路径识别失败。以下是实现 QClaw 与原有 OpenClaw 数据双向同步的具体方法：
一、一键关联本地龙虾（自动路径识别）
QClaw 启动时会主动扫描常见安装路径（如 %APPDATA%\OpenClaw、~/Library/Application Support/OpenClaw、$HOME/.openclaw），若检测到有效配置目录，将提示“发现本地龙虾，是否关联？”。该方式直接复用原 config.yaml、skills/、plugins/ 及 logs/ 目录，避免重复配置。
1、双击运行 QClaw 安装后生成的主程序。
2、在初始界面等待约3秒，弹出提示框显示“检测到本地 OpenClaw 配置，点击【关联】即可同步全部数据”。
3、点击【关联】按钮，QClaw 自动挂载原 config.yaml 并加载 skills 列表。
4、重启 QClaw 主界面，左侧栏即显示与原 OpenClaw 完全一致的对话流与群聊会话ID。
二、手动指定 OpenClaw 配置根目录
当 OpenClaw 被安装在非标准路径（如自定义解压目录、Docker volume 挂载点或 WSL 子系统内），QClaw 默认扫描将失效。此时需通过高级设置强制指定配置根路径，使 QClaw 将其视作等效工作区。
1、启动 QClaw 后，点击左上角「设置」→「高级」→「指定 OpenClaw 根目录」。
2、在弹出文件选择框中，定位并选中包含 config.yaml 的最外层文件夹（例如 D:\openclaw-dev\ 或 /mnt/c/openclaw-test/）。
3、点击确认后，QClaw 立即读取该路径下的 skills/、plugins/ 和 logs/ 子目录。
4、在设置页底部点击「重载配置并同步」，界面右下角显示“同步完成：共加载XX个Skill，XX条历史会话”。
三、符号链接强制桥接（Windows/macOS/Linux 通用）
适用于 OpenClaw 以服务形式运行（如 systemd、launchd 或 Windows Service），其配置目录被锁定或权限受限的情形。通过创建符号链接，使 QClaw 认为配置位于标准路径，从而绕过权限校验与路径白名单限制。
1、关闭正在运行的 OpenClaw 服务及 QClaw 主程序。
2、在终端或命令提示符中执行对应命令：
Windows（管理员权限）：mklink /J "%APPDATA%\OpenClaw" "C:\path\to\your\real\openclaw\config"
macOS/Linux：ln -sf /your/real/openclaw/config ~/.openclaw
3、重新启动 QClaw，无需任何手动操作，自动识别符号链接指向的真实配置目录。
4、验证同步效果：进入 QClaw 的「技能管理」页，检查列表中是否完整显示原 OpenClaw 已启用的 Skill 名称及状态图标。
四、导出导入 config.yaml + skills 子目录（离线迁移）
当两套环境完全隔离（如一台机器跑 OpenClaw，另一台仅装 QClaw 且无网络互通），无法实时挂载时，可采用配置文件级迁移。此方式确保 Skills 行为逻辑、模型参数、渠道 token 全量一致，但不继承实时对话记录。
1、在原 OpenClaw 所在机器上，定位并复制整个 config.yaml 文件及 skills/ 文件夹（含所有 .yml 和 .py 文件）。
2、在 QClaw 所在机器上，打开其安装目录下的 resources/default-config/ 子目录。
3、将复制的 config.yaml 替换该目录下同名文件；将 skills/ 文件夹整体覆盖至 resources/default-config/skills/。
4、启动 QClaw，首次运行时勾选「使用 resources/default-config 下的配置初始化」，完成离线同步。
