1. 为什么要在 Windows 上把 OpenClaw 接到 QQ
OpenClaw 是一个可以本地部署、通过聊天工具远程调用的 AI 助理框架，它本身不绑定某一个聊天平台，而是通过「渠道插件」把消息接进来。QQ 机器人插件就是其中一种渠道：你在 QQ 里给机器人发一句话，消息经插件转发给 OpenClaw，模型生成回复后再由插件发回 QQ。适合谁？适合已经在 Windows 上跑起 OpenClaw、想用 QQ 当日常入口的人，也适合不想折腾服务器、只想在熟悉的聊天窗口里调用 AI 的普通用户。
我这次全程在 Windows 11 + PowerShell 7 下操作，核心就三件事：装插件、加渠道、重启网关。听起来简单，但真正卡人的地方在权限、Token 拼接格式和网关重启顺序。下面把每一步拆开，配置直接复制就能用。
需要提前说明：OpenClaw 官方渠道列表里暂时没有内置 QQ，所以必须走社区插件@sliverp/qqbot。插件负责和 QQ 开放平台通信，OpenClaw 负责调度模型，两者通过config.toml里的渠道段关联。理解这个分工，后面排查问题会快很多。
2. TaoToken 前置：先把模型通道准备好
OpenClaw 自己不带模型，它需要一个兼容 OpenAI 接口的推理服务。我这边用的是 TaoToken，官网在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，它提供标准的 API 接入方式，配置进 OpenClaw 后模型调用就走这条通道。
操作顺序建议这样：先登录控制台，在 API Keys 页面创建一个密钥，复制保存；然后确认你要用的模型名，比如对话类模型；最后把 base_url 和 key 填进 OpenClaw 的模型配置。API 地址是 https://taotoken.net/api ，注意这个地址不带任何查询参数，直接作为 base_url 使用。
如果你还没决定用哪个模型，可以先去模型对话页面实际发几条消息，确认响应速度和效果符合预期，再回来写配置。长期做编码或 Agent 任务的话，Coding Plan 会更合适，额度模型和按量调用不一样，按自己的使用强度选。
注意：API Key 只在创建时完整显示一次，关掉页面就看不到了。建议创建后立刻存进密码管理器，不要直接贴在聊天记录里。
这一步做完，你手里应该有三样东西：TaoToken 的 API Key、base_url、模型名。QQ 插件那步还需要 QQ 开放平台给的 AppID 和密钥，两者不要混。
3. 可复制配置：config.toml 骨架与 QQ 插件参数
先装插件。用管理员权限打开 PowerShell，这一步很关键，普通权限装全局插件经常报路径无权限。
# 以管理员身份运行 PowerShell 后执行 openclaw plugins install @sliverp/qqbot@latest装完确认一下插件是否注册成功：
openclaw plugins list输出里应该能看到 qqbot 条目。如果没有，多半是 npm 全局目录权限问题，可以检查npm config get prefix指向的目录是否可写。
接着添加渠道。Token 的格式是AppID:机器人密钥，中间是英文冒号，不要用中文冒号，也不要有空格：
openclaw channels add --channel qqbot --token "你的AppID:你的机器人密钥"然后编辑 OpenClaw 的config.toml。下面是一份可直接改的骨架，模型段填 TaoToken 的信息，渠道段填 QQ 插件参数：
[model] provider = "openai-compatible" base_url = "https://taotoken.net/api" api_key = "你的TaoToken密钥" model = "你的模型名" [channels.qqbot] enabled = true app_id = "你的AppID" app_secret = "你的机器人密钥" # 沙箱环境先用 true，正式发布改 false sandbox = true # 单条消息最大长度，QQ 侧有限制，超出会被截断 max_message_length = 2000几个参数说明：sandbox为 true 时只有沙箱成员能触发机器人，调试阶段建议保持 true，避免误发到正式群；max_message_length按 QQ 侧限制设置，太长会被平台拒绝；base_url结尾不要多加斜杠，否则部分客户端会拼出双斜杠路径。
改完配置重启网关：
openclaw gateway restart重启后看日志确认渠道加载：
openclaw gateway logs --follow日志里出现 qqbot channel started 之类的字样，说明渠道已经挂上。
4. 验证请求：发一条测试消息确认通道连通
配置写完不代表通了，必须实际发消息验证。打开 QQ，找到你创建的机器人，发一句「你好，测试一下」。预期结果是几秒内收到模型回复。
如果没回复，先看网关日志有没有收到入站消息。收到入站但没出站，通常是模型段配置问题；连入站都没有，是 QQ 插件或 Token 的问题。可以手动发一条 HTTP 请求验证模型通道是否独立可用：
$headers = @{ "Authorization" = "Bearer 你的TaoToken密钥" "Content-Type" = "application/json" } $body = @{ model = "你的模型名" messages = @(@{ role = "user"; content = "ping" }) } | ConvertTo-Json -Depth 5 Invoke-RestMethod -Uri "https://taotoken.net/api/v1/chat/completions" ` -Method Post -Headers $headers -Body $body返回里有 choices 字段和内容，说明模型通道没问题，问题就锁定在 QQ 插件侧。这一步能把「模型不通」和「QQ 不通」快速分开，省很多时间。
验证通过后，你可以把sandbox改成 false，让机器人在正式环境可用。改完记得再重启一次网关，配置不会热加载。
5. 本篇常见错排查
报错一：plugins install 提示 EACCES 或路径无权限。原因是没用管理员权限，或者 npm 全局目录在系统保护路径下。解决：用管理员 PowerShell 重跑，或改 npm prefix 到用户目录。
报错二：channels add 成功但日志里渠道没启动。多半是 Token 格式错了。检查是不是用了中文冒号、有没有多余空格、AppID 和密钥有没有贴反。重新执行 add 命令覆盖即可。
报错三：QQ 里发消息完全没反应。先确认机器人是否已发布、当前账号是否在沙箱成员列表里。sandbox 为 true 时，非成员发的消息会被直接丢弃，日志里也不一定有明显提示。
报错四：模型返回 401。TaoToken 密钥错误或已失效，去控制台重新建一个。注意 base_url 不要写成带/v1的完整路径再叠加，配置里只填到/api。
报错五：回复被截断或发送失败。QQ 侧对消息长度有限制，把max_message_length调小，或在 OpenClaw 侧开启分段发送。
报错六：改了 config.toml 不生效。配置不是热加载的，必须openclaw gateway restart。改完不重启是最常见的「我明明改了」问题。
6. 接下来怎么用：按场景选入口
通道跑通后，日常使用就很直接了：在 QQ 里像聊天一样给机器人发指令，OpenClaw 负责调度模型执行。如果你主要拿它做问答和轻量任务，保持现在的模型配置就够；如果要做长期编码、Agent 自动化这类高频任务，建议去了解 Coding Plan，额度和调用方式更适合持续使用。
需要管理密钥或新建通道时，直接进 API Keys 页面操作；接入细节和参数说明看接入文档；想先试模型效果就去模型对话。这三个入口基本覆盖了从调试到上线的全部动作。
最后提醒一句：config.toml里同时存着模型密钥和 QQ 密钥，别把这个文件提交到任何公开仓库，本地也建议放在非同步目录里。跑通之后，你可以把同样的思路复制到其他渠道插件上，OpenClaw 的渠道机制是通用的，换的只是插件名和参数。
