线报酷线报酷
文档首页 / 用户中心设置 / QQ 频道机器人推送教程

QQ 频道机器人推送教程

2026-10-13 …

QQ 频道机器人是腾讯官方开放的机器人通道:在 QQ 开放平台创建机器人,把它拉进你的 QQ 频道,就能通过官方接口推消息。与 OneBot(跑在自己电脑上的个人号方案)不同,它是官方通道、国内直连、无需自建任何程序,也不需要电脑 24 小时开机。

适用人群

  • 想收 QQ 消息但不想折腾 NapCat / go-cqhttp 等自建程序;
  • 常用 QQ 频道(游戏、兴趣社群)的用户;
  • 希望推送稳定、不依赖自己电脑在线。

第一步:创建机器人并拿 Token

  1. 打开 q.qq.com(QQ 开放平台),用 QQ 扫码登录;
  2. 进入「应用管理」→ 创建应用 → 选择「机器人」类型,填写名称与简介(个人开发者可直接创建,无需企业资质);
  3. 创建完成后,在应用的「开发设置」页找到 Bot Token(形如 102012345.xxxxxxxxxxxxxxxx),复制保存;
  4. 同一个页面记下 AppID(Token 前半段就是它,便于核对)。
Bot Token 长期有效,请勿泄露;一旦泄露他人可冒充你的机器人发消息,可在开发设置页「重置」。

第二步:把机器人拉进频道,拿子频道 ID

  1. 在 QQ 开放平台的机器人设置里,找到「频道」或「使用范围」相关配置,把机器人添加到你的频道(需要你是该频道主或管理员);
  2. 打开 QQ,进入目标频道,右键点击要接收推送的子频道 → 「复制子频道 ID」,得到一串纯数字(如 99887766)。
QQ 频道与普通 QQ 群是两套东西:本渠道推的是频道。若你只想推到普通 QQ 群,请用 Qmsg酱 或 OneBot。

第三步:本站填写

  1. 打开 推送渠道 → 「新增推送渠道」→ 类型选「QQ 频道机器人」;
  2. 按表填入 Bot Token 与子频道 ID;
  3. 保存 → 「发送测试」→ 频道里收到消息即成功。
字段必填说明
Bot Token✅形如 102012345.xxxxxxxx,QQ 开放平台「开发设置」获取
子频道 ID✅右键频道 → 复制子频道 ID;多个用 # 分隔
回复消息 ID—留空=直接发新消息;填写=作为该消息的回复

推送方式:云端与挂机都可以

本渠道的鉴权是「Token 直接放在请求头里」,不需要先换票据,所以两种模式都支持:

  • ☁️ 云端推送:由本站服务器直发,走每日额度,超出后按积分计费;
  • 🖥️ 浏览器挂机:由你本机的「推送工作台」直发,不占额度、不计费,但需要保持页面对应标签页开着。

第四步:建规则

到 推送规则新建规则 → 在「目标渠道」里勾选本渠道 → 打开开关即可。

常见问题

提示「Token 无效」或 401?

检查 Token 是否完整复制(含 . 前后两段)、是否已在开放平台重置过。重置后旧 Token 立即失效。

提示 404 / 频道不存在?

多半是子频道 ID 填错,或机器人还没被拉进该频道。请重新右键复制 ID,并确认机器人有该频道的发言权限。

能推到 QQ 群吗?

官方机器人对普通群的开放程度有限,本渠道目前面向频道。推普通 QQ 群建议用 Qmsg酱 或 OneBot v11。

有没有频率限制?

官方对机器人发消息有频率限制,本站已按保守值限速;高频推送建议在规则里开启聚合推送。

最近更新

  • 2026-10:新增 QQ 频道机器人渠道(零步鉴权,云端/挂机双模式)。