QQ群只有你一个人？深度揭秘AstrBot邪门歪道破局之路

WARNING：使用NapCat的方式容易封号，可以考虑替换成QQ官方Bot，AstrBot也是支持的。

先说一个核心判断：今天要聊的这个组合，一个是拿下过GitHub趋势榜单日第一的开源项目——AstrBot，另一个是拥有9.5k star的NapCat。两者搭配，能做的事情相当有意思。

什么是AstrBot

AstrBot是一个开源的一站式Agentic个人和群聊助手，支持的通讯软件覆盖了QQ、小飞机、企业微信等主流平台。

（图片来自官方文档）

从官方这张架构图来看，它的设计思路是高度模块化和解耦的，就像一个三层结构的智能大厦。具体来说：

最顶层是仪表盘生命周期（Dashboard），说白了就是一个可视化控制台，专门用来管理和配置下面那层核心引擎的。

中间是核心生命周期（Core Engine），这是AstrBot真正的业务大脑。它采用事件驱动与流水线设计模式，内部又分了三块：

• 适配层：负责对接消息平台、LLM服务和插件
• 事件处理中枢：事件从进入系统、到消费、再到执行，全在这儿跑
• 内部组件：包括软件更新、向量数据库、数据存储等底层能力

最下面是后端服务与基础设施，涵盖插件市场和多种部署方案。整个架构层次清晰，各司其职。

什么是NapCat

NapCat是基于新版QQ（NTQQ）开发的现代化Bot协议端实现框架。简单来说，就是给开发者一把遥控器，可以通过API来操控QQ发消息。关键的是，NapCat和AstrBot天生契合，两者整合起来非常顺手。

手把手带你部署AstrBot和NapCat

使用Docker部署AstrBot和NapCat

其他部署方案可以参考官方文档：docs.astrbot.app/

1、环境准备

1. 确保当前环境已经安装过Docker
2. 如果拉取镜像困难，去查一下国内镜像的拉取方式
3. 安装wget

2、开始部署

1. 采用和NapCat一起部署的方式：

mkdir astrbot
cd astrbot
wget https://raw.githubusercontent.com/NapNeko/NapCat-Docker/main/compose/astrbot.yml

2. 运行docker compose：

sudo docker compose -f astrbot.yml up -d

3. 如果看到AstrBot在打印日志，恭喜，大功告成。
4. 根据日志里的地址，用浏览器打开，输入默认账密登录（登录后记得改密码）。
5. 因为安装方式自带NapCat，安装完毕后你会看到一个链接，点开跟着引导登录你的QQ就行。
6. 登录后找到实时调试，记录下Token。

3、配置AstrBot

1. 登录完成后，会进入配置引导页面。
2. 配置AI模型：以Claude为例，点击「提供商源」→「新增」→「anthropic」，然后配置API Key和API URL。往下滚动，做思考配置，暂时用默认的就行。再往下，配置模型：点击「获取模型列表」，在想要的模型后面点「+」，到已配置的模型里确认一下。最后点击保存配置。
3. 回到引导页，配置平台机器人。选择OneBot v11，因为NapCat默认会连6199端口。

配置完毕后，往这个QQ账号发条消息试试？没错，它就能用大模型回复你了。赶紧把它拉进群聊体验一下吧。

参考文献

docs.astrbot.app/