必须通过官方导出与结构化还原机制迁移QClaw项目:Mac端导出含skills/、agents/、workspace/的zip包,Windows端跳过初始部署后拖拽导入,选择性合并并补全辅助功能、完全磁盘访问权限及微信重新绑定。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想把Mac上已配置好的QClaw项目(含自定义技能、对话记录、模型偏好和Agent工作区)完整迁移到Windows电脑上继续使用,但担心路径差异、权限缺失或技能失效——这不是简单复制粘贴能解决的问题,必须通过官方支持的状态导出与结构化还原机制来完成。
从Mac导出全量项目状态包
打开macOS端已登录且微信授权成功的QClaw主程序,确保当前处于正常运行状态,未弹出任何错误提示框。
点击左上角菜单栏“设置” → “高级选项” → “导出项目状态”,该路径仅在微信绑定成功后才可见。
勾选“包含技能包启用状态”“保留对话时间线索引”“同步模型切换历史”三项——【不勾选这三项会导致技能丢失、对话断层、模型回退到默认版本】。
点击“生成状态包”,等待进度条走完。生成的zip文件会自动保存至~/Documents/QClaw/exports/目录,文件名形如qclaw-state-export-20260612-094533.zip。
导出完成后,手动检查压缩包内是否包含skills/、agents/、workspace/三个核心目录;若缺失任一目录,说明导出过程被后台进程中断,需重启QClaw后重试。
在Windows端初始化空实例
访问 https://qclaw.qq.com ,下载Windows版安装包QClaw-Setup-latest.exe。
双击运行安装程序,全程点击“下一步”,保持默认安装路径(C:\Program Files\QClaw),【切勿勾选“启动QClaw并登录微信”】。
安装完成后,直接双击桌面快捷方式启动QClaw——此时会进入欢迎界面,选择“跳过初始部署,等待导入状态”。
这一步跳过的是Windows专属的Docker代理配置与Node.js环境注入流程,避免与即将导入的Mac状态包冲突。
执行跨平台结构化导入
将Mac导出的qclaw-state-export-*.zip文件复制到Windows电脑任意位置(如桌面)。
通过 SSH 隧道从 Android 设备在互联网上对 Windows PC 实现完整远程控制的设置与使用指南,适用于远程桌面访问、安全 RDP 等。
在Windows端QClaw主界面中,直接将该zip文件拖拽至窗口中央空白区域,松手后自动触发导入检测。
系统会解析压缩包元数据并弹出整合模式选择窗口:
方法一:完整替换——覆盖Windows端所有本地配置,包括已安装的Skill、定时任务、微信绑定关系;适用于全新迁移场景。
方法二:选择性合并——只合并指定模块,例如仅导入skills/目录下的Python脚本与workspace/中的Jupyter Notebook工程,保留Windows端原有的飞书通知配置和钉钉机器人Token。
选择“选择性合并”后,勾选“agents”“skills”“workspace”三项,取消勾选“identity”与“cron”——【identity含设备唯一标识,跨平台强制复用会导致微信绑定失效】。
点击“确认导入”,等待状态校验完成(约40秒),界面右下角出现绿色对勾图标即表示导入成功。
补全不可序列化项
导入完成后,立即前往Windows设置面板,手动授予三项关键权限:
第一步:打开“设置 → 隐私与安全 → 辅助功能”,在应用列表中找到QClaw并开启开关。
第二步:进入“完全磁盘访问”,同样启用QClaw权限——【缺少此项权限会导致文件整理、Excel读写等功能全部报错】。
第三步:回到QClaw主界面,点击左下角微信图标旁的“重新绑定”,用手机微信扫码完成新设备授权。
绑定成功后,微信对话框中会出现新联系人“龙虾-台式机”(或你自定义的备注名),此时即可发送指令验证迁移效果,例如:“列出我workspace里最近修改的三个Notebook文件”。

















