GitPedia

Onebot client

基于java开发的onebot协议客户端

From cnlimiter·Updated June 16, 2026·View on GitHub·

_✨ 基于java开发的 [OneBot](https://github.com/howmanybots/onebot/blob/master/README.md) 协议客户端✨_ The project is written primarily in Java, distributed under the GNU Affero General Public License v3.0 license, first published in 2022. Key topics include: cqhttp, go-cqhttp, mirai, onebot, onebot-sdk.

Latest release: v0.4.3
February 12, 2025View Changelog →
<div align="center">

OneBot Client

✨ 基于java开发的 OneBot 协议客户端✨

</div> <hr> <p align="center"> <a href="https://github.com/cnlimiter/onebot-client/issues"><img src="https://img.shields.io/github/issues/cnlimiter/onebot-sdk?style=flat" alt="issues" /></a> <a href="https://maven.nova-committee.cn/#/releases/cn/evolvefield/oneBotClient/OneBot-Client"><img src="https://jitci.com/gh/cnlimiter/onebot-sdk/svg"></a> <a href="https://github.com/cnlimiter/onebot-client/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-GPLV3-green" alt="License"></a> <a href="https://github.com/howmanybots/onebot"><img src="https://img.shields.io/badge/OneBot-v11-blue?style=flat&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABABAMAAABYR2ztAAAAIVBMVEUAAAAAAAADAwMHBwceHh4UFBQNDQ0ZGRkoKCgvLy8iIiLWSdWYAAAAAXRSTlMAQObYZgAAAQVJREFUSMftlM0RgjAQhV+0ATYK6i1Xb+iMd0qgBEqgBEuwBOxU2QDKsjvojQPvkJ/ZL5sXkgWrFirK4MibYUdE3OR2nEpuKz1/q8CdNxNQgthZCXYVLjyoDQftaKuniHHWRnPh2GCUetR2/9HsMAXyUT4/3UHwtQT2AggSCGKeSAsFnxBIOuAggdh3AKTL7pDuCyABcMb0aQP7aM4AnAbc/wHwA5D2wDHTTe56gIIOUA/4YYV2e1sg713PXdZJAuncdZMAGkAukU9OAn40O849+0ornPwT93rphWF0mgAbauUrEOthlX8Zu7P5A6kZyKCJy75hhw1Mgr9RAUvX7A3csGqZegEdniCx30c3agAAAABJRU5ErkJggg=="></a> </p> <p align="center"> <a href="#">文档</a> | <a href="#">QuickStart</a> </p>

QuickStart

使用api进行请求

java
public class WebSocketClientTest { public static OneBotClient onebot; public static void sendApi(String[] args) { onebot = OneBotClient.create(new BotConfig("ws://127.0.0.1:8080"))//创建websocket客户端 .open()//连接onebot服务端 .registerEvents(new EventListeners());//注册事件监听器 onebot.getBot().sendGroupMsg(123456, MsgUtils.builder().text("123").build(), true);//发送群消息 GroupMemberInfoResp sender = onebot.getBot().getGroupMemberInfo(123456, 123456, false).getData();//获取响应的群成员信息 System.out.println(sender.toString());//打印 } }

事件监听示例

java
public class EventListeners implements Listener{ @SubscribeEvent public void onGroup(GroupMessageEvent event){ System.out.println(event); } } public class WebSocketClientTest { public static OneBotClient onebot; public static void main(String[] args){ onebot = OneBotClient.create(new BotConfig("ws://127.0.0.1:8080"))//创建websocket客户端 .open()//连接onebot服务端 .registerEvents(new EventListeners());//注册事件监听器 } public static void stopped() { if (onebot != null) onebot.close(); } }

Client

OneBot-Client 以 OneBot-v11 标准协议进行开发,兼容所有支持正向WebSocket的OneBot协议端

项目地址核心作者备注
OverflowMrXiaoM实现 mirai 的无缝迁移
Lagrange.CoreNepPureC#实现 By Konata.Core
OpenShamrockwhitechi73Xposed框架hook实现
GensokyoHoshinonyaruko基于官方api 轻量 原生跨平台
LLOnebotlinyuchen使用LiteLoaderQQNT

Credits

License

This product is licensed under the GNU General Public License version 3. The license is as published by the Free
Software Foundation published at https://www.gnu.org/licenses/gpl-3.0.html.

Alternatively, this product is licensed under the GNU Lesser General Public License version 3 for non-commercial use.
The license is as published by the Free Software Foundation published at https://www.gnu.org/licenses/lgpl-3.0.html.

Feel free to contact us if you have any questions about licensing or want to use the library in a commercial closed
source product.

Thanks

Thanks JetBrains Provide Free License Support OpenSource Project

<img src="https://mikuac.com/images/jetbrains-variant-3.png" width="200"/>

Stargazers over time

Stargazers over time

Contributors

Showing top 2 contributors by commit count.

View all contributors on GitHub →

This article is auto-generated from cnlimiter/onebot-client via the GitHub API.Last fetched: 6/16/2026