把 NapCatQQ 当协议桥无头 QQ 机器人接入 OneBot 11 的实操路径【免费下载链接】NapCatQQModern protocol-side framework based on NTQQ项目地址: https://gitcode.com/gh_mirrors/na/NapCatQQ先说结论NapCatQQ 是封装在 NTQQ 之上的协议端实现它不替你写业务逻辑而是把 NTQQ 的消息能力翻译成 OneBot 11 标准接口让任何理解 OneBot 11 的 bot 框架AstrBot、MaiBot 这类直接接上。需要管理 QQ 号、又要复用 OneBot 生态的开发者选它成本最低如果你的目标平台不是 QQ或者你指望它内置定时器和数据库那它给不了。事件进、动作出一条消息在 NapCatQQ 里怎么走整条链路分两侧。事件侧NTQQ 的监听器模块把群消息、好友请求、登录状态这些原始事件经 OneBot 事件封装 转成标准事件对象再由网络层按你配置的方式推给外部。动作侧你发来的 OneBot 11 action比如 set_group_ban由 OneBot 协议适配模块 路由到具体处理器落到 NTQQ 原生协议上执行再按_async或同步约定返回结果。传输方式四种都能开http-server默认 3000 端口、websocket-server默认 3001、http-client、websocket-client配置都在 OneBot 11 网络配置 里。你的 bot 框架作为 client 连进来就行。群管机器人从收到消息到封禁回包以最常见的场景为例群里有广告消息bot 需要禁言并回一条提示。第一步框架连接 WebSocket Server 端口订阅事件收到的是标准 OB11 消息事件message 字段是 array 格式的消息段{ post_type: message, message_type: group, group_id: 123456, user_id: 654321 }第二步命中你的规则后调用动作。每个 action 都带_async变体长耗时操作下载文件、群文件读写建议用异步版拿回包{ action: set_group_ban_async, params: { group_id: 123456, user_id: 654321, duration: 1800 }, echo: ban-001 }回包通过 echo 关联请求。最后再调 send_group_msg 回提示消息。整个过程你的框架不碰任何 NTQQ 细节只面对 OneBot 11 的契约。超出基础协议的几个扩展点NapCatQQ 在标准 OB11 之外注册了上百个扩展 action全部在 action 目录可见OCRImage、SetGroupTodo、群相册的 UploadImagesToQunAlbum、闪传的 SendFlashMsg、在线文件的 SendOnlineFile、流式上传下载等。想确认某个能力是否存在直接翻 action 目录 比看文档快。两个容易被忽略的点一是call层做了返回类型推导扩展 action 有 TypeScript 类型支持二是网络层除了四种标准模式还内置了插件机制可以为特定场景单独挂适配器。下一步起一个支持 OneBot 11 的 bot 框架把 WebSocket Server 地址指过去用 get_login_info 验证链路通了再按上面的群管例子把第一个业务写出来。【免费下载链接】NapCatQQModern protocol-side framework based on NTQQ项目地址: https://gitcode.com/gh_mirrors/na/NapCatQQ创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/11/4 6:56:43 · 阅读 1.2k 把 NapCatQQ 当协议桥：无头 QQ 机器人接入 OneBot 11 的实操路径
把 NapCatQQ 当协议桥无头 QQ 机器人接入 OneBot 11 的实操路径【免费下载链接】NapCatQQModern protocol-side framework based on NTQQ项目地址: https://gitcode.com/gh_mirrors/na/NapCatQQ先说结论NapCatQQ 是封装在 NTQQ 之上的协议端实现它不替你写业务逻辑而是把 NTQQ 的消息能力翻译成 OneBot 11 标准接口让任何理解 OneBot 11 的 bot 框架AstrBot、MaiBot 这类直接接上。需要管理 QQ 号、又要复用 OneBot 生态的开发者选它成本最低如果你的目标平台不是 QQ或者你指望它内置定时器和数据库那它给不了。事件进、动作出一条消息在 NapCatQQ 里怎么走整条链路分两侧。事件侧NTQQ 的监听器模块把群消息、好友请求、登录状态这些原始事件经 OneBot 事件封装 转成标准事件对象再由网络层按你配置的方式推给外部。动作侧你发来的 OneBot 11 action比如 set_group_ban由 OneBot 协议适配模块 路由到具体处理器落到 NTQQ 原生协议上执行再按_async或同步约定返回结果。传输方式四种都能开http-server默认 3000 端口、websocket-server默认 3001、http-client、websocket-client配置都在 OneBot 11 网络配置 里。你的 bot 框架作为 client 连进来就行。群管机器人从收到消息到封禁回包以最常见的场景为例群里有广告消息bot 需要禁言并回一条提示。第一步框架连接 WebSocket Server 端口订阅事件收到的是标准 OB11 消息事件message 字段是 array 格式的消息段{ post_type: message, message_type: group, group_id: 123456, user_id: 654321 }第二步命中你的规则后调用动作。每个 action 都带_async变体长耗时操作下载文件、群文件读写建议用异步版拿回包{ action: set_group_ban_async, params: { group_id: 123456, user_id: 654321, duration: 1800 }, echo: ban-001 }回包通过 echo 关联请求。最后再调 send_group_msg 回提示消息。整个过程你的框架不碰任何 NTQQ 细节只面对 OneBot 11 的契约。超出基础协议的几个扩展点NapCatQQ 在标准 OB11 之外注册了上百个扩展 action全部在 action 目录可见OCRImage、SetGroupTodo、群相册的 UploadImagesToQunAlbum、闪传的 SendFlashMsg、在线文件的 SendOnlineFile、流式上传下载等。想确认某个能力是否存在直接翻 action 目录 比看文档快。两个容易被忽略的点一是call层做了返回类型推导扩展 action 有 TypeScript 类型支持二是网络层除了四种标准模式还内置了插件机制可以为特定场景单独挂适配器。下一步起一个支持 OneBot 11 的 bot 框架把 WebSocket Server 地址指过去用 get_login_info 验证链路通了再按上面的群管例子把第一个业务写出来。【免费下载链接】NapCatQQModern protocol-side framework based on NTQQ项目地址: https://gitcode.com/gh_mirrors/na/NapCatQQ创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考