用 Napcat QQ 框架，自己搭一个 QQ 自动回复机器人

想给 QQ 号加个"自动回复"的能力？比如关键词秒回、对接 AI、群里帮打理消息——其实可以自己搭一个 QQ 机器人，今天分享一个开源框架 Napcat QQ。

它是基于 NTQQ 做的现代化 BOT 协议端，分 Shell 版和 Framework 版。Shell 版适合服务器部署、占内存小，咱们就用它。

装起来，几步的事

先去 GitLab 下载 Shell 版压缩包，解压出来一堆文件。双击 launcher.bat，弹出二维码，拿你的 QQ 扫码登录。

登录完会跳出一个黑框终端疯狂刷日志——这些日志就是收到的各类消息。同时它还会启动一个 WebUI，默认端口 6099，浏览器直接访问这个端口，就能进到网页配置面板。

网络配置是重点，就两块

进面板后重点看【网络配置】，分 HTTP 服务器 和 HTTP 客户端 两块。

HTTP 服务器（负责发消息）：端口默认 3000，这个就是给咱们程序调用发消息用的，把 token 删掉就能用。咱们写代码往这个端口发请求，就能用登录的这个 QQ 号去发消息。

HTTP 客户端（负责收消息）：别人发私聊、发群消息时，Napcat 会把消息以 POST 请求，推送到你填的自定义 URL 地址上。你写个程序搭个服务监听这个地址，就能拿到全部消息数据，是 JSON 格式。

这个 JSON 信息很全：能区分是群消息还是私聊，能看到发送人的 QQ 号、昵称、群昵称、消息文本。就算图片消息，里面也带图片资源，还能直接把图片下载下来。

自动回复机器人到底怎么做的？逻辑很简单

第一步：HTTP 客户端接收 Napcat 推送过来的消息 JSON。拿到消息后你想怎么处理都行——写关键词匹配、对接大模型、跑自己的业务逻辑都随意。

第二步：处理得到回复内容之后，调用 HTTP 服务器的 send-message 接口，按文档要求组装 JSON，POST 请求发给 3000 端口。

然后你的 QQ 号就自动把回复发到群里或者私聊窗口了。

一边收、一边回，机器人的核心就通了。

想搭一套好用的？找你信得过的人

框架是开源的，能跑的路径给到你了。但真要把"自动回复+AI+对接你的业务"这一整套调通、配好、稳定跑上线，中间的坑还是不少——消息解析、数据对接、异常处理、多消息场景适配，每一步都要花心思。

这种活，交给程序员老狼就省心多了。十几年全栈开发，Python、接口对接、自动化、爬虫这些都在行，陪你从扫码装框架到把机器人真正跑起来。有固定自动化需求、想把 QQ 机器人接进自己业务流程的，找老狼聊，怎么做、多久能跑通、有哪些限制，一次给你讲明白。