QClaw配置意外重置可按四步恢复：一、从%APPDATA%\QClaw\backup\latest（Win）或~/Library/Application Support/QClaw/backup/latest（macOS）手动覆盖config目录；二、微信发送/restore config last并扫码确认回滚；三、通过“高级配置→导入OpenClaw配置”读取~/.openclaw/config.yaml重建模型关联；四、右键微信图标解除绑定后重新扫码，保留本地技能包与模型缓存。
如果您在使用qclaw过程中发现原有配置（如模型设置、微信绑定状态、技能包启用项或openclaw数据关联关系）被意外覆盖或重置，则可能是由于重复执行一键部署、手动清空本地数据目录、升级覆盖安装，或系统权限异常导致配置文件写入失败。以下是恢复qclaw配置的多种可行方法：
一、从本地备份目录手动还原配置
QClaw在首次成功部署后，会自动生成一份完整配置快照并保存于用户本地特定路径，该路径独立于安装目录，不受重装影响。只要未主动删除该目录，即可直接恢复全部历史配置。
1、打开文件管理器，在地址栏中粘贴并访问以下路径：%APPDATA%\QClaw\backup\latest（Windows）或 ~/Library/Application Support/QClaw/backup/latest（macOS）。
2、确认该目录下存在以时间戳命名的子文件夹（例如 20260310_142235），且内部包含 config.json、wechat_auth.dat 和 skills_state.bin 等关键文件。
3、关闭正在运行的QClaw进程（可在任务管理器或活动监视器中结束名为 QClaw.exe 或 QClaw 的进程）。
4、将目标备份子目录中的全部文件，复制并覆盖至主配置目录：%APPDATA%\QClaw\config\（Windows）或 ~/Library/Application Support/QClaw/config/（macOS）。
5、重新启动QClaw应用，配置即刻恢复，微信绑定状态与模型选择将保持与备份时刻完全一致。
二、通过微信端指令触发配置回滚
QClaw内置微信通道级配置快照机制，当检测到主配置异常时，可自动调用最近一次微信授权成功后的环境快照进行轻量级回滚，无需退出应用或操作文件系统。
1、在已绑定的微信对话窗口中，向QClaw发送纯文本指令：/restore config last。
2、等待约8–12秒，QClaw将在微信中回复一条含二维码的提示消息，标题为“配置回滚确认”。
3、使用同一台已绑定微信的手机扫描该二维码，并点击弹出页面中的“确认回滚”按钮。
4、QClaw客户端界面右下角将显示绿色提示：“配置已回滚至2026-03-14 19:07:22状态”，所有模型路由、技能启用状态及远程操控权限同步复原。
三、利用OpenClaw原始配置文件重建关联
若QClaw曾成功关联过OpenClaw旧实例，其原始配置（包括API密钥、模型端点、代理设置等）仍完整保留在OpenClaw默认配置路径中。QClaw支持从该路径强制读取并覆盖当前配置，适用于因误操作导致模型切换失效或API调用中断的场景。
1、确保本地已安装且曾正常运行过OpenClaw，其配置文件位于：~/.openclaw/config.yaml（Linux/macOS）或 %USERPROFILE%\.openclaw\config.yaml（Windows）。
2、启动QClaw后，点击主界面左上角齿轮图标，选择“高级配置”→“导入OpenClaw配置”。
3、在弹出窗口中点击“浏览”，定位并选中上述 config.yaml 文件，勾选“覆盖当前模型路由”与“同步API密钥”选项。
4、点击“立即导入”，QClaw将解析该文件中的 llm_provider、api_base 和 api_key 字段，并写入当前运行时配置。
5、重启QClaw客户端，模型列表将刷新为OpenClaw原有配置所指定的全部可用模型，Kimi-2.5默认项将被临时禁用，直至手动切换。
四、重置微信绑定并保留本地执行环境
当微信授权状态丢失（如微信账号注销、设备更换、Token过期）导致QClaw无法接收指令，但本地任务引擎、技能包和文件操作权限仍完好时，可单独重置微信通道而不影响其余配置。该方式避免全量重部署带来的模型缓存清除与技能重载延迟。
1、在QClaw主界面底部状态栏，右键点击微信图标，选择“解除微信绑定”。
2、确认弹窗中提示的“仅断开微信连接，不删除本地配置文件”选项处于启用状态。
3、点击“确定”后，QClaw将保留 %APPDATA%\QClaw\exec\ 目录下的全部脚本缓存、skills\ 子目录中的已启用技能包，以及 models\cache\ 中的本地模型权重。
4、点击界面左下角新出现的“重新绑定微信”按钮，扫描生成的动态二维码。
5、完成微信授权后，QClaw将自动加载此前保存的微信会话上下文ID，并恢复所有远程指令接收能力，本地执行链路毫秒级就绪。
