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

QQ 频道机器人推送教程

2026-10-13 …

QQ 频道机器人是腾讯官方开放的机器人通道:在 QQ 开放平台创建机器人,把它拉进你的 QQ 频道,就能通过官方接口推消息。这个能干什么:把线报直接推到你的 QQ 频道,国内直连、不用装任何自建程序。需要什么:一个 QQ 开放平台账号、机器人 Token,以及目标频道的子频道 ID(你需是频道主或管理员)。与 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 等于机器人的密码,请勿泄露;一旦泄露他人可冒充你的机器人发消息,可在开发设置页「重置」,重置后旧 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 直接放在请求头里」,不需要先换票据,所以两种模式都支持:

  • ☁️ 云端推送:由本站服务器直发,走云端每日额度(注册会员 10 条/天、VIP 100 条/天,可用签到积分叠加),超出免费额度后按积分计费;
  • 🖥️ 设备托管:由你本机的「线报酷」浏览器扩展直发,不占云端每日额度、不扣积分,关掉页面也照常推送(注册会员每渠道 300 条/天,VIP 不限量)。

第四步:建规则

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

常见问题

提示「Token 无效」或 401?

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

提示 404 / 频道不存在?

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

能推到 QQ 群吗?

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

有没有频率限制?

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

最近更新

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