前天在公司电脑上装了 QClaw 2.1，手机微信发指令过去，桌面端一点反应都没有。试了好几条指令——“整理桌面文档”、“搜索 PDF”、“打开浏览器”——全都石沉大海。跑去问同事，他用得好好的，同一个版本、同一个网络环境。折腾了快一小时才搞定，这篇文章把整个排查过程写下来，省得你重蹈覆辙。

微信是否真的连上了 PC 端

很多人以为手机微信登了就行，实际上 QClaw 需要 PC 版微信同时在线。打开你 Windows 11 的任务栏，右下角看看有没有微信图标。macOS 14.5 的话检查 Dock 和菜单栏。

PC 版微信如果显示”已退出登录”或者根本没启动，手机端发的指令根本到不了 QClaw。碰到过一种情况：笔记本合盖再打开后，微信自动掉线了但没弹窗提醒。手动重新扫码登录，指令立刻恢复。

还有一种坑：微信在手机上登了两个设备（平板 + 手机），PC 端自动被踢下线。确认只保留手机 + PC 端组合就行。

QClaw 进程是否在运行

Windows 11 下按 Ctrl + Shift + Esc 打开任务管理器，在”进程”标签搜 QClaw。正常情况下应该看到 QClaw.exe 或 QClawService。macOS 用户打开”活动监视器”搜同样的关键词。

我那天遇到的情况是进程确实在跑——但仔细看发现有两个 QClaw 进程残留。一个是旧版 2.0 的后台进程没清干净，一个是新装的 2.1。两个抢端口，结果谁都不干活。

解决办法：关掉所有 QClaw 进程，重新启动一次。Windows 下可以右键”结束任务”，macOS 用”强制退出”。再打开 QClaw 2.1，等托盘图标变绿。

Windows 有个 UAC 弹窗机制，如果 QClaw 安装时没给管理员权限，部分桌面操作执行会失败。右键 QClaw 快捷方式 → 属性 → 兼容性 → 勾选”以管理员身份运行此进程”。

macOS 的坑更隐蔽。系统偏好设置 → 隐私与安全性 → 辅助功能，看看 QClaw 有没有在列表里。如果没有，手动添加并打勾。Ventura 和 Sonoma 每次大版本升级可能会重置这个权限，升完系统记得检查。

另外，如果你公司 IT 部门用了 MDM 管理策略，QClaw 可能被静默限制了进程权限。这种情况需要联系 IT 开白名单。

QClaw 对指令格式有要求。常见错误：

建议先发一条最简单的测试指令，比如”获取系统信息”或”桌面截图”。如果这条指令有回应，说明信道没问题，是你之前的指令写法需要调整。参考 QClaw 使用教程里的标准指令格式。

这个坑比想象的常见。QClaw 2.1 的 PC 端需要配合微信 8.0.x 以上版本。如果你手机微信很久没更新（还是 7.x 版本），消息格式可能不兼容。

检查方法：微信 → 我 → 设置 → 关于微信，看版本号。低于 8.0.43 建议先去应用商店更新。

PC 端的 QClaw 也一样。到 QClaw 下载页确认自己装的是最新正式版，不是从不明渠道拿到的旧安装包。2.0 和 2.1 之间指令协议有调整，混用大概率指令发不通。

我那天最后发现的真正原因就是这个。Windows Defender 防火墙把 QClaw 的本地通讯端口（默认 TCP 18923）给拦了。进程在跑，微信也在线，但数据包到不了 QClaw。

排查步骤：打开 Windows 安全中心 → 防火墙和网络保护 → 允许应用通过防火墙 → 找到 QClaw，把”专用”和”公用”都勾上。

macOS 的防火墙设置在系统偏好设置 → 网络 → 防火墙选项里。把 QClaw 加入”允许传入连接”列表。

如果你装了第三方杀毒软件（360、火绒、Norton、Kaspersky），也要检查它们有没有单独拦截 QClaw 的网络请求。火绒用户特别注意”网络防护”模块，默认会拦截未知进程的本地端口通讯。

碰到 QClaw 指令无反应，按这个顺序排查最快：

90% 的”QClaw 不工作”都出在前三步。如果全部检查完还是没反应，建议卸载 QClaw 后重新从下载页获取最新安装包，干净安装一次。

如果你是从旧版升级上来的，残留配置文档偶尔会冲突。干净安装能解决大部分历史遗留问题。有更复杂的情况，可以到常见问题页查看更多排查手段，或参考 QClaw 无反应排查指南做更系统的诊断。

桌面端安装，微信发指令，随时远程处理任务。