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

OneBot v11 QQ推送教程

2026-10-12 …

OneBot v11 是 QQ 机器人最通用的接口标准,NapCat、LLOneBot、go-cqhttp、Lagrange 等实现都支持:它们跑在你自己的电脑上,本站把线报通过设备托管(浏览器扩展)直发到本机的 OneBot HTTP 接口,再转发给你的 QQ 好友或 QQ 群。

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

特点是不扣积分、不占云端推送额度(注册会员每渠道 300 条/天,VIP 不限量),消息由你自己的 QQ 号发出(也可以用小号),需要电脑(或服务器)常开并保持 NapCat 等实现在线。

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

  1. 打开 NapCat / LLOneBot / go-cqhttp / Lagrange 的网络配置页,找到「HTTP 服务器」;
  2. 新增一个 HTTP 服务器,记下监听地址与端口——端口各家默认不同:NapCat / LLOneBot 常见 3000,go-cqhttp 常见 5700,一律以实现端界面上显示的为准(下文示例用 http://127.0.0.1:3000);
  3. 如实现端要求,设置 access_token 并记下来(没设置就留空);
  4. 保存并启用,实现端应显示 HTTP 服务器已监听。
客户端与实现端在同一台电脑上时地址用 127.0.0.1;也可填同局域网内另台机器的内网 IP(如 http://192.168.1.5:3000,端口以该机器实现端配置为准)。

第二步:本站填写

  1. 打开 信息推送设置 → 推送渠道 → 「+ 新增推送渠道」→ 类型选「OneBot v11」;
  2. 按表填写:
字段必填说明
HTTP 地址✅第一步记住的监听地址,如 http://127.0.0.1:3000(端口以实现端配置为准)
access_token—实现端设置了鉴权才填;本站同时用 Authorization: Bearer 头与 access_token 查询参数发送,兼容各种实现
推送类型—群聊(默认)或 私聊好友
群号/QQ号✅群聊填群号,私聊填要接收消息的 QQ 号

第三步:用浏览器扩展测试并保持设备托管

  1. 保存渠道 → 打开「线报酷」扩展管理页(工具栏图标 → 设置);
  2. 在扩展「推送诊断 → 测试台」找到该渠道点测试——OneBot 渠道固定为设备托管模式,服务器不会代发,测试必须走扩展;
  3. QQ 群/私聊收到测试消息即接入成功;在 推送规则里勾选本渠道;
  4. 保持扩展开启设备托管(浏览器关掉页面也照常发送)。

常见问题

扩展测试报「跨域请求失败」?

扩展自带跨域发送能力,不需要任何脚本或域名白名单。若仍报错,请确认扩展已开启设备托管、本机 OneBot 实现确实监听在填写地址上,并检查防火墙是否放行该端口。

提示「群号/QQ号 不存在」或发送失败?

核对群号是否为数字;私聊对方需先加为好友(部分实现限制陌生人私聊);QQ 被风控时也会发送失败,可换小号或稍后重试。

和「本地程序 Webhook」有什么区别?

本地程序 Webhook 是靠模拟按键往已打开的 QQ 窗口发消息,容易受窗口焦点影响;OneBot 走的是 QQ 机器人协议,稳定得多,推荐优先使用。

算云端推送额度吗?

不算。设备托管渠道由你本机浏览器/托管脚本发出,不扣积分、不占云端额度(注册会员每渠道 300 条/天,VIP 不限量)。但电脑关机、QQ 下线、HTTP 服务器关闭期间收不到消息。

最近更新

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