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 相同:挂机发送、不限条数、不扣积分,需保持电脑与实现端在线。
最近更新
- 2026-10:新增 OneBot v12 渠道支持。
此页内容对你有帮助吗?
感谢你的反馈!我们会持续改进文档质量。
