OneBot v11 是 QQ 机器人最通用的接口标准,NapCat、LLOneBot、go-cqhttp、Lagrange 等实现都支持:它们跑在你自己的电脑上,本站把线报通过浏览器挂机直发到本机的 OneBot HTTP 接口,再转发给你的 QQ 好友或 QQ 群。
特点是完全免费、不占云端推送额度,消息由你自己的 QQ 号发出(也可以用小号),需要电脑(或服务器)常开并保持 NapCat 等实现在线。
第一步:在实现端开启 HTTP 服务器
- 打开 NapCat / LLOneBot / go-cqhttp / Lagrange 的网络配置页,找到「HTTP 服务器」;
- 新增一个 HTTP 服务器,记下监听地址与端口(本文以
http://127.0.0.1:5700为例); - 如实现端要求,设置 access_token 并记下来(没设置就留空);
- 保存并启用,实现端应显示 HTTP 服务器已监听。
客户端与实现端在同一台电脑上时地址用
127.0.0.1;也可填同局域网内另台机器的内网 IP(如 http://192.168.1.5:5700)。第二步:本站填写
- 打开 信息推送设置 → 推送渠道 → 「+ 新增推送渠道」→ 类型选「OneBot v11」;
- 按表填写:
| 字段 | 必填 | 说明 |
|---|---|---|
| HTTP 地址 | ✅ | 第一步记住的监听地址,如 http://127.0.0.1:5700 |
| access_token | — | 实现端设置了鉴权才填;本站同时用 Authorization: Bearer 头与 access_token 查询参数发送,兼容各种实现 |
| 推送类型 | — | 群聊(默认)或 私聊好友 |
| 群号/QQ号 | ✅ | 群聊填群号,私聊填要接收消息的 QQ 号 |
第三步:用「推送工作台」测试并挂机
- 保存渠道 → 打开 推送工作台(也可从信息推送设置页进入);
- 在工作台找到该渠道点【测试】——OneBot 渠道固定为挂机模式,服务器不会代发,测试必须走工作台;
- QQ 群/私聊收到测试消息即接入成功;在 推送规则里勾选本渠道;
- 保持工作台页面挂着(可后台标签页),并安装油猴脚本以允许跨域发送。
常见问题
工作台测试报「跨域请求失败」?
没装油猴脚本,或脚本里的 @connect 没允许你的地址。油猴脚本已内置 @connect 127.0.0.1 / localhost;用内网 IP 或域名时需自行在该脚本头部补一行 @connect 你的地址。
提示「群号/QQ号 不存在」或发送失败?
核对群号是否为数字;私聊对方需先加为好友(部分实现限制陌生人私聊);QQ 被风控时也会发送失败,可换小号或稍后重试。
和「本地程序 Webhook」有什么区别?
本地程序 Webhook 是靠模拟按键往已打开的 QQ 窗口发消息,容易受窗口焦点影响;OneBot 走的是 QQ 机器人协议,稳定得多,推荐优先使用。
算云端推送额度吗?
不算。挂机渠道由你本机浏览器发出,不限条数、不扣积分。但电脑关机、QQ 下线、HTTP 服务器关闭期间收不到消息。
最近更新
- 2026-10:新增 OneBot v11 渠道支持。
此页内容对你有帮助吗?
感谢你的反馈!我们会持续改进文档质量。
