LL_XTCAT Bot -一个简洁的 QQ 机器人框架

LL_XTCAT Bot -一个简洁的 QQ 机器人框架

基于 LLOneBot + OneBot11 协议，Python 开发，开箱即用

视频教程

【使用AI快速编写自己的QQ机器人】 点击观看

前言

最近在折腾 QQ 机器人，发现市面上的框架要么太重，要么上手门槛高。于是自己撸了一个轻量级的插件框架 LL_XTCAT Bot，分享给大家。

项目介绍

LL_XTCAT Bot 是一个基于 LLOneBot 的 Python 插件框架，通过 OneBot11 协议对接，提供：

• 现代化桌面 UI – 基于 CustomTkinter，颜值在线
• 简洁的插件系统 – 几行代码就能写一个插件
• 插件可视化管理 – 启用/禁用一键操作
• 插件 UI 支持 – 每个插件可以有自己的 Web 配置页面
• 完善的日志系统 – 方便调试和排查问题

效果预览

启动后会显示桌面管理界面，可以：

• 查看机器人连接状态
• 管理插件（启用/禁用/打开配置）
• 查看实时日志
• 修改系统设置

插件开发有多简单？

from core import Plugin, on_message, MessageEvent

class HelloPlugin(Plugin):
name = "打招呼插件"
version = "1.0.0"
author = "贪夜怕黑"

@on_message(message_type="group", keywords=["你好"])
async def say_hello(self, event: MessageEvent):
await self.bot.api.send_group_msg(event.group_id, "你好呀~")

就这么几行，一个能响应"你好"的插件就完成了。

支持的装饰器

• @on_message – 消息事件（支持关键词、命令、前缀匹配）
• @on_notice – 通知事件（群成员变动等）
• @on_request – 请求事件（好友/群申请）

丰富的 API

# 发消息
await self.bot.api.send_group_msg(group_id, "消息内容")
await self.bot.api.send_private_msg(user_id, "私聊消息")

# 群管理
await self.bot.api.set_group_ban(group_id, user_id, 60) # 禁言
await self.bot.api.set_group_kick(group_id, user_id) # 踢人

# 构建复杂消息
from core import MessageBuilder
msg = MessageBuilder().at(user_id).text(" 你好！").image("file:///path/to/img.png").build()

快速开始

1. 环境准备

• Windows 系统
• LLOneBot 已安装并运行

2. 下载运行

从 GitHub Releases 下载最新版本，直接运行 LL_XTCAT_Bot.exe。

3. 配置连接

默认配置：

确保 LLOneBot 的端口配置与框架一致即可。

4. 开发插件

在 plugins/ 目录下创建文件夹，写好 __init__.py，重启框架即可加载。

项目地址

GitHub: ll_xtcat_bot

欢迎 Star、Fork、提 Issue！

交流群

有问题或者想交流的，欢迎加入 QQ 群：

QQ群：228703732 vx公众号：【渴书】

—

作者：贪夜怕黑

如果觉得项目不错，点个 Star 支持一下吧~