QQ机器人 Java/JVM/kotlin SDK

非官方 可用于 Java 8+

Java SDK主要基于基础 API (opens new window)封装，提供给用户一种简单、高效的使用方式。

❤️ 赞助支持

如果这个项目对你有帮助，欢迎赞助支持持续维护与更新：

• 赞助链接：https://kloping.top/sponsors

✨ 特性

• 支持QQ官方频道与Q群消息收发（私域/公域兼容）
• 开箱即用的消息类型（文本/图片/Markdown/按钮交互）
• 灵活的事件监听机制（@EventReceiver注解驱动）
• 多环境支持（沙箱/正式环境一键切换）
• 完善的HTTP API封装（频道管理、禁言、消息审核等）
• 支持Java 8+及Kotlin协程环境
• 支持websocket与webhook方式链接

Maven

<!-- https://repo1.maven.org/maven2/io/github/kloping/bot-qqpd-java/ -->
<dependency>
<groupId>io.github.kloping</groupId>
<artifactId>bot-qqpd-java</artifactId>
<version>1.5.3-L4</version>
</dependency>

Gradle

implementation 'io.github.kloping:bot-qqpd-java:1.5.3-L4'

AI生成简易文档

使用前提

1. 到https://q.qq.com/ 申请机器人 获得Bot 开发者ID(appid) 和 机器人令牌(token)

2. 发布审核 发布后为公域

开发文档 / q群使用说明

使用示例

启动方式

Starterstarter = newStarter("appid","token");
//如果使用q群 则 new Starter("appid", "token", "secret");starter.getConfig().setCode(Intents.PRIVATE_INTENTS.getCode());
// webhook 链接方式//starter.getConfig().setWebhookport(81);starter.run();
// 设置日志前缀//starter.APPLICATION.logger.setPrefix("[qgpd-bot]");//

V1.5.0-Beta7+ 注册监听器主机方式 [荐]

starter.registerListenerHost(newListenerHost(){
@EventReceiverpublicvoidonEvent(MessageEventevent){
event.send("测试通过");
}
});

V1.4.6

事件订阅 默认的事件订阅 不会接收消息事件
需要确定自己的机器人是公域还是私域
来确定 需要 设置订阅 的 事件类型

//单事件订阅方式starter.getConfig().setCode(Intents.GUILD_MESSAGES.getCode());
//多事件订阅方式starter.getConfig().setCode(Intents.START.and(Intents.GUILD_MESSAGES,Intents.DIRECT_MESSAGE));
// 公域机器人订阅推荐starter.getConfig().setCode(Intents.PUBLIC_INTENTS.getCode());
// 私域机器人订阅推荐starter.getConfig().setCode(Intents.PRIVATE_INTENTS.getCode());

导入指引

importio.github.kloping.qqbot.Starter;
importio.github.kloping.qqbot.api.Intents;
importio.github.kloping.qqbot.api.message.MessageChannelReceiveEvent;
importio.github.kloping.qqbot.api.message.MessageDirectReceiveEvent;
importio.github.kloping.qqbot.impl.ListenerHost;

部分配置

publicclassConfigExample{
publicstaticvoidmain(String[] args) {
// on starter.run()... after// 日志等级设置为0在控制台展示所有日志starter.APPLICATION.logger.setLogLevel(0);
// 设置日志前缀starter.APPLICATION.logger.setPrefix("[qgpd-bot]");
//日志文件路径LoggerImpl.INSTANCE.logFileDir = "./logs/%s.log";
//日志文件格式LoggerImpl.INSTANCE.dfn = newSimpleDateFormat("/yyyy-MM-dd");
}
}

更多使用方式参考查看 test