QClaw异常停止响应时，应依次执行五步排查：一、重启本地服务进程；二、重新扫码绑定微信账号；三、切换并重载轻量AI模型；四、放行防火墙对QClaw端口的拦截；五、清理缓存并重置配置目录。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您在使用QClaw过程中发现其突然停止响应、无法接收微信指令或本地任务执行中断，则可能是由于本地服务进程异常、微信绑定失效、模型加载失败或系统资源冲突所致。以下是针对该问题的多种故障处理方法：
一、重启QClaw本地服务进程
QClaw以本地守护进程形式运行，若主程序崩溃或被系统终止，将导致微信端指令无响应。强制重启可恢复服务监听状态，并重新加载已配置的模型与微信会话上下文。
1、在Windows系统中，按下 Ctrl + Shift + Esc 打开任务管理器，切换到“进程”选项卡。
2、在进程列表中找到名为 QClaw.exe 或 openclaw-agent 的条目。
3、右键点击该进程，选择“结束任务”；确认所有相关子进程（如 kimi-runtime）一并终止。
4、双击桌面或安装目录下的 QClaw启动器.exe 重新运行程序，等待状态栏显示“已就绪”且微信端出现绿色在线标识。
二、重新扫码绑定微信账号
微信会话Token可能因长时间未通信、微信客户端升级或网络中断而过期，导致QClaw无法校验身份，从而拒绝执行任何指令。重新绑定可刷新长期有效的OAuth凭证。
1、打开QClaw主界面，点击右上角齿轮图标进入“设置”页。
2、在“微信集成”区域点击 解绑当前账号，确认清除全部会话数据。
3、点击 立即绑定，屏幕弹出二维码，使用手机微信“扫一扫”功能扫描。
4、在微信弹出的授权页面中点击“允许”，等待QClaw界面提示 绑定成功，正在同步会话历史。
三、切换内置AI模型并重载
QClaw默认加载Kimi-2.5模型，若该模型文件损坏、显存不足或CUDA驱动不兼容，会导致推理服务挂起，进而使整个Agent无响应。切换至轻量级模型可绕过当前加载瓶颈。
1、进入QClaw设置页，下拉至“AI模型”模块。
2、在下拉菜单中选择 GLM-4-9B-Chat（CPU模式） 或 DeepSeek-VL-7B（量化版）。
3、勾选 启用模型热替换，点击“应用并重载”按钮。
4、观察底部状态栏是否出现 模型加载中… 2/3 进度提示，待提示变为 模型就绪，服务已恢复 后测试指令。
四、检查本地防火墙与安全软件拦截
部分杀毒软件或Windows Defender会将QClaw的本地HTTP服务端口（默认为8080）识别为可疑监听行为并主动阻断，造成微信无法回调指令结果。临时放行可验证是否为此类策略干扰。
1、在Windows搜索栏输入“Windows安全中心”，打开后点击“防火墙和网络保护”。
2、点击“允许应用通过防火墙”，再点击右上角“更改设置”获取管理员权限。
3、在应用列表中查找 QClaw 或 openclaw-agent，确保其在“专用”和“公用”网络前均打勾。
4、若未列出，点击“允许其他应用”，浏览至QClaw安装目录，添加 QClaw.exe 和 agent-service.exe。
五、清理本地缓存与重置配置目录
QClaw运行时生成的临时会话缓存、日志碎片或损坏的config.yaml可能导致初始化失败，表现为启动后立即退出或界面空白。彻底清除用户级配置可强制重建运行环境。
1、关闭QClaw所有进程，包括后台隐藏任务。
2、按下 Win + R，输入 %APPDATA%\QClaw（Windows）或 ~/Library/Application Support/QClaw（macOS），回车打开配置目录。
3、将整个文件夹重命名为 QClaw_backup_日期，保留原始数据用于回溯。
4、重新运行QClaw安装包中的启动器，程序将自动生成全新配置目录，并提示进行首次微信绑定。
