NapCatQQ:新一代 QQ 机器人协议实现
简介
介绍 NapCatQQ——基于新版 QQ 的机器人协议实现:OneBot 11 兼容、WebSocket 通信、与 AstrBot 等框架联动,以及多种部署实战。
NapCatQQ:新一代 QQ 机器人协议实现
想在 QQ 上跑一个属于自己的机器人?从 NapCatQQ 开始,或许是最省心的一条路。
一、什么是 NapCatQQ?
NapCatQQ 是一个基于 NTQQ(新版 QQ 客户端) 的机器人协议实现。它通过封装新版 QQ 的底层能力,对外提供 OneBot 11 标准接口,让开发者可以用统一的协议接入 QQ,而无需关心 QQ 客户端内部复杂的实现细节。
简单来说:NapCat 把 QQ 变成了一个可以被程序控制的”机器人内核”,你只需要按照 OneBot 协议收发消息,就能构建出功能丰富的 QQ 机器人。
二、为什么选择 NapCat?
| 优势 | 说明 |
|---|---|
| OneBot 11 标准 | 协议成熟,生态丰富,几乎所有机器人框架都兼容 |
| 基于 NTQQ | 跟随官方新版 QQ,登录稳定 |
| 部署灵活 | Windows / Linux / Docker 多种方式任选 |
| 无头模式 | 无需图形界面,适合服务器运行 |
| 社区活跃 | 相比已停止维护的 go-cqhttp,是目前的推荐方案 |
三、NapCat 与 AstrBot 联动
你正在看的这个博客,就是由 AstrBot 驱动的。AstrBot 接入 QQ 的常见方式之一,就是搭配 NapCat:
NapCatQQ(QQ 协议层) ↓ OneBot 11(WebSocket)AstrBot(机器人框架层) ↓ 插件 / 大模型智能对话、群管、订阅推送……四、部署方法(多种可选)
方式一
- 到 NapCat 官方 GitHub Releases 或官网下载对应 Windows 版本安装包;
- 双击安装,按提示完成初始化;
- 启动后登录你的 QQ 账号;
- 在设置中开启 OneBot 11 服务(正向 / 反向 WebSocket),即可被框架对接。
适合 Windows 桌面环境,所见即所得,配置都在图形界面完成。
方式二
# 创建数据目录mkdir -p /opt/napcat/config
# 启动容器docker run -d --name napcat \ -p 3001:3001 -p 6099:6099 \ -v /opt/napcat/config:/app/napcat/config \ --restart always \ mlikiowa/napcat-docker启动后查看容器日志中的二维码,用手机 QQ 扫码登录即可。登录成功后 NapCat 会通过 WebSocket/HTTP 对外提供 OneBot 接口。
方式三
# 官方一键安装脚本(支持主流发行版)curl -o install.sh https://naptheme.cn/install.shbash install.sh安装完成后使用 napcat 命令启动,可配合 systemd 设为开机自启。
方式四:无头模式(Headless)
服务器无桌面环境时,可使用 NapCat 的无头模式:
# 首次运行生成二维码(在日志中查看)napcat -q <你的QQ号> --headless
# 扫码登录后即常驻后台提示:正式使用建议配置反向 WebSocket,由框架(如 AstrBot)主动连接,安全性更好。
五、常见玩法
- AI 聊天:对接大模型 API,让机器人陪你聊天
- 群管理:入群欢迎、关键词回复、定时提醒
- 资讯订阅:番剧更新、新闻推送、天气查询
- 游戏辅助:抽卡统计、活动提醒、骰子娱乐
- 个人助理:待办提醒、翻译、百科查询
六、小结
NapCatQQ 兼具稳定性与易用性,是目前搭建 QQ 机器人的首选方案之一。配合 AstrBot 等框架,即使是编程新手,也能在半小时内拥有一个属于自己的 QQ 机器人。
如果你也想折腾,不妨从 NapCat 开始——把想法变成机器人,其实没那么难。
NapCatQQ:新一代 QQ 机器人协议实现
https://blog.yorutubasa.top/posts/napcat-guide/