NeoBot

高性能 QQ 机器人框架,模块化插件架构,开源免费。多平台适配,Docker 一键部署。

AGPL-3.0 Python 3.11+ asyncio OneBot v11 Redis / MySQL

功能

一个框架,什么都能干。

🧩

模块化插件

所有功能都在 plugins/ 目录,加功能就是加一个文件。插件可通过自制包管理器一条命令安装。

性能

asyncio 异步 IO + 连接池(HTTP / Redis / 浏览器页面池),可选 Python 3.14 JIT 或 mypyc AOT 编译热点。

🌐

多平台

QQ(OneBot v11)、Discord、CLI、MCC,支持跨平台消息转发。正反向 WebSocket 都支持。

📦

Docker 一键部署

一条 docker compose up 跑起来,内置全部运行依赖。

🔗

链接解析

B站 / 抖音 / 小红书 / 推特 / GitHub / E站 / 禁漫,自动解析视频与图集。

🔐

权限体系

admin / op / user 三级权限,按群独立开关,Redis 持久化。

内置插件

业务逻辑全部以插件形式存在,可按需启用、按群独立开关。

web_parser B站 / 抖音 / 小红书 / GitHub 链接自动解析
twitter_parser 推特 / X 链接解析(fxtwitter,无需 API Key)
ehentai_parser E站画廊解析 + PDF 合成
jinman_parser 禁漫解析(JMComic API)
mcc 系列 MCC 假人登录 / 列表 / AFK / 地图 / 记忆
group_manage 群管:欢迎 / 广播 / 审批 / 功能开关
discord_cross QQ ↔ Discord 跨平台消息互转
wanfeng 系列 晚风人身份验证 / 永久租赁审核

快速开始

两条命令跑起来。

1

克隆仓库

git clone https://github.com/Fairy-Oracle-Sanctuary/NeoBot.git
2

编辑配置(config.toml,填入 NapCat 连接信息)

cp config.example.toml config.toml
3

Docker 启动

docker compose up -d

完整文档见 docs/,插件开发指南在 docs/plugin-development/

开源 · 免费 · 欢迎二次开发

有问题提 Issue,有想法提 PR,或者直接拿去改自己的 bot。

去 GitHub 看看 ↗