QClaw自动部署有四种方法：一、双击安装包按向导完成并勾选“立即运行”；二、命令行执行--deploy --force强制触发；三、配置config.yaml启用静默部署；四、用docker compose up -d容器化部署。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您已下载QClaw安装包但尚未完成初始环境构建与服务启动，则可能是由于自动部署流程未正确触发或配置参数缺失。以下是实现QClaw自动部署的多种设置方法：
一、启用内置一键部署功能
QClaw客户端集成了全自动环境检测与部署引擎，无需手动执行命令行操作，所有依赖（Node.js、Docker、Python运行时等）均由程序自主判断并安装。
1、双击运行已下载的安装包（Windows为QClaw-Windows-Setup.exe，macOS为QClaw-Mac.dmg）。
2、在安装向导中连续点击“下一步”，勾选“我同意许可协议”后进入安装路径选择界面。
3、保持默认路径或自定义路径，点击“安装”，此时界面将弹出绿色进度条并显示“正在检测环境…正在安装 Node.js…正在配置 Docker…”等实时提示。
4、等待约2–3分钟，安装完成弹窗出现后，务必勾选“立即运行 QClaw”选项，再点击“完成”。
二、通过命令行强制触发自动部署
当图形化安装异常中断或需复用已有环境时，可调用QClaw内置CLI工具直接启动部署流程，该方式跳过GUI校验，适用于高级用户及脚本集成场景。
1、打开系统终端（Windows使用PowerShell，macOS使用Terminal）。
2、输入命令切换至QClaw安装目录，例如：cd "C:\Program Files\QClaw"（Windows）或 cd /Applications/QClaw.app/Contents/MacOS（macOS）。
3、执行部署指令：./qclaw --deploy --force（macOS/Linux）或 qclaw.exe --deploy --force（Windows）。
4、观察终端输出，确认出现“✅ Deployment completed successfully”及“? Service is now listening on http://localhost:8080”字样。
三、配置config.yaml启用静默自动部署
对于批量部署或企业内网环境，可通过预置配置文件跳过交互式引导，使QClaw在首次启动时自动完成全部初始化动作，包括模型缓存下载与微信绑定前置准备。
1、在QClaw安装目录下新建文本文件，命名为config.yaml。
2、写入以下内容（注意缩进为两个空格，不可用Tab）：auto_deploy: true、skip_welcome: true、wechat_auto_bind: false。
3、保存文件后，双击启动QClaw主程序，程序将读取该配置并跳过所有弹窗提示，直接进入后台部署阶段。
4、部署日志将输出至logs/deploy.log，可随时查看进度与错误详情。
四、使用Docker Compose实现容器化自动部署
适用于具备Docker基础的用户，通过声明式编排文件统一管理QClaw核心服务、前端界面与API网关，支持跨平台一致运行与快速扩缩容。
1、确保本地已安装Docker Desktop且Docker服务正在运行。
2、创建新文件夹，进入后执行命令：curl -O https://qclaw.tencent.com/docker-compose.yml（官方托管配置文件）。
3、执行启动指令：docker compose up -d，系统将自动拉取镜像、创建网络、挂载卷并启动全部服务。
4、等待约90秒后，运行docker compose logs -f qclaw-server，确认输出中包含“QClaw server initialized”与“WebSocket gateway ready”。
