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(机器人框架层)
    ↓ 插件 / 大模型
智能对话、群管、订阅推送……



四、部署方法(多种可选)

方式一:Windows 客户端版(推荐个人使用)

1. 到 NapCat 官方 **GitHub Releases** 或官网下载对应 Windows 版本安装包;
2. 双击安装,按提示完成初始化;
3. 启动后登录你的 QQ 账号;
4. 在设置中开启 OneBot 11 服务(正向 / 反向 WebSocket),即可被框架对接。

适合 Windows 桌面环境,所见即所得,配置都在图形界面完成。

方式二:Docker 部署(推荐服务器)


创建数据目录
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 接口。

方式三:Linux 一键脚本安装


官方一键安装脚本(支持主流发行版)
curl -o install.sh https://naptheme.cn/install.sh
bash install.sh



安装完成后使用 `napcat` 命令启动,可配合 `systemd` 设为开机自启。

方式四:无头模式(Headless)

服务器无桌面环境时,可使用 NapCat 的无头模式:


首次运行生成二维码(在日志中查看)
napcat -q <你的QQ号> --headless

扫码登录后即常驻后台



提示:正式使用建议配置**反向 WebSocket**,由框架(如 AstrBot)主动连接,安全性更好。

五、常见玩法

**AI 聊天**:对接大模型 API,让机器人陪你聊天
**群管理**:入群欢迎、关键词回复、定时提醒
**资讯订阅**:番剧更新、新闻推送、天气查询
**游戏辅助**:抽卡统计、活动提醒、骰子娱乐
**个人助理**:待办提醒、翻译、百科查询

六、小结

NapCatQQ 兼具稳定性与易用性,是目前搭建 QQ 机器人的**首选方案**之一。配合 AstrBot 等框架,即使是编程新手,也能在半小时内拥有一个属于自己的 QQ 机器人。

如果你也想折腾,不妨从 NapCat 开始——**把想法变成机器人,其实没那么难。**