当前位置：首页 > news >正文

给我的 QQ 助理换个“最强大脑”：Windows 部署 OpenClaw + 替换模型攻略

news 2026/8/29 7:19:22

引言

最近在折腾个人 AI 助理时，发现 OpenClaw 这个框架非常契合“私有助理”的理念。但默认的国内模型在逻辑深度上还是略显不足，于是我动了“换脑手术”的念头——将它接入更智能的模型。

在 Windows 11 环境下，从网络穿透到配置校验，我踩了不少坑。这篇文章把整个部署和调优过程复盘一遍，希望能帮到想打造“地表最强”QQ 机器人的你。

第一阶段：从零部署与 Qwen Baseline（基准）测试

很多 Windows 用户在第一步就疯狂踩坑，通常是因为忽略了底层环境的建设。

1. 打好环境地基（切勿跳过）

OpenClaw 是基于 Node.js 生态构建的，并且在拉取依赖、更新框架、甚至安装扩展技能时，极度依赖版本控制工具。

安装 Node.js：请前往官网下载并安装 v22 以上的 LTS 版本。这是 OpenClaw 运行的“池子”。
安装 Git：去 Git 官网下载 Windows 版并默认安装。不装 Git，后续装任何 QQ 机器人插件都会报找不到路径的致命错误。

PS C:\Windows\system32> node -v v24.14.0 PS C:\Windows\system32> git --version git version 2.53.0.windows.2

2. 全局安装与系统授权

以管理员身份打开 PowerShell。由于 Windows 默认会拦截外部脚本的运行，我们需要先放开执行权限，然后再进行全局安装：

# 开启当前用户的脚本执行权限 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser # 全局安装 OpenClaw 命令行工具 npm install -g @openclaw/cli

3. 初始化引导与接入 QQ 机器人

安装完成后，输入openclaw onboard启动新手引导向导。

在这个阶段，强烈建议大家先选择通义千问（Qwen）作为初始大脑。它支持 OAuth 扫码登录，免去了手动申请配置 API Key 的繁琐，而且国内直连，能帮你快速验证整个框架和 QQ 链路是否畅通。

随后，向导会提示你接入聊天渠道。腾讯官方现在为 OpenClaw 提供了专门的极速通道

（https://q.qq.com/qqbot/openclaw/login.html）。你只需扫描终端弹出的网页二维码，在控制台点击创建机器人，然后将页面上生成的三行核心命令复制回 PowerShell 执行即可。

4. 为什么要换模型？（Qwen 实测体验）

执行完毕启动网关（openclaw gateway）后，在 QQ 里就能直接对话了。

作为一名工程师，我平时经常要涉及架构搭建，或者帮客户排查复杂的故障场景。Qwen 在日常闲聊和基础代码辅助上表现得非常出色，速度极快。但在面对几百行的底层代码报错日志，需要极强逻辑深度的深度分析时，多少显得有些套路化。这就是我们需要掌握“自由切换模型底层逻辑”的核心原因。

第二阶段：硬核进阶，手把手教你切换自定义大模型

当我们熟悉了默认配置后，就可以开始“换脑手术”了。以接入需要代理和 API Key 的外部模型（如 Gemini）为例，最新版 OpenClaw (2026.3.x) 为了安全禁用了部分命令行传参，我们必须直接对核心配置文件动刀。

1. 定位并理解核心配置文件

OpenClaw 的所有秘密都藏在你的用户目录下。打开路径：C:\Users\你的用户名\.openclaw\，找到openclaw.json文件，用记事本或 VS Code 打开。

2. 注入新供应商（Provider）配置

找到 JSON 文件中的"models": { "providers": {这一段。这代表了系统当前连接的模型服务商。

我们要在这里并排插入新的服务商配置。踩坑警告：新版本的格式校验极其严格，你必须用models数组明确列出该服务商下有哪些具体的模型 ID，否则网关启动会直接报错崩溃。

请将以下代码根据你的实际需求修改后，精确插入其中（注意 JSON 的逗号分隔）：

"google": { "apiKey": "你的_API_Key_填在这里", "baseUrl": "https://generativelanguage.googleapis.com/v1beta", "models": [ { "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" }, { "id": "gemini-3.1-flash-lite-preview", "name": "Gemini 3.1 Flash Lite" } ] },

3. 设置主从模型策略（高阶调优）

仅仅注入了服务商还不够，我们还需要告诉系统“优先用哪个脑子”。

往下翻，找到"agents": { "defaults": { "model": {这一段。这里有一个非常实用的机制：primary（首选）和fallbacks（后备）。

很多外部 API 都有严格的并发或频率限制。为了防止聊天中断，我们可以把响应快、额度高的模型设为主力，把额度低、算力强的模型或国内直连模型作为替补：

"model": { "primary": "google/gemini-3.1-flash-lite-preview", "fallbacks": [ "google/gemini-3.1-pro-preview", "qwen-portal/coder-model" ] }

第三阶段：扫清模型切换后的“三大玄学障碍”

配置文件改好了，但如果你现在直接重启，大概率会遇到机器人“已读不回”或疯狂报错。你需要跨过以下三个深坑：

痛点 1：请求超时 (LLM request timed out)

现象：QQ 发消息没反应，本地控制台顶部飘红报错 Timeout。

剖析：如果你的新模型 API 在境外，即使你的浏览器挂了代理能访问，Windows PowerShell 默认也是不走代理的。而且新版 OpenClaw 不允许在配置文件中直接写 proxy 字段。

破局解法：通过环境变量强行给命令行开隧道。每次启动网关前，必须先执行这两行声明（假设你的本地代理端口是 7890）：

$env:HTTP_PROXY="http://127.0.0.1:7890" $env:HTTPS_PROXY="http://127.0.0.1:7890" & "$env:USERPROFILE\.openclaw\gateway.cmd"

痛点 2：“身在曹营心在汉”的会话锁定机制

现象：代理通了，模型也换了，去 QQ 里问它，它依然倔强地回答：“我是通义千问”。

剖析：OpenClaw 为了保证对话上下文连贯，会将当前的聊天 Session 与其诞生时的模型死死绑定在本地缓存里。

破局解法：

轻度重置：在网页控制台（127.0.0.1:18789）点击右下角的New session开启新对话。
物理清空：如果还是不行，关闭网关，直接进入文件夹C:\Users\你的用户名\.openclaw\workspace\sessions\，清空里面的所有缓存文件。重启后，AI 会强制读取你最新配置的 primary 模型。