新版QClaw配置丢失是因采用独立目录与加密存储机制；需按路径确认、手动迁移基础参数、恢复微信会话、转换任务模板及直迁SQLite数据库五步操作完成兼容性升级。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您已使用旧版 QClaw 或 OpenClaw 配置了微信绑定、任务模板、模型路由等参数，但升级至新版 QClaw 后发现配置丢失或无法自动继承，则可能是由于新版采用独立配置目录与加密存储机制。以下是兼容性验证与迁移操作步骤：
一、确认配置文件路径差异
新版 QClaw（v2026.3.10 起）将用户配置与运行时数据分离存储，旧版 OpenClaw 的 ~/.openclaw 目录结构不再被直接读取。新版默认使用加密的 SQLite 数据库存储微信会话密钥、远程控制权限及指令历史，原始 JSON 配置文件（如 config.yaml）仅用于初始化，不参与运行时决策。
1、打开文件管理器，定位旧版配置目录：Windows 用户检查 %USERPROFILE%\.openclaw，macOS/Linux 用户检查 ~/.openclaw。
2、在该目录中查找是否存在 config.yaml、wechat_token.bin、tasks/ 子目录三项内容。
3、新建文本文件，命名为 check_old_version.txt，将以下命令粘贴并执行（Windows PowerShell）：Get-Content "$HOME\.openclaw\config.yaml" -ErrorAction SilentlyContinue | Select-String "version"。
二、手动提取可复用配置项
并非所有旧配置都失效，部分基础参数仍可通过格式转换导入新版。新版 QClaw 支持通过环境变量或启动参数注入初始配置，其中模型端点地址、默认浏览器路径、定时任务间隔等纯文本字段可安全复用。
1、用记事本打开旧版 config.yaml，复制 model_endpoint: 行及其后续两行（含 URL 与 headers）。
2、新建文件 config_override.json，粘贴如下结构并填入上一步复制的内容：{"model":{"endpoint":"https://xxx","headers":{"Authorization":"Bearer xxx"}}}。
3、启动新版 QClaw 时附加参数：--config-override ./config_override.json（Windows 命令提示符下需用双引号包裹路径）。
三、微信绑定状态迁移
微信扫码绑定信息属于强加密会话凭证，无法跨版本导出导入。但无需重新扫码，新版支持从旧版内存镜像中提取未过期 Token。该操作仅限同一设备、同一 Windows 用户账户或 macOS 登录用户执行。
1、确保旧版 QClaw 已完全退出（任务管理器中无 clawd.exe 或 QClaw 进程）。
2、在旧版安装目录中查找 clawd/ 子文件夹，进入后定位名为 wechat_session_v1.enc 的文件。
3、将该文件复制到新版 QClaw 安装目录同级的 migrate/ 文件夹中（若不存在则手动创建）。
4、首次启动新版 QClaw 时，界面左下角弹窗将显示“检测到可恢复微信会话”，点击“立即恢复”按钮。
四、任务模板批量转换
旧版 OpenClaw 的 tasks/ 目录下 .task 文件为纯文本 YAML 格式，新版 QClaw 的任务引擎兼容该格式，但要求增加 version 字段声明。缺失该字段将导致任务加载失败且无错误提示。
1、进入旧版 ~/.openclaw/tasks/ 目录，列出所有以 .task 结尾的文件。
2、对每个文件执行批量插入操作：在文件首行添加 version: "2.0"（注意冒号后保留一个空格）。
3、将全部修改后的 .task 文件复制到新版 QClaw 的 %APPDATA%\QClaw\tasks\（Windows）或 ~/Library/Application Support/QClaw/tasks/（macOS）。
五、SQLite 配置数据库直迁（高级）
若旧版为 OpenClaw v2026.2.9 及以上，其 ~/.openclaw/qclaw.db 文件结构与新版兼容。此方法跳过所有格式校验，直接复用历史会话、消息记录与权限策略，但要求新旧版本主版本号一致（即均为 2026.x 系列）。
1、关闭所有 QClaw 相关进程，包括后台服务 clawd。
2、重命名新版默认数据库：将 %APPDATA%\QClaw\qclaw.db 改为 qclaw.db.new。
3、将旧版 ~/.openclaw/qclaw.db 复制到新版数据库目录，并重命名为 qclaw.db。
4、启动新版 QClaw，观察系统托盘图标是否显示绿色对勾——出现即表示数据库加载成功。
