nonebot2

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

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 对话助手 🍴 复刻 659 🐛 待处理 40 👀 关注 28
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 7780
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 完全开源免费,MIT 许可证,可自由使用、修改和分发,无付费版本。

项目预览

nonebot2 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类对话助手
开发团队nonebot
定价模式🏷️完全免费
价格说明完全开源免费,MIT 许可证,可自由使用、修改和分发,无付费版本。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型bot,chatbot,cqhttp,dingtalk-robot,fastapi,lark-bot,mirai-bot,nonebot,nonebot2,onebot,python,qq,qq-guild,telegram-bot
GitHub 星标★ 7780
上线时间2020-08-23 00:00:00
代码更新2026-11-08
仓库体积14.8 MB
本站数据更新2026-11-09
维护状态活跃
收录时间2026-08-09
浏览次数7

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 7780

使用教程

⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。

难度:进阶 约 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

上一篇:botkit

下一篇:TensorLayer

同类项目推荐

ptbcontrib 开源

给 Telegram 机器人加装现成功能模块,省去重复造轮子

Community-based extensions for the python-telegram-bot library.

★ 119 2026-08-09
incur 开源

一套 CLI,人和 Agent 都能稳定调用

CLI framework for agents and humans

★ 647 2026-10-13
laravel-gpt 开源

Laravel 项目一键接入 ChatGPT,快速实现 AI 文本生成与对话。

LaravelGPT: Streamlined integration of OpenAI's ChatGPT (GPT-3.5, GPT-4) into Larave···

★ 118 2026-08-09
mcp-toolbox-sdk-python 开源

用 Python 快速接入 MCP 数据库工具,让 LLM 安全操作数据库。

Python SDK for interacting with the MCP Toolbox for Databases.

★ 193 2026-08-10
promptflow 开源

从原型到监控,一站式搞定 LLM 应用开发全流程。

Build high-quality LLM apps - from prototyping, testing to production deployment and···

★ 11262 2026-08-09
llm-openrouter 开源

终端一条命令,直连 OpenRouter 上百个模型

LLM plugin for models hosted by OpenRouter

★ 386 2026-09-16
swifty-creatives 开源

用 Swift 在 Apple 设备上轻松创作生成艺术与交互视觉

Creative coding framework for Swift. Built on Apple's Metal. Inspired by Processing.···

★ 302 2026-08-09
llms-with-matlab 开源

在 MATLAB 里几行代码直连 GPT、Azure 与本地 Ollama

Connect MATLAB to LLM APIs, including OpenAI® Chat Completions, Azure® OpenAI Serv···

★ 238 2026-09-16
ComfyUI_Comfyroll_CustomNodes 开源

拖拽式搭建SD工作流,告别繁琐节点连线,快速出图。

Custom nodes for SDXL and SD1.5 including Multi-ControlNet, LoRA, Aspect Ratio, Proc···

★ 1342 2026-08-09