Troubleshooting

排查问题

QClaw 绑定失败、没有响应、任务跑偏的排查步骤。

发布时间 2026-03-20更新时间 2026-03-206 个章节1211 分钟阅读
绑定失败没反应排障

绑定微信失败

按以下顺序检查:

  1. 确认电脑当前可以正常联网
  2. 退出 QClaw,重新打开
  3. 在客户端里重新生成二维码
  4. 用微信重新扫码

大部分绑定失败都是网络问题或二维码过期,按上面步骤操作基本能解决。


发了指令,QClaw 没反应

先检查这几项:

  • 电脑是否开机并联网?
  • QClaw 客户端是否正在运行?
  • 权限是否已开启(首次使用可能需要授权)?

然后发一条最简单的测试消息:

帮我回复一句"收到"。

如果连这条都没回应,说明链路本身有问题,和指令内容无关。先按上面的项目逐一排查。


消息收到了,但任务没有执行

检查以下几点:

  • 目标文件 / 目录是否真实存在?路径是否正确?
  • 是否有访问该文件的权限?
  • 指令是否足够具体?

把模糊指令改成具体的:

不够具体更清晰的写法
帮我看一下文档读取桌面的「项目说明.docx」,提炼 3 个要点,不要修改文件
帮我处理一下文件把桌面的图片按日期归类到文件夹,返回每个文件夹的文件数量

执行结果跑偏

通常是指令范围太宽导致的。写指令时尽量包含以下四个要素:

帮我 [动作],[对象] 在 [位置],不要 [哪些操作],完成后输出 [什么格式]。

例如:

帮我整理桌面的图片,按项目名称归到子文件夹,不要删除原文件,完成后告诉我每个文件夹有多少张。

快速诊断表

现象先排查建议操作
绑定失败网络、客户端、二维码重新生成二维码再扫
发消息完全没回应电脑是否联网、客户端是否运行发一条最简单的测试消息
消息有回应但任务没执行文件路径、权限换一个小任务验证
执行结果跑偏指令是否太模糊补充对象、位置、限制条件

FAQ

一直绑定失败,除了扫码还能用别的方式吗?

目前微信绑定依赖扫码,没有其他备用方式。如果反复失败,建议到官方文档或社区提问,描述网络环境和系统版本。

QClaw 报错了,怎么找错误信息?

打开 QClaw 客户端,在设置或日志选项里可以查看运行日志,提交给官方支持时附上日志会更容易定位问题。