QClaw通过预封装与脚本驱动实现AI运行环境的一键静默安装。用户下载对应平台安装包后，双击运行并全程默认选项，约150秒即可完成Node.js、Docker、Python 3.11等组件自动部署；启动后通过系统托盘图标与控制台日志验证“env-ready”等状态标识；异常时可微信发送/repair-env --force指令强制重装；高级用户亦支持qclaw-cli install命令行离线部署。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您希望QClaw在部署过程中自动完成AI运行环境搭建与所需软件安装，则需依赖其内置的自动化配置机制。QClaw并非传统意义的“安装器”，而是通过预封装、脚本驱动与系统级接口调用，实现对Node.js、Docker、模型运行时及依赖服务的一键拉取与静默安装。以下是具体操作路径：
一、启用QClaw内置自动安装流程
QClaw安装包已将OpenClaw运行所需的全部底层组件（含轻量级Docker Desktop替代方案、Python 3.11运行时、chromium无头浏览器、模型推理引擎）预先打包并绑定触发逻辑。安装过程即为自动部署过程，无需用户手动执行软件安装命令。
1、从官网下载对应平台安装包：Windows用户获取QClaw-Windows-Setup.exe，macOS用户获取QClaw-Mac.dmg；
2、双击运行安装包，全程点击“下一步”或“继续”，不勾选任何自定义选项；
3、在安装界面出现“正在检测环境…正在安装 Node.js…正在配置 Docker…”提示时，保持窗口开启且不中断进程，等待约150秒；
4、安装完成后，勾选“立即运行 QClaw”，点击“完成”启动主程序。
二、验证自动安装结果
QClaw启动后会主动扫描本地是否已存在兼容版本的运行组件。若检测到缺失或版本不匹配，将自动触发后台补装流程，并在系统托盘显示进度图标。该机制独立于用户交互，全程后台静默执行。
1、启动QClaw后，观察右下角系统托盘是否出现蓝色龙虾图标；
2、右键点击该图标，选择“打开控制台”；
3、在控制台日志中查找包含“env-ready”、“docker-proxy-up”、“model-runtime-launched”的关键行；
4、若三类标识均显示“status: ok”，则表示所有依赖软件已由QClaw自主完成安装与初始化。
三、强制触发重装/修复环境
当QClaw检测到环境异常（如Docker服务崩溃、模型缓存损坏、权限拒绝）时，可通过内置指令让其重新执行完整软件安装链路，等效于“二次全自动部署”。
1、确保QClaw主程序正在运行；
2、在微信中向“龙虾”好友发送指令：/repair-env --force；
3、等待微信回复“? 正在重建运行环境…（预计90秒）”；
4、期间勿关闭电脑、勿终止QClaw进程，系统将自动卸载异常组件并重装全部依赖软件；
5、收到微信消息“✅ 环境修复完成，服务已重启”即表示操作结束。
四、通过命令行接管自动安装过程
高级用户可绕过图形化安装器，直接调用QClaw封装的CLI工具执行离线式软件安装，适用于无GUI环境或批量部署场景。该方式完全复用QClaw内核的安装逻辑，仅暴露控制入口。
1、打开终端（Windows PowerShell / macOS Terminal）；
2、执行命令：qclaw-cli install --runtime=all --model=none --no-gui；
3、输入管理员密码（Windows需UAC确认，macOS需sudo授权）；
4、观察输出中连续出现“[✓] Installed docker-proxy”、“[✓] Installed nodejs-18.19.0”、“[✓] Configured system PATH”等标记；
5、当最后一行显示“Installation complete. Run ‘qclaw-cli serve’ to start.”时，全部软件已由QClaw CLI自动安装完毕。
