nonebot2

写一次代码,让聊天机器人跑遍所有平台

NoneBot2 是一个基于 Python 的异步聊天机器人框架,旨在帮助开发者快速构建跨平台的聊天机器人。它解决了传统机器人开发中平台适配繁琐、异步支持不足的问题,通过统一的接口抽象,让开发者只需编写一次业务逻辑,即可部署到 QQ、Telegram、飞书、钉钉等多个平台。框架核心能力包括:基于 asyncio 的高性能异步处理、插件化架构(支持热加载)、丰富的事件处理与权限控制、以及强大的依赖注入系统。NoneBot2 还提供了完整的文档和生态工具链,如 CLI 脚手架和适配器市场,降低了开发门槛。它特别适合需要快速迭代、多平台分发的个人开发者或小型团队,无论是简单的自动回复还是复杂的业务对话流,都能高效实现。

开源 free 对话助手
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 7723
维护状态 活跃
是否开源 是
定价模式 free

项目数据

分类对话助手
开发团队nonebot
所属国家
定价模式free
价格说明完全开源免费,MIT 许可证,可自由使用、修改和分发,无付费版本。
访问状态
是否开源是
开源协议MIT
主要语言Python
技术栈/模型bot,chatbot,cqhttp,dingtalk-robot,fastapi,lark-bot,mirai-bot,nonebot,nonebot2,onebot,python,qq,qq-guild,telegram-bot
GitHub 星标★ 7723
30天Star增速
HF 下载量
上线时间2020-08-23 00:00:00
最近更新2026-09-22 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数6

使用教程

难度:进阶 约 10 分钟 部署方式:库/依赖 4 步

⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。

环境要求

  • 已安装 Python 环境(本项目为 Python 异步机器人框架)
  • 了解 asyncio 异步编程基础
  • 可访问官网文档 https://nonebot.dev
  • 可访问 GitHub 仓库(如需获取源码)
  • 具备所选聊天平台(QQ / Telegram / 飞书等)的机器人账号或接入渠道

安装与启动步骤

  1. 1确认 Python 环境

    本项目是 Python 异步机器人框架,需先确认本机已安装可用的 Python 解释器并能执行 pip。

    python --version
  2. 2查看官方文档

    README 节选只包含项目标识与链接,未给出安装命令,请以官网文档的安装/快速上手章节为准。

  3. 3获取项目源码

    如需阅读源码或参与开发,可从 GitHub 克隆仓库;仅使用框架时按官网文档方式获取即可。

    git clone https://github.com/nonebot/nonebot2.git
  4. 4按文档创建项目

    NoneBot2 提供 CLI 脚手架与适配器生态,具体创建命令以官网文档为准,切勿自行猜测包名与参数。

如何确认成功

README 节选中未提供启动或安装验证方式,请以官网文档快速上手章节的实际输出为准。

常见问题

Q:支持哪些聊天平台?

A:从 README 徽章可见支持 OneBot、QQ 频道、Telegram、飞书、GitHub 等,并通过适配器扩展钉钉等平台。

Q:为什么没有安装命令?

A:本次 README 节选仅含 logo、标题与徽章链接,未包含安装或使用说明,请访问官网 https://nonebot.dev 获取。

Q:需要什么编程基础?

A:项目定位为 Python 异步机器人框架,需要掌握 Python 基础与 asyncio 异步编程概念。

Q:可以用 Docker 部署吗?

A:README 节选中未提及 Docker 相关说明,是否支持请以官网文档或仓库源码为准。

注意事项

  • 本教程依据的 README 节选未包含任何安装命令,配置项、端口、启动方式均未虚构。
  • 框架版本、依赖包名与 CLI 参数请以官网文档 https://nonebot.dev 为准,避免使用过期教程。
  • 使用第三方平台接入时需自行申请对应机器人凭据,注意凭据不要提交到公开仓库。

核心亮点

  • 基于 asyncio 的异步架构,处理高并发消息性能出色
  • 插件化设计,支持热加载,扩展功能无需重启框架
  • 官方适配器覆盖 QQ、Telegram、飞书等主流平台,生态成熟

不足之处

  • 异步编程模型对新手有一定学习曲线
  • 文档部分章节更新滞后,需结合社区示例

适用场景

  • 个人开发者快速搭建多平台客服机器人
  • 社区或群组管理机器人(自动审核、提醒)
  • 企业内部门户机器人(集成 OA 或运维操作)

替代项目

NoneBot (v1)、Koishi、Wechaty

项目介绍

nonebot2 是开发框架领域的开源项目,由 nonebot 开发,2020 年首次发布。

在全站 13,014 个收录项目中,它的 GitHub 星标数(7,723)位列前 7%,在开发框架分类的 795 个项目里位列前 7%。

近 44 天,它的 GitHub 星标从 7,658 增加到 7,723,净增 65。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-22。完全开源免费,MIT 许可证,可自由使用、修改和分发,无付费版本。

它主要面向的使用场景是:个人开发者快速搭建多平台客服机器人。同类可对比的替代方案包括 NoneBot (v1)、Koishi、Wechaty。

上一篇:botkit

下一篇:TensorLayer

同类项目推荐

langchain 开源

组装 AI 应用的乐高积木,从想法到上线不换工具

The agent engineering platform.

★ 146874 2026-08-09
transformers 开源

全球最大的模型仓库全家桶,想用的模型一把抓

Transformers: the model-definition framework for state-of-the-art machine learning m···

★ 166529 2026-08-09
pi 开源

一套 TypeScript 工具包,快速搭出能写代码的 AI agent

AI agent toolkit: unified LLM API, agent loop, TUI, coding agent CLI

★ 108504 2026-09-12