安装阶段 最容易在这里卡住
坑1：Mac 下载了错误的安装包
Apple 芯片（M1/M2/M3）和 Intel 芯片的安装包不能通用。打开方式：左上角苹果 → 关于本机，处理器那里确认再下载。
坑2：被杀毒软件拦截
Windows 上的 Defender 或第三方杀毒软件可能把 QClaw 安装包标记为可疑。临时关闭杀毒软件完成安装，安装后把 QClaw 加入白名单。
坑3：Mac 提示"无法打开，来自未经认证的开发者"
去系统设置 → 隐私与安全性 → 找到"已阻止…"那条提示 → 点仍然允许。
注意：不要从第三方网站下载 QClaw，只从官网 qclaw.qq.com 或本页直链下载，避免安全风险。
微信接入 最高频的失败场景
坑4：手机微信版本太旧
扫码没反应的最常见原因之一。更新手机微信到最新版本再试。
坑5：扫码后一直转圈不成功
通常是网络问题。切换到 WiFi，关掉 VPN，重新退出 QClaw 再扫码。
坑6：绑定成功但微信没有响应
检查 QClaw 是否在后台运行。Mac 用户注意：关掉窗口不等于关掉程序，要确认 Dock 栏里有 QClaw 图标。
日常使用 用了反而更麻烦？
坑7：指令太模糊
"帮我整理文件"效果很差。改成"帮我把桌面上所有.docx文件按月份整理到对应文件夹"，效果立竿见影。
坑8：Skill 装了不会用
Skill 安装后需要在对话中明确呼叫，不是自动激活的。通常说"用[Skill名称]帮我……"触发。
坑9：本地模型太慢就放弃了
切换到在线模型速度会快很多。设置 → 模型 → 选择在线版本。本地模型适合离线场景，不是日常首选。
坑10：以为装好就够了，不更新
QClaw 持续迭代，定期更新能获得新功能和 Bug 修复。关注 更新动态页 了解每次版本变化。
还是搞不定？微信联系 QclawHQ，我们提供一对一安装协助，包踩坑包走通。