旧版QClaw因腾讯终止服务而失效，需升级至v1.0.0-beta.3及以上版本；可临时禁用联网校验维持本地功能，或迁移配置、导出数据供其他前端使用。
如果您已安装旧版qclaw但发现无法启动、连接中断或功能异常，则可能是由于腾讯已终止对旧版本的兼容支持与后端服务维护。以下是确认及应对该情况的具体操作路径：
一、验证当前QClaw版本是否在维护列表内
腾讯自2026年3月10日起已全面暂停旧版QClaw客户端的下载与远程服务接入，仅保留对2026年3月9日24时后发布的正式版（v1.0.0-beta.3及以上）的运行支撑。旧版本虽可本地运行，但其网关通信模块、微信绑定通道及安全隔离房策略均已失效。
1、打开QClaw主界面，点击右上角“帮助”菜单中的“关于QClaw”选项。
2、查看版本号字段，若显示为v1.0.0-alpha.1、v1.0.0-alpha.2或无版本标识，则属于已停用旧版。
3、尝试点击“检查更新”，如弹出“当前版本已停止服务，请前往官网下载最新安装包”提示，则确认失效。
二、强制启用旧版的临时绕过方式
部分用户可通过禁用自动联网校验机制，使旧版QClaw维持基础本地Agent功能，但将丧失微信直连、远程操控、安全拦截等核心能力。
1、关闭QClaw程序，进入安装目录下的config/子文件夹。
2、用文本编辑器打开launcher.conf，将enable_network_check: true改为enable_network_check: false。
3、保存文件后，以管理员权限运行qclaw-launcher.exe（Windows）或QClaw.app/Contents/MacOS/QClaw（macOS）。
4、启动后若界面底部状态栏显示“离线模式｜无微信绑定｜无安全沙箱”，则表示绕过成功但功能受限。
三、迁移至新版QClaw并保留历史配置
新版QClaw支持从旧版无缝迁移任务模板、技能插件路径及本地模型缓存，无需重新下载大体积依赖文件。
1、访问腾讯QClaw官网指定入口（https://qclaw.qq.com/download），下载v1.0.0-beta.3或更高版本安装包。
2、安装过程中勾选“迁移旧版配置与插件”选项，安装程序将自动扫描旧版安装路径。
3、安装完成后首次启动，系统会提示输入原微信绑定手机号，完成身份核验后即可恢复全部远程控制权限。
4、若原绑定手机号已注销或无法接收验证码，可使用“离线重置密钥”功能，该密钥位于旧版data/auth/目录下名为reset.key的文件中。
四、手动提取旧版数据供其他OpenClaw前端调用
当新版QClaw因系统兼容性问题暂不可用时，可将旧版中已训练的技能集、对话记忆库导出为标准OpenClaw兼容格式，供其他前端工具加载。
1、定位旧版QClaw数据目录：%APPDATA%\Tencent\QClaw\data\（Windows）或~/Library/Application Support/Tencent/QClaw/data/（macOS）。
2、复制skills/与memory/两个文件夹至新环境对应OpenClaw的workspace/路径下。
3、在新前端配置文件中添加以下参数段："import_legacy": true, "legacy_path": "./workspace/data_from_qclaw"。
4、重启OpenClaw服务后，控制台将输出“已加载37项技能与214条历史记忆”（具体数值依实际迁移内容而定）。
