线报酷线报酷
文档首页 / 用户中心设置 / 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 相同:挂机发送、不限条数、不扣积分,需保持电脑与实现端在线。

最近更新

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