Troubleshooting
排查问题
QClaw 绑定失败、没有响应、任务跑偏的排查步骤。
发布时间 2026-03-20更新时间 2026-03-206 个章节121 字1 分钟阅读
绑定失败没反应排障
绑定微信失败
按以下顺序检查:
- 确认电脑当前可以正常联网
- 退出 QClaw,重新打开
- 在客户端里重新生成二维码
- 用微信重新扫码
大部分绑定失败都是网络问题或二维码过期,按上面步骤操作基本能解决。
发了指令,QClaw 没反应
先检查这几项:
- 电脑是否开机并联网?
- QClaw 客户端是否正在运行?
- 权限是否已开启(首次使用可能需要授权)?
然后发一条最简单的测试消息:
帮我回复一句"收到"。
如果连这条都没回应,说明链路本身有问题,和指令内容无关。先按上面的项目逐一排查。
消息收到了,但任务没有执行
检查以下几点:
- 目标文件 / 目录是否真实存在?路径是否正确?
- 是否有访问该文件的权限?
- 指令是否足够具体?
把模糊指令改成具体的:
| 不够具体 | 更清晰的写法 |
|---|---|
| 帮我看一下文档 | 读取桌面的「项目说明.docx」,提炼 3 个要点,不要修改文件 |
| 帮我处理一下文件 | 把桌面的图片按日期归类到文件夹,返回每个文件夹的文件数量 |
执行结果跑偏
通常是指令范围太宽导致的。写指令时尽量包含以下四个要素:
帮我 [动作],[对象] 在 [位置],不要 [哪些操作],完成后输出 [什么格式]。
例如:
帮我整理桌面的图片,按项目名称归到子文件夹,不要删除原文件,完成后告诉我每个文件夹有多少张。
快速诊断表
| 现象 | 先排查 | 建议操作 |
|---|---|---|
| 绑定失败 | 网络、客户端、二维码 | 重新生成二维码再扫 |
| 发消息完全没回应 | 电脑是否联网、客户端是否运行 | 发一条最简单的测试消息 |
| 消息有回应但任务没执行 | 文件路径、权限 | 换一个小任务验证 |
| 执行结果跑偏 | 指令是否太模糊 | 补充对象、位置、限制条件 |
FAQ
一直绑定失败,除了扫码还能用别的方式吗?
目前微信绑定依赖扫码,没有其他备用方式。如果反复失败,建议到官方文档或社区提问,描述网络环境和系统版本。
QClaw 报错了,怎么找错误信息?
打开 QClaw 客户端,在设置或日志选项里可以查看运行日志,提交给官方支持时附上日志会更容易定位问题。