QClaw Windows版安装教程

QClaw Windows版提供图形化安装、离线静默部署和PowerShell脚本驱动三种灵活安装方式，全面覆盖新手入门、企业批量部署与进阶定制需求——无论你是想一键完成本地AI服务搭建，还是在无网环境安全落地，亦或需自定义端口、Token并集成至自动化运维流程，本文都为你详尽拆解每一步关键操作、常见失败原因及实测验证技巧，助你零障碍开启Windows平台上的QClaw智能体验。

如果您希望在 Windows 系统上运行 QClaw，但发现安装失败、无法启动或提示兼容性问题，则可能是由于系统版本不匹配、权限未授予或安装流程中断所致。以下是针对 Windows 平台的多种安装方法：

一、标准图形化安装（推荐新手）

该方式采用预编译的 .exe 安装包，自动完成环境依赖部署，无需手动配置 Node.js 或 Docker，适合绝大多数 Windows 10/11 用户。

1、访问 QClaw 官网 https://claw.guanjia.qq.com/，确认页面显示“Windows 可用”标识（截至2026年3月12日已正式支持）。

2、点击“Windows 下载”按钮，获取最新版 QClaw-Windows-Setup.exe 文件。

3、右键该安装包，选择“以管理员身份运行”，避免因权限不足导致 Docker 组件安装失败。

4、在安装向导中依次点击“下一步”→勾选“我接受许可协议”→选择安装路径（建议保留默认 C:\Program Files\QClaw）→点击“安装”。

5、等待界面显示“正在配置 Docker 引擎…正在初始化本地模型服务…”字样，全程勿关闭窗口，约耗时 2 分 47 秒（实测 i5-1135G7/16GB 配置）。

6、安装完成后勾选“立即启动 QClaw”，点击“完成”，主界面将自动弹出并显示“就绪”状态灯。

二、离线静默安装（适用于无网络或企业受限环境）

当目标 Windows 设备无法联网或需批量部署时，可使用离线安装包配合命令行参数跳过在线检测与自动更新步骤，确保部署一致性。

1、在另一台可联网的 Windows 电脑上，从官网下载 QClaw-Windows-Offline.zip（内含完整 runtime 和预加载模型）。

2、解压至目标设备任意本地路径（如 D:\QClaw-Offline），确保路径不含中文或空格。

3、以管理员身份打开 PowerShell，执行：
Start-Process -FilePath "D:\QClaw-Offline\setup.exe" -ArgumentList "/S /D=C:\QClaw"

4、安装过程无界面输出，可通过任务管理器观察是否存在 dockerd.exe 与 qclaw-core.exe 进程来确认成功。

5、安装完毕后，手动运行 C:\QClaw\qclaw-launcher.exe 启动主程序。

三、PowerShell 脚本驱动安装（支持自定义端口与 Token）

适用于需集成至 IT 自动化流程、或需预设微信绑定 Token、指定 API 端口（如避开 8080 冲突）的进阶用户。

1、在官网下载页面获取 install-qclaw.ps1 脚本文件，并保存至本地（如 C:\temp\install-qclaw.ps1）。

2、以管理员身份打开 PowerShell，执行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

3、运行安装脚本并传入参数：
.\C:\temp\install-qclaw.ps1 -Port 9090 -BindToken "wx_abc123" -SkipUpdate $true

4、脚本将自动校验 Windows 功能（如 WSL2、Hyper-V）、启用必要组件、下载压缩包、解压并注册为 Windows 服务。

5、安装完成后，服务名 QClawLocalAgent 将处于“正在运行”状态，可通过 Get-Service QClawLocalAgent 验证。

到这里，我们也就讲完了《QClaw Windows版安装教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于QClaw的知识点！