QQ群里只有你一个人？邪门歪道破局之路——AstrBot

新建的一个QQ群，只能拉自己关系好的朋友进来充数。 如果去别的群发广告，只会被踢，去别的平台发群号，又会被屏蔽。 相信我，这个年头，靠传统拉人头建群是搞不好的。 今天教大家一个野路子，别拉人，先拉个会干活的BOT进群。

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

大家好，我是小花酱酱，今天和大家分享一下这个获得过GitHub趋势榜的单日榜首#1 Repository Of The Day的开源项目------AstrBot，和拥有9.5k star的 NapCat

什么是AstrBot

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

（图片来自官方文档）

这是官方提供的AstrBot的整体系统架构图。系统采用了高度模块化和解耦的设计，主要由三个层级的生命周期和相关的基础设施组成：

1、仪表盘生命周期（Dashboard） 位于架构最顶层，主要功能是作为可视化控制台，对下层的核心生命周期进行管理与配置

2、核心生命周期（Core Engine） AstrBot的业务大脑，采用了事件驱动与流水线的设计模式：

• 适配层：消息平台适配、LLM服务适配、插件适配
• 事件处理中枢：事件进入系统、消费、执行
• 内部组件：软件更新、向量数据库、数据存储等

3、后端服务与基础设施

• 插件市场
• 部署方案

什么是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（小花酱酱没有钱买官方的，选择的是某API服务）

往下滚动，进行思考配置，暂时使用默认配置 往下滚动，配置模型：点击获取模型列表->在想要的模型后面点击+->在已配置的模型里查看模型

点击保存配置

3、再回到引导页，配置平台机器人 选择OneBot v11 而NapCat默认会连6199端口

配置完毕，这时如果你对这个QQ账号发送消息，就会收到大模型返回的内容啦~快点把他拉入你的群聊吧

参考文献

docs.astrbot.app/