QClaw Mac版需macOS 12+、内测邀请码及微信绑定，安装须解除隔离属性并授权运行，绑定后通过“龙虾”好友验证本地环境。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您已确认使用 Mac 系统部署 QClaw，但安装过程卡顿、无法启动或提示模型加载失败，则可能是由于系统版本不兼容、权限未授权或内测资格未激活所致。以下是针对 Mac 系统的完整安装操作指南：
一、确认系统与内测资格
QClaw Mac 版要求 macOS 12 或更高版本，且必须通过官方渠道获取内测邀请码方可完成激活。未获得邀请码的用户即使下载安装包，也无法进入主界面执行指令。
1、访问内测申请问卷：https://wj.qq.com/s2/25871229/abe7/，填写真实信息并提交；
2、等待审核结果，审核通过后将收到含8位数字邀请码的短信；
3、打开 Safari 浏览器，前往https://claw.guanjia.qq.com/，点击“Mac版下载”按钮获取最新 .dmg 安装包。
二、下载与安装 QClaw
Mac 系统默认阻止来自未知开发者的应用运行，需手动允许安装。QClaw 安装包为标准 .dmg 格式，无需额外配置 Python 或 Docker 环境，所有依赖由安装器自动集成。
1、双击下载完成的 QClaw-Mac.dmg 文件，挂载磁盘映像；
2、将 QClaw 图标拖拽至“应用程序”文件夹中；
3、打开“访达”→“前往”→“实用工具”，运行“终端”；
4、在终端中输入：sudo xattr -rd com.apple.quarantine /Applications/QClaw.app，回车后输入管理员密码（输入时无显示）；
5、右键点击“应用程序”中的 QClaw.app，选择“打开”，在弹出提示中点击“仍要打开”。
三、微信绑定与首次启动
QClaw 启动后需通过微信扫码完成身份核验与设备绑定，该步骤将创建专属“龙虾”好友，并启用远程操控通道。未绑定状态下所有功能均被锁定。
1、启动 QClaw，等待右下角出现微信登录按钮和动态二维码；
2、使用微信扫描二维码，30 秒内完成授权；
3、微信中将自动添加一个名为“龙虾”的好友，头像为红色龙虾图标；
4、点击“龙虾”进入聊天窗口，发送任意文字（如“你好”），若收到自动回复“已连接本地环境”，则绑定成功。
四、处理常见安装异常
部分用户在安装后遇到“无法打开，因为 Apple 无法验证其是否包含恶意软件”或“启动后白屏无响应”等问题，本质是 Gatekeeper 安全策略拦截或模型缓存损坏，可通过以下任一方式恢复：
1、在“系统设置”→“隐私与安全性”底部，查找“已阻止使用……QClaw.app”，点击“仍要打开”；
2、删除残留配置：在终端中执行 rm -rf ~/Library/Application\ Support/QClaw，然后重新启动应用；
3、强制重装模型：启动 QClaw 后点击左上角“QClaw”→“偏好设置”→勾选“清除模型缓存并重新下载”，确认后等待自动完成。
五、验证本地环境就绪
安装与绑定完成后，QClaw 将自动检测本地算力、加载默认大模型（Kimi-K2.5 或 GLM-5），并建立微信通信隧道。此时可测试基础指令响应能力，确认底层服务已正常运行。
1、在微信“龙虾”对话框中发送：“列出当前桌面所有文件夹”；
2、等待约 5–8 秒，QClaw 应返回类似“桌面包含：Downloads、Documents、QClaw_Projects”的结构化文本；
3、若返回“正在初始化环境…”超时未结束，说明 Docker 子系统未就绪，需重启 QClaw 并观察右下角状态栏是否显示绿色“在线”标识。
