QClaw升级有三种方式：一、客户端内建更新，点击设置→关于→检查更新→立即更新→重启；二、手动下载覆盖安装，访问官网下载对应系统新版安装包并覆盖；三、命令行强制升级，执行qclaw --upgrade --force --no-prompt后重启。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已安装 QClaw 但当前版本较旧，可能无法使用最新技能、模型切换功能或微信直控优化。以下是升级到最新版本的具体操作方法：
一、通过客户端内建更新机制升级
QClaw 客户端内置自动检测与一键升级功能，适用于 Windows 与 macOS 系统，无需卸载重装，配置与 Skills 数据全部保留。
1、启动已安装的 QClaw 应用程序，确保主界面正常加载。
2、点击左下角齿轮图标进入「设置」面板。
3、在设置页中选择「关于 QClaw」选项卡。
4、点击「检查更新」按钮，系统将自动连接 claw.guanjia.qq.com 更新服务器。
5、若检测到新版本，界面将显示「发现新版本 v2.3.1（20260313）」字样，并附带更新日志摘要。
6、点击「立即更新」，客户端将自动下载增量补丁包（通常小于 15MB），并提示「更新中，请勿关闭窗口」。
7、更新完成后，界面弹出「重启以应用更新」提示，点击「重启」，QClaw 将关闭并重新启动至新版本。
二、手动下载覆盖安装升级
当内建更新失败（如网络策略拦截、证书校验异常或本地文件损坏）时，可采用覆盖安装方式完成升级，该方式会保留用户配置目录（含模型设置、Skills 安装记录、微信绑定状态）。
1、访问官方更新页面：claw.guanjia.qq.com/download。
2、根据当前操作系统识别版本标识：Windows 用户查看是否为「QClaw-Win-x64-Setup-v2.3.1.exe」；macOS 用户确认文件名为「QClaw-Mac-Universal-v2.3.1.dmg」。
3、下载对应安装包，**切勿运行旧版安装程序**。
4、双击运行新下载的安装包，Windows 用户勾选「覆盖安装」选项；macOS 用户将新应用拖入「应用程序」文件夹时，系统将提示“替换”，点击「替换」。
5、安装完成后，**不需重新扫码绑定微信**，原有绑定关系与本地 OpenClaw 关联状态仍有效。
三、命令行强制刷新升级（高级用户）
适用于企业批量部署、CI/CD 集成或需跳过图形界面干预的场景，该方式直接调用 QClaw 内核升级模块，绕过 GUI 检测逻辑。
1、打开终端（macOS/Linux）或 PowerShell（Windows），确保已加入系统 PATH。
2、执行命令：qclaw --upgrade --force --no-prompt。
3、观察输出日志，确认出现「[UPGRADE] Fetching manifest from https://update.claw.guanjia.qq.com/v2/latest.json」。
4、等待日志显示「[UPGRADE] Patch applied successfully. Restart required.」。
5、执行 qclaw --restart 命令触发服务重载。
