qclaw本地部署需按系统选择正确安装包并完成权限授权：windows一键安装含运行时，macos需绕过gatekeeper并授予权限；异常时可用/repair-env指令、端口排查或重置权限修复。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在个人电脑上运行QClaw并完成本地化部署，但尚未成功启动或绑定微信，则可能是由于系统版本不兼容、安装包选择错误、权限未授予或首次启动流程中断所致。以下是针对Windows与macOS两大平台的独立部署路径：
一、Windows系统部署流程
Windows版QClaw采用全集成式安装包，自动嵌入Node.js运行时、轻量Docker代理及模型推理引擎，无需用户手动配置环境变量或安装依赖组件。安装过程以向导驱动，全程静默部署关键服务。
1、访问官方下载地址 https://qclaw.qq.com/，页面将自动识别系统为Windows，点击“Windows版下载”按钮获取QClaw-Setup-latest.exe安装程序。
2、双击运行该.exe文件，弹出许可协议界面后点击“我同意”，进入标准安装向导。
3、保持默认安装路径（通常为C:\Program Files\QClaw），不勾选任何可选组件，直接点击“安装”按钮。
4、等待进度条完成（约150秒），期间窗口中会依次显示“正在安装 Node.js”“正在配置 Docker 代理”“正在加载本地模型运行时”等提示，切勿关闭窗口或强制终止进程。
5、安装完成后，勾选“启动QClaw并登录微信”，点击“完成”按钮，系统将自动拉起QClaw主程序并显示微信扫码登录界面。
二、macOS系统部署流程
Mac版QClaw适配Apple Silicon（M1/M2/M3）与Intel芯片双架构，安装后默认调用国产轻量大模型，所有指令解析与执行均在本地完成。因macOS安全机制限制，需手动绕过Gatekeeper验证并授权系统权限。
1、访问 https://qclaw.qq.com/，根据设备芯片类型选择对应版本：Apple芯片用户下载QClaw-latest-arm64.dmg，Intel芯片用户下载QClaw-latest-x64.dmg。
2、双击打开下载的.dmg文件，将QClaw图标拖拽至“应用程序”文件夹内。
3、前往“访达 → 应用程序”，右键点击QClaw图标，选择“打开”；在弹出的提示框中点击“仍要打开”，完成Gatekeeper绕过。
4、首次启动时，系统将依次请求“辅助功能”“完全磁盘访问”“输入监控”三项权限，必须全部允许，否则无法执行文件操作与自动化任务。
5、授权完成后，QClaw自动显示微信二维码，使用已实名认证的微信“扫一扫”完成绑定，绑定成功后微信对话框中将出现「QClaw 助手」联系人。
三、部署异常处理路径
若安装完成后无法启动、托盘无图标、扫码无响应或控制台日志缺失关键状态标识，说明底层环境初始化失败。QClaw提供三类独立修复机制，可按顺序尝试：
1、在微信中向「QClaw 助手」发送指令：/repair-env --force，触发后台强制重装运行时环境，耗时约90秒。
2、手动检查端口占用：打开命令提示符（Windows）或终端（macOS），执行 netstat -ano | findstr :18789（Windows）或 lsof -i :18789（macOS），如发现PID冲突，结束对应进程后重启QClaw。
3、重置权限与缓存：Windows用户进入设置 → 隐私和安全性 → 重置“辅助功能”与“文件系统访问”权限；macOS用户前往系统设置 → 隐私与安全性 → 点击对应权限项右侧“详情”，移除QClaw后重新授权。
