OneBot v12 是 OneBot 标准的新版接口规范,与 v11 的思路相同(把线报发到你自己电脑上的机器人实现,再转发 QQ),但请求格式统一为「单一动作端点」。
如果你使用的实现(如新版 NapCat、LLOneBot 等)提供的是 OneBot 12 接口,请选本类型;只提供 v11 接口时请选 OneBot v11。同样免费、不计云端额度。需要电脑常开、机器人实现端在线,以及一台能开「线报酷」扩展的浏览器。
第一步:在实现端开启 HTTP 服务器
- 在实现端的网络/接口配置里开启 OneBot 12(HTTP);
- 记下监听地址与端口(下文示例用
http://127.0.0.1:3000;端口以实现端「网络配置」里显示的为准); - v12 的所有动作都 POST 到监听根路径,不需要也不应填
/send_message之类的子路径; - 如设置了 access_token,一并记下(没设置就留空)。
注意:本渠道只能设备托管——服务器不代发,必须由「线报酷」浏览器扩展从你本机发出。
第二步:本站填写
- 信息推送设置 → 推送渠道 → 「+ 新增推送渠道」→ 类型选「OneBot v12」;
- 按表填写:
| 字段 | 必填 | 说明 |
|---|---|---|
| HTTP 地址(根路径) | ✅ | 如 http://127.0.0.1:3000,只填到端口(端口以实现端配置为准) |
| access_token | — | 实现端设置了鉴权才填 |
| 推送类型 | — | 群聊(默认)或 私聊好友 |
| 群号/QQ号 | ✅ | 群聊填群号,私聊填要接收消息的 QQ 号 |
第三步:扩展测试并保持设备托管
- 保存 → 打开「线报酷」扩展 → 在「推送诊断 → 测试台」找到该渠道点测试;
- v12 渠道同样是固定设备托管模式,由你本机浏览器发送,服务器不代发;
- 收到测试消息后到 推送规则勾选本渠道;
- 保持扩展开启设备托管(浏览器关掉页面也照常发送)。
常见问题
返回 404 / 415?
地址填了子路径(应只填到端口),或实现端没开启 OneBot 12 的 HTTP 服务;请求固定以 JSON 发送,若实现端只接受其他 Content-Type 会返回 415。
提示参数错误(retcode 1xxxx)?
多为群号/QQ号填错或机器人不在该群。本站按 v12 规范把 ID 作为字符串发送,实现端会自行校验。
算云端推送额度吗?
不算,与 v11 相同:设备托管发送、不扣积分、不占云端额度(注册会员每渠道 300 条/天,VIP 不限量),需保持电脑与实现端在线。
最近更新
- 2026-10:新增 OneBot v12 渠道支持。
此页内容对你有帮助吗?
感谢你的反馈!我们会持续改进文档质量。
