Appearance
12. Qclaw 本地安装指南（macOS 版，内测版零基础适用）
适用对象：第一次接触 Qclaw 的普通用户，无需编程基础 | 文档版本：V1.0 更新日期：2026 年 3 月 11 日 | 文档定位：Qclaw macOS 内测版安装主线文档
一、先说结论
截至 2026 年 3 月 11 日，Qclaw 仍处于邀请制内测。macOS 版可用，需要邀请码。
| 你的情况 | 建议 |
|---|---|
| 有邀请码，手上是 Mac | 可以继续往下安装 |
| 没邀请码，但想先了解流程 | 可以先看完本文，再等资格 |
| 你是 Windows 用户 | 先等官方开放 Windows 版 |
二、Qclaw 是什么
Qclaw 是围绕 OpenClaw 做了产品化封装的桌面端 AI 助手，一键安装、内置模型，可通过微信/QQ 等入口远程给电脑下指令。
三、安装前准备
- 一台 Mac（Apple 芯片或 Intel 芯片）
- 可正常上网的网络环境
- 邀请码或内测资格
- 一个常用的微信 / QQ 账号
四、确认芯片类型并下载
点击屏幕左上角苹果菜单（Apple 菜单） → 关于本机 → 处理器。Intel 选 x64 版，Apple 芯片（M1/M2/M3/M4）选 ARM 版。
从官网下载对应版本：https://claw.guanjia.qq.com/
五、安装与启动
双击下载的安装包。.dmg 格式：将 Qclaw 图标拖入 Applications 文件夹。.pkg 格式：按提示点击继续 → 同意 → 安装 → 输入密码 → 完成。
启动方式：打开应用程序中的 Qclaw，或按 Command + 空格 搜索 Qclaw 回车。首次启动需扫码绑定微信，菜单栏出现 Qclaw 图标即进入可用状态。
六、第一次打开时常见提示
6.1 提示"应用来自互联网，是否打开"
这是 macOS 正常安全提示，点击【打开】。若无此按钮，去系统设置 → 隐私与安全性 → 点击【仍要打开】。
6.2 提示"无法验证开发者"或"已损坏"
确认安装包来自官网 claw.guanjia.qq.com，删除后重新下载，到"隐私与安全性"里查看是否是系统拦截。
6.3 打开后闪退
先确认芯片版本是否下载正确，重启 Mac 再试，或升级 macOS 版本后重新下载。
七、首次登录与激活
- 准备好邀请码
- 按页面提示登录账号或扫码绑定
- 输入邀请码或完成内测资格验证
- 等待客户端初始化
如果提示"暂无资格"或"邀请码无效"，这是资格校验未通过，不是安装失败。
八、安装后建议
8.1 允许必要权限
如果 Qclaw 需要读取文件、发送通知、访问麦克风或辅助功能，请按提示授权。常见位置：系统设置 → 隐私与安全性 / 通知 / 辅助功能。按"需要时再授权"即可。
8.2 先不要把重要数据直接交给它处理
建议先拿测试文件试用，确认稳定后再处理正式资料。
九、常见问题
Q1：我安装好了，但进不去，是不是装错了？
区分三种情况：
- 程序根本打不开：多半是安装包版本不对或系统拦截
- 程序能打开但无法登录：多半是账号或邀请码问题
- 程序能登录但功能异常：多半是内测版本问题
Q2：Qclaw 和 OpenClaw 是一回事吗？
不是。OpenClaw 更偏开源、自部署、可自己配置模型和环境；Qclaw 更偏成品桌面客户端，像普通软件一样安装使用。