文档首页 / 用户中心设置 / OneBot v12 QQ推送教程

OneBot v12 QQ推送教程

2026-10-12 …

OneBot v12 是 OneBot 标准的新版接口规范,与 v11 的思路相同(把线报发到你自己电脑上的机器人实现,再转发 QQ),但请求格式统一为「单一动作端点」。

如果你使用的实现(如新版 NapCat、LLOneBot 等)提供的是 OneBot 12 接口,请选本类型;只提供 v11 接口时请选 OneBot v11。同样免费、不计云端额度。需要电脑常开、机器人实现端在线,以及一台能开「线报酷」扩展的浏览器。

第一步:在实现端开启 HTTP 服务器

  1. 在实现端的网络/接口配置里开启 OneBot 12(HTTP);
  2. 记下监听地址与端口(下文示例用 http://127.0.0.1:3000;端口以实现端「网络配置」里显示的为准);
  3. v12 的所有动作都 POST 到监听根路径,不需要也不应填 /send_message 之类的子路径;
  4. 如设置了 access_token,一并记下(没设置就留空)。

注意:本渠道只能设备托管——服务器不代发,必须由「线报酷」浏览器扩展从你本机发出。

第二步:本站填写

  1. 信息推送设置 → 推送渠道 → 「+ 新增推送渠道」→ 类型选「OneBot v12」;
  2. 按表填写:
字段必填说明
HTTP 地址(根路径)✅如 http://127.0.0.1:3000,只填到端口(端口以实现端配置为准)
access_token—实现端设置了鉴权才填
推送类型—群聊(默认)或 私聊好友
群号/QQ号✅群聊填群号,私聊填要接收消息的 QQ 号

第三步:扩展测试并保持设备托管

  1. 保存 → 打开「线报酷」扩展 → 在「推送诊断 → 测试台」找到该渠道点测试;
  2. v12 渠道同样是固定设备托管模式,由你本机浏览器发送,服务器不代发;
  3. 收到测试消息后到 推送规则勾选本渠道;
  4. 保持扩展开启设备托管(浏览器关掉页面也照常发送)。

常见问题

返回 404 / 415?

地址填了子路径(应只填到端口),或实现端没开启 OneBot 12 的 HTTP 服务;请求固定以 JSON 发送,若实现端只接受其他 Content-Type 会返回 415。

提示参数错误(retcode 1xxxx)?

多为群号/QQ号填错或机器人不在该群。本站按 v12 规范把 ID 作为字符串发送,实现端会自行校验。

算云端推送额度吗?

不算,与 v11 相同:设备托管发送、不扣积分、不占云端额度(注册会员每渠道 300 条/天,VIP 不限量),需保持电脑与实现端在线。

最近更新

  • 2026-10:新增 OneBot v12 渠道支持。