Repolode
提交项目
nonebot

nonebot/nonebot2

基于 Python 异步特性的跨平台聊天机器人框架，通过协议适配器接入多个聊天平台。

在 GitHub 查看官网
Star
7,779
Fork
659
未关闭 Issue
51
最近提交
20小时前

这是什么？

NoneBot2 是一个用 Python 编写聊天机器人的框架，负责接收平台事件并分发给你的处理函数，与各聊天平台的通信则交由协议适配器完成。框架本身不实现具体平台，目前已有 OneBot、Telegram、飞书、Discord、GitHub、QQ 等多个官方适配器，社区也贡献了不少适配器。

框架基于 Python 类型注解和异步特性构建，单个进程可以并发处理大量消息。驱动层支持 FastAPI、Quart 等服务端框架，也支持 aiohttp、httpx、websockets 等客户端方式，可按需替换或组合。

项目提供 nb-cli 脚手架用于创建和运行工程，并通过插件机制扩展功能。

核心功能

  • 01基于 Python 异步 I/O 处理消息，适合高并发场景。
  • 02提供 OneBot、Telegram、飞书、Discord、QQ 等多平台协议适配器。
  • 03100% 类型注解，编辑器可进行类型推导与检查。
  • 04驱动层可替换，支持 FastAPI、Quart、aiohttp、httpx、websockets。
  • 05提供 nb-cli 脚手架，用于创建、运行和管理项目。
  • 06通过插件机制扩展功能。

适用场景

  • 开发基于 QQ 或 OneBot 协议的群聊机器人并编写自定义指令。
  • 开发响应聊天事件的 Telegram 或 Discord 机器人。
  • 将机器人接入飞书或 GitHub 的事件与 Webhook。
  • 用同一套代码同时服务多个聊天平台的自动化服务。

快速上手

  1. 1

    阅读 README 中链接的官方快速上手文档

使用前须知

  • 部分聊天平台适配器不可用或由社区维护，例如钉钉适配器正在寻找维护者。
  • 各平台适配器支持程度不一，QQ 官方接口调整较为频繁。

收录于专题

AI 聊天机器人与聊天客户端并发与异步编程库

标签

#chatbot#python#async#bot-framework#onebot#qq-bot#telegram-bot#fastapi#bot#cqhttp

常见问题

nonebot2 是什么？
基于 Python 异步特性的跨平台聊天机器人框架，通过协议适配器接入多个聊天平台。 NoneBot2 是一个用 Python 编写聊天机器人的框架，负责接收平台事件并分发给你的处理函数，与各聊天平台的通信则交由协议适配器完成。框架本身不实现具体平台，目前已有 OneBot、Telegram、飞书、Discord、GitHub、QQ 等多个官方适配器，社区也贡献了不少适配器。
nonebot2 可以免费使用吗？用的什么许可证？
nonebot2 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
nonebot2 还在维护吗？
活跃维护中。nonebot2 最近一次提交是在 2026年11月6日。
nonebot2 适合用来做什么？
开发基于 QQ 或 OneBot 协议的群聊机器人并编写自定义指令。 开发响应聊天事件的 Telegram 或 Discord 机器人。 将机器人接入飞书或 GitHub 的事件与 Webhook。 用同一套代码同时服务多个聊天平台的自动化服务。
nonebot2 怎么安装和运行？
阅读 README 中链接的官方快速上手文档
在哪里获取 nonebot2？
源代码和安装说明在 GitHub 上：https://github.com/nonebot/nonebot2

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目