QClaw配置迁移需通过三种方式:一、手动复制UserData文件夹;二、单独导出wechat_auth.bin实现微信绑定迁移;三、用qclaw-cli导出/导入JSON格式技能清单。
如果您已完成qclaw的微信绑定、技能启用及个性化设置,但需在新设备上复现相同配置,则需将当前环境的配置数据导出。qclaw未提供图形界面的一键导出入口,但其配置以结构化方式存储于本地,可通过以下多种方式提取与迁移。
一、导出用户配置文件夹(手动复制法)
QClaw将全部用户级配置(含微信绑定信息缓存、ClawHub技能启用状态、自定义快捷指令、任务历史元数据等)集中保存在独立的用户配置目录中。该路径为本地可读写位置,直接复制即可实现完整配置迁移。
1、关闭正在运行的QClaw客户端进程,确保无后台服务占用配置文件。
2、打开文件资源管理器,在地址栏中粘贴并回车以下路径:%APPDATA%\Tencent\QClaw\UserData(Windows系统)或 ~/Library/Application Support/QClaw/UserData(macOS系统)。
3、选中整个 UserData 文件夹,执行复制操作。
4、在目标设备安装同版本QClaw后,于相同路径下替换原 UserData 文件夹(首次启动前替换)。
二、导出微信绑定凭证与会话密钥(扫码迁移法)
微信直连依赖于本地存储的长期凭证(含微信OpenID映射、加密会话密钥及设备指纹绑定标识),该凭证不随UserData文件夹自动同步,需单独提取并注入新设备。此方法适用于仅迁移微信控制能力,无需复刻全部技能配置的场景。
1、在已绑定微信的设备上,进入QClaw安装目录下的 config 子目录(非UserData)。
2、查找名为 wechat_auth.bin 的二进制文件,该文件为加密存储的微信绑定凭证。
3、将 wechat_auth.bin 复制到新设备QClaw安装目录的同名 config 目录中。
4、在新设备首次启动QClaw时,若检测到有效 wechat_auth.bin,将跳过扫码流程,直接恢复微信通信通道。
三、导出ClawHub技能启用清单(JSON导出法)
ClawHub中已启用的5000+ Skills状态由本地SQLite数据库记录,但也可通过QClaw内置命令行工具生成人类可读的启用清单。该清单可用于快速比对或脚本化重装,避免逐个勾选。
1、以管理员权限打开命令提示符(Windows)或终端(macOS)。
2、执行以下命令,调用QClaw内置导出工具:qclaw-cli export-skills --format=json > enabled_skills.json。
3、确认当前目录下生成了 enabled_skills.json 文件,其中包含所有启用Skill的ID、名称及启用时间戳。
4、在新设备安装QClaw并完成基础初始化后,执行导入命令:qclaw-cli import-skills --file=enabled_skills.json。










