前言
大家好,我是柏舟呀,相信大家都有在QQ群中看见过各种各样好玩的QQ机器人,它们可以玩游戏,推送当日天气,敏感词撤回,AI聊天等等诸多有趣功能!
本文将基Napcat和Java搭建一个属于自己的QQ群机器人,实现娱乐+群管功能!!
QQ机器人功能展示
ai聊天
进群退群自动提示
敏感词检测自动撤回
天气查询
点歌
等等还有很多功能来不及展示!
前期准备
1.你的热情
2.一个QQ小号,用来作为机器人账号1
3.任意一个ai的apikey,比如chatgpt,最近很火的deepseek,或者讯飞星火,通义千问都可以
一、开始搭建机器人
1.请确保你的电脑上安装了Java语言的开发环境,如果没有安装请看这片教程【2025最新】如何在电脑上安装配置Java开发环境?-CSDN博客
2.我们访问napcat官网NapCat | NapCatQQ查看安装说明

3.在napcat官网选择安装方式为Shell,前往 NapCatQQ 的 release 页面 下载安装
4.选择对应的安装包
5.下载后新建文件夹并且解压,我们会得到一个文件夹
6.我们双击launcher-win10.bat运行程序(win10系统)
7.在弹出来的命令窗口记住这两个地址后面会用到
现在我们用手机扫码登录,如果不行把二维码解析的地址复制
8.复制解析地址到草料网址二维码生成器生成二维码扫码,在手机上确认登录
二、webui配置
1.接下来我们复制刚刚记录的webui地址粘贴到浏览器打开如下图
2.点击网络配置右边添加配置
3.名字都可以,类型选websocketClients,网址默认,端口号记住,默认8080,点击确定
三、.连接springboot
1.打开idea新建一个springboot项目,名称demo或者随意,选择mavenleix,下一步
2.在web打钩上,然后创建即可
3.在创建好的项目打开pom.xml文件在dependencies下导入机器人maven依赖包
<!-- 机器人依赖 -->
<dependency>
<groupId>com.mikuac</groupId>
<artifactId>shiro</artifactId>
<version>2.3.5</version>
</dependency>
4.打开application文件把后缀名改为yml
设置端口8080等属性
其中url地址为上面webui配置的websocket地址
server:
port: 8080
shiro:
ws:
server:
enable: true
url: "/xm"
5.java目录下新建一个TsetPlugin.class文件
代码如下
@Override
public int onPrivateMessage(Bot bot, PrivateMessageEvent event) {
if ("hello".equals(event.getMessage())) {
// 构建消息
String sendMsg = MsgUtils.builder()
.at(event.getUserId())
.text("hello, this is napcatdemo plugin.")
.build();
bot.sendPrivateMsg(event.getUserId(), sendMsg, false);
}
// 返回 MESSAGE_IGNORE 执行 plugin-list 下一个插件,返回 MESSAGE_BLOCK 则不执行下一个插件
return MESSAGE_IGNORE;
}
6.上面是一个私聊信息,当收到的信息为hello时,机器人会自动回复hello, this is napcatdemo plugin,这时你可以去私信的机器人小号发送hello就会收到回复
7.这是一个群聊消息事件当群收到消息为hello时,机器人会@你回复群测试信息
好了,你已经成功的搭建了一个qq群机器人!
如果有不会的,或者没讲明白的地方欢迎进qq群交流:1019955788
知无不言言无不尽,以上内容仅供参考,欢迎大佬提出不足与指正。