需先下载安装QClaw官方包并完成微信绑定，再点击“一键启动OpenClaw”，访问http://localhost:18789验证；若失败则排查端口占用、防火墙或重装网关，亦可接管已有OpenClaw实例。
如果您希望在个人电脑上运行 qclaw 并启动 openclaw，但尚未完成本地环境配置，则可能是由于系统依赖缺失、安装流程中断或权限设置不当所致。以下是完成 qclaw 本地部署的具体操作路径：
一、下载并运行官方安装包
QClaw 官方安装包已集成全部运行时依赖，无需手动安装 Node.js、Docker 或 Python 环境，安装过程自动完成检测与配置。该步骤确保基础运行框架就绪。
1、访问 QClaw 官方内测入口：https://claw.guanjia.qq.com/。
2、根据操作系统选择对应安装包：Windows 用户下载 QClaw-Windows-Setup.exe，macOS 用户下载 QClaw-Mac.dmg。
3、双击安装包，全程点击“下一步”“我同意”“安装”，**切勿中途关闭弹窗**，等待自动完成 Node.js、Docker 及网关服务的部署（耗时约 2–3 分钟）。
4、安装结束时勾选“立即运行 QClaw”，点击“完成”启动主程序。
二、微信扫码绑定远程控制通道
绑定微信是启用 QClaw 远程指令能力的前提，该操作将生成专属“龙虾”好友，并建立安全通信隧道，所有指令均经微信加密信道下发至本地服务。
1、启动 QClaw 后，主界面中央会显示动态刷新的二维码。
2、使用手机微信扫描该二维码，在弹出页面中点击“确认登录”。
3、等待约 5 秒，电脑端提示“绑定成功”，微信聊天列表中将出现名为龙虾的新好友。
三、启动 OpenClaw 并验证 Web UI 访问
QClaw 默认内置轻量级网关服务，启动后自动监听本地端口并托管 OpenClaw 的 Web 控制台，用户可通过浏览器直接交互。
1、在 QClaw 主界面点击“一键启动 OpenClaw”按钮（图标为蓝色火箭）。
2、等待状态栏显示“服务已就绪”，此时后台已拉起网关及 OpenClaw 核心进程。
3、打开浏览器，访问地址：http://localhost:18789。
4、若页面正常加载对话界面，说明部署成功；如遇空白页或连接拒绝，请进入下一步排查。
四、处理 Web UI 无法访问的常见情形
端口被占用、防火墙拦截或网关未正确注册是导致 localhost:18789 不可达的三大主因，需按顺序逐一验证。
1、以管理员身份打开命令提示符，执行：netstat -ano | findstr :18789，若有 PID 输出，记录该编号。
2、执行：taskkill /PID [编号] /F（将[编号]替换为上一步查得的数字），强制终止冲突进程。
3、打开“Windows Defender 防火墙”→“高级设置”→“入站规则”，检查是否存在名称含QClawGateway的启用规则；若无，需手动新建规则放行 TCP 端口 18789。
4、若仍失败，进入 QClaw 安装目录下的 resources\app\bin\ 子文件夹，双击运行 reinstall-gateway.bat 重新注册服务。
五、关联已有 OpenClaw 实例（可选）
若您此前已通过 npm 全局安装 openclaw@latest 并完成 onboard 配置，QClaw 支持跳过重复部署，直接接管现有运行时，避免模型与配置冗余。
1、启动 QClaw 后，在左下角状态栏右键，选择“检测本地 OpenClaw”。
2、程序将自动搜索全局 node_modules 中的 openclaw 可执行文件路径及 ~/.openclaw/config.yaml 配置。
3、识别成功后，界面提示“发现已有配置”，点击“接管并启动”，QClaw 将复用原有模型缓存与 API 设置。
4、此时 Web UI 仍通过 http://localhost:18789 访问，所有历史技能与第三方 API（如 Kimi、DeepSeek）保持生效。
