1. 为什么要在 QQ 里跑 OpenClaw AgentOpenClaw 是一个把大模型能力封装成可编排 Agent 的本地框架它本身不绑定任何聊天入口而是通过 gateway网关加 plugins插件的方式把 Agent 挂到不同的消息通道上。QQ 就是其中一个很实用的通道你不需要自己写前端也不用部署网页只要把 QQ 机器人插件接进 gateway就能在手机 QQ 里直接和 Agent 对话做问答、查资料、跑任务。这套链路适合谁一类是想在 QQ 群里做自动化助手的开发者比如定时播报、关键词回复、群内问答另一类是已经在本地跑 OpenClaw、想换个更顺手的交互入口的人。我自己试过把 Agent 接到 QQ 上最大的感受是调试成本比想象中低因为 gateway 负责消息路由插件负责协议适配你只需要把配置写对。整条链路可以拆成四段TaoToken 提供统一的模型 KeyOpenClaw 的 config.toml 管模型和通道gateway 负责把消息从 QQ 转发给 Agentqqbot 插件负责和 QQ 开放平台通信。任何一段配置错了表现都是「机器人去火星了」或者消息没响应。下面按可复制的顺序走一遍重点放在配置骨架和验证动作上。2. TaoToken 统一 Key 的前置准备在写 config.toml 之前先把模型侧的 Key 准备好。TaoToken 的作用是给你一个统一的 API KeyOpenClaw 里所有模型调用都走这个 Key不用为每个模型单独配一套凭证。这样你在 config.toml 里只需要维护一个 provider 段换模型时改模型名就行。先到控制台创建 Key。打开 https://taotoken.net/api-keys 登录后新建一个 API Key复制出来保存好这个 Key 只在创建时完整显示一次。如果你还没注册从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 进官网注册即可。Key 拿到后确认两件事一是 API 基地址用 https://taotoken.net/api 注意这里不加任何查询参数二是你想用的模型名可以在模型对话页 https://taotoken.net/models 里先试一下确认这个模型能正常返回再写进配置。这一步别省很多人后面报 401 或模型不存在都是因为 Key 或模型名没核对。提示TaoToken 的 Key 是统一凭证OpenClaw 里不要把它写进多个 provider否则日志里会出现重复鉴权排查起来很乱。3. config.toml 骨架与 gateway、QQ 插件配置OpenClaw 的配置集中在 config.toml模型段和通道段分开写。下面是一个可以直接改的骨架模型部分走 TaoToken通道部分挂 qqbot 插件。# ~/.openclaw/config.toml [providers.taotoken] type openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoTokenKey [models.default] provider taotoken name 你验证过的模型名 temperature 0.7 [gateway] host 127.0.0.1 port 18789 log_level info [channels.qqbot] enabled true appId 你的AppID appSecret 你的AppSecret botId 你的机器人QQ号模型段里type用openai-compatible因为 TaoToken 的接口兼容 OpenAI 格式OpenClaw 能直接识别。base_url一定写https://taotoken.net/api不要带斜杠结尾之外的路径。api_key填刚才创建的 Key。gateway 段决定网关监听地址和端口本地调试用 127.0.0.1 就行。如果你后面要放到服务器上把 host 改成 0.0.0.0但记得配好防火墙别把端口裸奔在公网。qqbot 段的三个字段来自 QQ 开放平台AppID、AppSecret 在开发管理页面获取botId 是你机器人的 QQ 号。这三个值必须和开放平台里填的一致尤其是 AppSecret复制时容易多带空格。配置写完后用命令行方式再确认一遍避免手写 toml 出错openclaw config set channels.qqbot.appId 你的AppID openclaw config set channels.qqbot.appSecret 你的AppSecret openclaw config set channels.qqbot.botId 你的机器人QQ号 openclaw config set channels.qqbot.enabled true这几条命令会直接改写 config.toml 对应字段执行完可以用openclaw channels list看通道是否注册成功。4. 启动 gateway 并验证消息收发配置就绪后先重启网关让改动生效openclaw gateway restart openclaw gateway statusgateway status返回 running 才算正常。如果显示 stopped用openclaw logs --level ERROR看错误常见的是端口被占用或 toml 语法错误。网关起来后确认插件已加载openclaw plugins list列表里应该能看到sliverp/qqbot。如果没有先安装openclaw plugins install sliverp/qqbotlatest然后重启网关。插件加载成功后用手机或电脑 QQ 搜索你的机器人 QQ 号添加好友并发一条消息比如「你好」。正常情况几秒内会收到 Agent 回复。验证模型侧是否真的走了 TaoToken可以看日志openclaw logs --follow发消息时日志里会出现一次模型请求记录包含 provider 为 taotoken。如果日志里 provider 是别的名字说明models.default没指对回去检查 config.toml 的 provider 字段。再验证一次通道状态openclaw channels listqqbot 那行显示 enabled 且 connected说明 QQ 侧长连接正常。如果显示 disconnected多半是 AppSecret 或白名单问题下一节细说。5. 本篇常见报错排查报错一该机器人去火星了稍后再试吧这是 QQ 侧最常见的提示本质是机器人没有正确响应开放平台的回调。先查通道配置openclaw channels list如果 qqbot 没在列表里重新添加openclaw channels add --channel qqbot --token 你的AppID:你的AppSecret openclaw gateway restart注意 token 格式是AppID:AppSecret中间用英文冒号不要有空格。如果还是火星检查 QQ 开放平台里的 IP 白名单把你当前公网 IP 加进去。本地开发时公网 IP 会变建议用https://myip.ipip.net查当前 IP 后更新白名单。报错二消息发出但 Agent 不回复先看日志有没有模型请求openclaw logs --level ERROR如果日志里出现 401是 TaoToken Key 错了或过期回控制台重新生成。如果出现 model not found是模型名写错去模型对话页确认准确名称。如果日志里根本没有模型请求说明消息没进 gateway检查 qqbot 插件是否 enabled。报错三gateway 启动后立刻退出多半是 config.toml 语法问题。用openclaw status --all看完整诊断它会指出哪一行解析失败。toml 里字符串必须用双引号布尔值写 true/false 不加引号这两点最容易错。报错四本地能收消息服务器上不行本地和服务器最大的差别是公网 IP 和白名单。服务器上部署时把 gateway 的 host 改成 0.0.0.0端口在安全组放行然后把服务器公网 IP 加进 QQ 开放平台白名单。如果还不行用openclaw gateway run前台运行看实时输出比看日志文件直观。6. 后续怎么用得更顺跑通之后日常维护主要靠几条命令。看运行状态用openclaw status看完整诊断用openclaw status --all实时跟日志用openclaw logs --follow。换模型时不用改通道配置只改models.default的 name 字段然后openclaw gateway restart即可。如果你打算长期在 QQ 里跑 Agent建议把模型调用统一收在 TaoToken 这一层这样换模型、加模型都只动一个 provider 段通道侧完全不用碰。需要长期编码或跑 Agent 任务的话可以看下 Coding Plan https://taotoken.net/coding-plan 接入文档在 https://taotoken.net/doc 排障时对照文档里的字段说明会快很多。模型对话页 https://taotoken.net/models 可以随时验证某个模型当前是否可用避免配置写完才发现模型下线。