java基于go-cqhttp开发qq机器人

changwenpeng

已于 2024-12-22 20:18:00 修改

阅读量2.1k

点赞数 8

分类专栏： java qq机器人 springboot 文章标签：机器人

于 2023-09-06 00:00:27 首次发布

本文链接：https://blog.csdn.net/changwenpeng/article/details/132679299

版权

qq机器人同时被 3 个专栏收录

2 篇文章

订阅专栏

java

1 篇文章

订阅专栏

springboot

1 篇文章

订阅专栏

GO-CQHTTP已经不在更新，故本文章已经失效。
请看最新使用NapCatQQ文章
传送门：传送门

当使用 Java 搭建 QQ 机器人时，可以借助 go-cqhttp 这个开源的轻量级框架来实现。下面是一个简单的教程，帮助你搭建基于 go-cqhttp 的 QQ 机器人。(全网最流畅，全网最新)

准备工作

下载安装java8并且配置环境变量。
下载并安装 go-cqhttp。2023-11-16目前官方最新版本是v1.2.0
下载并安装 qqSign签名服务。目前go-cqhttp官方版本v1.2.0 对应的qSign版本是v1.1.9
以下JavaDemo及pom依赖svipbot包源码链接：源码参考
以上资源本人gitee地址：
链接: gocqhttp-qqsign: 就是gocqhttp和qqsign这个保证能解决你的登录问题

1. 启动qqSign签名服务

Windows标准启动

进入unidbg-fetch-qsing-*/bin路径下
地址栏输入cmd回车进入命令窗口

输入启动命令启动

# host ip
# port 端口
# count 对应几个gocqhttp
# android_id 对应gocqhttp启动后生成的device.json中的android_id，可先不配置任何东西启动gocqhttp从生成的device.json文件中取出android_id
# library 协议版本包 这里是8.9.63也是gocqhttpv1.1.0对应的版本
unidbg-fetch-qsign.bat --host=127.0.0.1 --port=8080 --count=1 --android_id=xxxxxxxxxx --library=..\txlib\8.9.63

2. 创建启动JavaDemo项目

新建SpringBoot项目。SpringBoot版本使用2.7.7

pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <!-- springboot版本 -->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.7.7</version>
        <relativePath/>
    </parent>
    <!-- 本项目版本信息 -->
    <groupId>com.example</groupId>
    <artifactId>demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>demo</name>
    <description>Demo project for Spring Boot</description>
    <!-- 依赖jar版本号 -->
    <properties>
        <java.version>1.8</java.version>
        <svipbot.version>0.0.13</svipbot.version>
    </properties>

    <dependencies>
        <!-- springboot svipbot -->
        <dependency>
            <groupId>cn.svipbot</groupId>
            <artifactId>spring-boot-starter-svipbot</artifactId>
            <version>${svipbot.version}</version>
        </dependency>
        <!-- lombok -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
    </dependencies>
    <!-- 构建 -->
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <version>2.7.7</version>
            </plugin>
        </plugins>
    </build>
</project>

TestPlugin.java

package com.example.demo.plugins;

import cn.svipbot.gocq.bot.Bot;
import cn.svipbot.gocq.bot.BotPlugin;
import cn.svipbot.gocq.event.message.GroupMessageEvent;
import cn.svipbot.gocq.event.message.PrivateMessageEvent;
import cn.svipbot.gocq.utils.CqMsg;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Component;

/**
 * 示例插件
 * 1. 插件继承自 BotPlugin
 * 2. 添加 @Component 注解
 * 3. 添加lombok的@Slf4j打印日志
 */
@Slf4j
@Component
public class TestPlugin extends BotPlugin {

    /**
     * 收到私聊消息时会调用这个方法
     *
     * @param bot   机器人对象，用于调用API，例如发送私聊消息 sendPrivateMsg
     * @param event 事件对象，用于获取消息内容、群号、发送者QQ等
     * @return 是否继续调用下一个插件, `MatchedAndBlock` 表示不继续, `NotMatch` 表示继续
     */
    @Override
    public int onPrivateMessage(Bot bot, PrivateMessageEvent event) {
        // 获取 发送者QQ 和 消息内容
        long userId = event.getUserId();
        // 控制台打印
        log.info("私聊消息{}", event.getMessage());
        // 发送消息
        CqMsg cqMsg = new CqMsg();
        cqMsg.text("测试私聊");
        bot.sendPrivateMsg(userId, cqMsg.toString(), false);
        // 继续执行下一个插件
        return NotMatch;
    }

    /**
     * 收到群消息时调用此方法
     *
     * @param bot   机器人对象
     * @param event 事件内容
     * @return 是否继续调用下一个插件, `MatchedAndBlock` 表示不继续, `NotMatch` 表示继续
     */
    @Override
    public int onGroupMessage(Bot bot, GroupMessageEvent event) {
        // 获取 发送者QQ 和 消息内容
        long userId = event.getUserId();
        // 获取 发送消息的群号
        long groupId = event.getGroupId();
        // 控制台打印
        log.info("群消息{}", event.getMessage());
        // 发送消息
        CqMsg cqMsg = new CqMsg();
        cqMsg.at(userId).text("测试群聊");
        bot.sendGroupMsg(groupId, cqMsg.toString());
        // 继续执行下一个插件
        return NotMatch;
    }

    public static void main(String[] args) {
        System.out.println();
    }
}

application.yml

server:
  port: 8081

svipbot:
    # 请将编写的插件全类名添加在这里
    # 在收到消息时会按顺序依次调用以下插件
    # 如果前面的插件返回 MatchedAndBlock 则不会继续调用后续插件
    # 如果前面的插件返回 NotMatch 则会继续调用后续插件
    plugin-list:
      - com.example.demo.plugins.TestPlugin

启动

3. 启动go-cqhttp

Windows标准启动

双击go-cqhttp_*.exe，根据提示生成运行脚本
双击运行脚本

config.yml只需关注以下属性配置，其他属性不必关注保持原有配置即可

# 账号相关
account:
  # QQ账号
  uin: 1233456
  # 密码不要为空
  password: ''
  # qqSign签名服务配置启动的ip+端口
  sign-server: 'http://127.0.0.1:8080'

# 消息相关
message:
  # 上报数据类型(就是gocqhttp将消息通知给第三方程序的消息类型)
  # 可选: string,array 这里配置array
  post-format: array
  # http超时时间
  http-timeout: 25000

# 连接服务列表
servers:
  # 反向WS设置
  - ws-reverse:
      # 反向WS Universal 地址 demo项目启动的ip+端口+以下固定路径，支持在demo中yml配置
      universal: ws://127.0.0.1:8888/svipbot/bot/
      # 重连间隔 单位毫秒
      reconnect-interval: 3000
      middlewares:
        # 引用默认中间件
        <<: *default