QClaw指令无响应时，需依次检查主进程存活、服务端口监听状态、重启主服务、强制终止并重启全部进程、重置配置文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您向QClaw发送了指令（例如“打开浏览器”或“1分钟后提醒我”），但未收到任何响应、无弹窗、无微信消息、无本地动作执行，则可能是QClaw后台服务未正常运行或进程异常中断。以下是排查与恢复QClaw指令响应能力的具体操作步骤：
一、检查QClaw主进程是否存活
QClaw依赖本地后台进程持续监听指令，若进程意外退出，所有指令将无法被接收和执行。需确认其核心进程是否仍在运行。
1、在Windows系统中，按下Ctrl + Shift + Esc打开任务管理器；
2、切换至“详细信息”选项卡；
3、在进程列表中查找名为QClaw.exe或qclaw-main-process的条目；
4、若未找到该进程，说明后台服务已停止；若存在但CPU/内存占用为0%，需进一步验证其响应性。
二、验证QClaw服务端口监听状态
QClaw默认通过本地HTTP服务（通常为端口8080或9090）与微信前端及内部模块通信。端口未监听即代表服务未启动或被占用。
1、在Windows中，以管理员身份打开命令提示符（CMD）或PowerShell；
2、输入命令：netstat -ano | findstr :8080（若配置为其他端口，请替换对应数字）；
3、若无任何输出，表明QClaw未成功绑定端口；
4、若有输出但PID对应进程非QClaw.exe，说明端口被其他程序占用，需终止冲突进程或修改QClaw端口配置。
三、重启QClaw主服务（图形界面方式）
适用于未崩溃但响应停滞的场景，通过GUI触发软重启可重载配置并恢复指令链路，无需关闭微信关联状态。
1、点击系统右下角任务栏中的QClaw图标（通常为蓝色龙虾LOGO）；
2、在弹出菜单中选择“重新加载服务”或“Restart Core Service”；
3、等待右下角出现绿色提示：“Service reloaded successfully”；
4、立即在微信中发送一条测试指令（如“你好”），观察是否触发回复。
四、强制终止并重启全部QClaw进程（命令行方式）
当图形界面无响应或托盘图标消失时，需通过命令行彻底清理残留进程，确保服务从干净状态启动。
1、以管理员身份打开PowerShell；
2、执行命令：taskkill /f /im QClaw.exe；
3、再执行命令：taskkill /f /im qclaw-node-host.exe（该进程承载AI模型调度与工具调用）；
4、确认无残留后，双击桌面或开始菜单中的QClaw快捷方式重新启动应用；
5、启动完成后，等待左下角弹出“微信配置就绪”提示框，再进行指令测试。
五、重置QClaw本地服务配置文件
配置文件损坏可能导致服务初始化失败，尤其在升级后或手动修改过config.json的情况下。重置可恢复默认服务行为。
1、关闭QClaw所有进程（包括托盘进程）；
2、进入QClaw安装目录下的config/子文件夹；
3、将service-config.json重命名为service-config.json.bak；
4、重新启动QClaw，程序将自动生成全新默认配置文件；
5、首次启动后，微信二维码会重新生成，需再次扫码完成授权绑定。
