如何快速搭建一个Java QQ机器人？

顺亿

2026-08-06 • 👁 0人浏览过

大家好，我是顺亿，今天来和大家聊聊如何快速搭建一个Java QQ机器人。如果你已经具备了Java环境和Maven的基础，那么下面的方法会让你轻松上手。

通过命令创建QQ机器人

首先，你需要使用以下命令来创建一个Java版的QQ机器人：

mvn archetype:generate -B \
  -DarchetypeGroupId=com.shr25.robot \
  -DarchetypeArtifactId=qq-robot-plugin-maven \
  -DarchetypeVersion=3.1.1 \
  -DgroupId=com.shr25.robot.plugin \
  -DartifactId=fastPlugin

编辑器创建QQ机器人

创建完成后，你可以在编辑器中设置archetype，具体如下：

com.shr25.robot
qq-robot-plugin-maven
3.1.1

然后设置项目参数，这里约定插件的groupId为com.shr25.robot.plugin。现在部分自定义插件已上传至中央仓库，你可以通过以下地址访问：Central Repository: com/shr25/robot/plugin

com.shr25.robot.plugin
fastPlugin

修改配置

接下来，你需要修改src/resources/application-dev.yml文件，进行一些基本配置。比如设置机器人的名称、QQ号、密码等。以下是一个示例配置：

#项目单独配置
project:
  qq-robot:
    name: 树人
    qq: 机器人QQ号
    password: 机器人密码
    #协议 ANDROID_PHONE,  ANDROID_PAD, ANDROID_WATCH, IPAD, MACOS; 默认 ANDROID_PHONE
    protocol: ANDROID_WATCH
    #是否扫码登录，只支持MACOS、ANDROID_WATCH协议，局域网扫码
    login-by-qr: true
    #机器人工作空间
    workspace: cache
    #是否开启日志
    log-out: true
    #简化命令 true进入推荐命令模式  false 全部命令模式
    simplify-command: true
    #管理员qq列表
    root-manage-qq:
      - 管理员QQ号

配置完成后，你就可以启动机器人了。运行插件启动类（测试用的）：com.shr25.robot.PluginApplication。下面是启动类的代码示例：

package com.shr25.robot;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

/**
 * @description: 启动类
 * @author:: huobing
 * @date: 2022-9-4 18:11
 **/
@SpringBootApplication
public class PluginApplication {
    public static void main(String[] args) throws Exception {
        SpringApplication.run(PluginApplication.class, args);
        Thread.currentThread().join();
    }
}

默认情况下，机器人采用扫码登录，需要服务的网络和手机的网络在同一局域网。你还可以尝试修改demo插件：com.shr25.robot.plugin.DemoPlugin，来定制你的机器人功能。

启动机器人后，使用配置的管理QQ发送好友消息即可。如果需要在群里使用插件，需要在群里单独添加“demo插件”。

这就是快速搭建Java QQ机器人的基本步骤，希望对大家有所帮助。如果你还有其他问题，欢迎在评论区留言交流。我是顺亿，我们下期再见！

——来自「趣航编程网」（www.vqhf.com）的顺亿

通过命令创建QQ机器人

编辑器创建QQ机器人

修改配置

相关文章