QClaw在Windows上提供三种安装方式：一、标准图形化安装，适用于新手，需以管理员身份运行.exe安装包；二、离线静默安装，适用于无网或批量部署，通过PowerShell命令执行；三、PowerShell脚本驱动安装，支持自定义端口与Token，适合进阶用户。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您希望在 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 验证。
