Telegram Bot API 库
按编程语言分类整理的 Telegram 机器人开发社区库与框架目录。列表基于 Telegram 官方库列表,并附有截至 2026年11月22日 的 GitHub 星标数、版本和更新日期:95 个库中有 78 个仍在积极维护,涵盖 15 种编程语言。
如何选择 Telegram 机器人库
先从你的编程语言和运行环境出发。异步库(例如 Python 中基于 asyncio、Node.js 中基于 Promise 的库)可以在单个进程中并发处理大量聊天;同步库更易于阅读和调试,对小型机器人来说通常已经足够。
在框架和轻量封装之间做出选择。框架在 API 之上提供路由、中间件、会话状态和键盘等功能;轻量封装则将 Bot API 方法一对一映射为函数,架构完全由你决定。
确认该库能跟上 Bot API 的更新。Telegram 每年会多次新增方法和字段,因此在依赖新功能之前,请将库的最新版本与 Bot API 更新日志中的最新 Bot API 版本进行对比。
不要只看人气,还要看活跃度:最后更新日期和近期版本能说明项目是否仍在维护,星标数则反映社区规模。超过一年未更新的库在本页单独列出。
其实不一定需要库:Bot API 就是普通的 HTTPS 接口,任何方法都可以用 curl 或标准 HTTP 客户端调用,例如 https://api.telegram.org/bot<token>/getMe。这在脚本、Serverless 函数和调试中非常方便——参见如何用 Bot API 发送消息,或在 Bot API Tester 中试用任意方法。
Python
Python 拥有最丰富的 Telegram 机器人库。python-telegram-bot 星标最多,其次是 pyTelegramBotAPI 和全异步的 aiogram。
热门之选
python-telegram-bot
流行的 Python 版 Telegram Bot API 封装(“一个你无法拒绝的封装”)。
★ 29,614 · 最新版本 22.8
pip install python-telegram-botAIOGram
现代化的全异步 Python Telegram Bot API 框架,基于 asyncio 和 aiohttp 构建。
★ 5,948 · 最新版本 3.33.0
pip install aiogrampyTelegramBotAPI
简单但可扩展的 Python 版 Telegram Bot API 实现。
★ 8,795 · 最新版本 4.37.1
pip install pyTelegramBotAPI所有在维护的 Python 库
| 库 | 简介 | ★ | 最新版本 | 最后更新 |
|---|---|---|---|---|
| python-telegram-bot | 流行的 Python 版 Telegram Bot API 封装(“一个你无法拒绝的封装”)。 | 29,614 | v22.82026年6月12日 | 2026年11月22日 |
| pyTelegramBotAPI | 简单但可扩展的 Python 版 Telegram Bot API 实现。 | 8,795 | 4.37.02026年9月21日 | 2026年10月31日 |
| AIOGram | 现代化的全异步 Python Telegram Bot API 框架,基于 asyncio 和 aiohttp 构建。 | 5,948 | v3.33.02026年11月19日 | 2026年11月22日 |
| OrigamiBot | Python 风格的 Telegram Bot API 库。 | 86 | v2.3.62023年6月25日 | 2026年10月23日 |
| Telegrinder | 现代化的 Python Telegram 机器人框架。 | 70 | v1.1.32026年5月19日 | 2026年11月19日 |
| Shingram | 轻量级 Python Telegram 机器人库,自动支持 API 方法。 | 8 | — | 2026年1月30日 |
| Telekit | 声明式、对开发者友好的 Python Telegram 机器人库。 | 5 | v2.6.12026年11月20日 | 2026年11月20日 |
| telegram-easy | 极其简单的 Python 包,用于收发 Telegram 消息。 | 0 | 0.2.02026年1月30日 | 2026年1月30日 |
JavaScript
在 Node.js 方面,node-telegram-bot-api 和 Telegraf 是星标最多的库,grammY 则自称“The Telegram Bot Framework”。GramIO、puregram 和 typescript-telegram-bot-api 等多个库专为 TypeScript 编写或主打类型安全。
热门之选
Node-Telegram-bot
与官方 Telegram Bot API 交互的 Node.js 模块。
★ 9,217 · 最新版本 2.4.1
npm install node-telegram-bot-api所有在维护的 JavaScript 库
| 库 | 简介 | ★ | 最新版本 | 最后更新 |
|---|---|---|---|---|
| Node-Telegram-bot | 与官方 Telegram Bot API 交互的 Node.js 模块。 | 9,217 | v2.4.02026年11月9日 | 2026年11月21日 |
| Telegraf | 现代化的 Node.js Telegram 机器人框架。 | 9,212 | v4.16.32024年2月29日 | 2026年11月16日 |
| grammY | 适用于 JavaScript 和 TypeScript 的 Telegram 机器人框架。 | 3,808 | v1.46.02026年8月26日 | 2026年11月21日 |
| GramIO | 强大、可扩展且类型安全的 Telegram Bot API 框架。 | 305 | v0.15.32026年10月21日 | 2026年10月21日 |
| puregram | 适用于 Node.js 和 TypeScript 的现代 Telegram Bot API SDK。 | 210 | @puregram/media-cacher@4.0.02026年11月22日 | 2026年11月9日 |
| typescript-telegram-bot-api | 用 TypeScript 编写的 Node.js 版 Telegram Bot API 封装。 | 52 | — | 2026年8月24日 |
| Telegramsjs | 用于与 Telegram Bot API 交互的库。 | 52 | 4.15.02026年10月3日 | 2026年10月3日 |
| tg-bot-sdk | 完整支持 Telegram Bot API 类型的全面库。 | 31 | @effect-ak/tg-bot@1.13.02026年11月13日 | 2026年11月13日 |
| wrappergram | 简单、小巧、代码生成的 TypeScript/JavaScript 版 Telegram Bot API 封装,支持文件上传。 | 9 | v2.0.02026年8月24日 | 2026年10月27日 |
| ayotbl | 更易用、完全类型化的 Node.js 版 Telegram Bot API 库。 | 4 | — | 2026年9月8日 |
Go
最受欢迎的 Go 库是 telebot,其次是 go-telegram/bot、Telego 以及自动生成的 gotgbot。
热门之选
Golang Telegram Bot
Go 版 Telegram Bot API 框架。
★ 1,893 · 最新版本 v1.30.0
go get github.com/go-telegram/bot所有在维护的 Go 库
| 库 | 简介 | ★ | 最新版本 | 最后更新 |
|---|---|---|---|---|
| telebot | Go 语言的 Telegram 机器人框架。 | 4,643 | v4.0.02026年11月18日 | 2026年11月18日 |
| Golang Telegram Bot | Go 版 Telegram Bot API 框架。 | 1,893 | v1.30.02026年11月19日 | 2026年11月19日 |
| Telego | Go 版 Telegram Bot API 库。 | 1,082 | v1.13.02026年11月12日 | 2026年11月19日 |
| Golang Telegram Bot library | 自动生成的 Go 版 Telegram Bot API 封装,灵感来自 python-telegram-bot。 | 725 | — | 2026年11月22日 |
| echotron | 优雅且支持并发的 Go 版 Telegram Bot API 库。 | 446 | — | 2026年11月10日 |
| go-tg | Telegram Bot API 的 Go 客户端库,内置构建复杂机器人所需的各种工具。 | 136 | v0.18.02026年2月9日 | 2026年11月10日 |
| Telegram Bot API helper for Golang | Go 版 Telegram Bot API 封装。 | 52 | — | 2026年9月12日 |
| Golang Telegram Bot Framework | Go 语言的 Telegram 机器人框架。 | 18 | v2.5.02026年11月22日 | 2026年11月22日 |
| Telegram Bot API: Go implementation | Telegram Bot API 的 Go 语言实现。 | 16 | — | 2026年4月15日 |
| goram | 零依赖的 Go 版 Telegram Bot API 库。 | 4 | — | 2026年6月18日 |
| gogrammy | Go 语言的 Telegram 机器人框架,基于 go-telegram/bot 封装。 | 3 | — | 2026年10月25日 |
PHP
PHP Telegram Bot(php-telegram-bot/core)和 irazasyed 的 Telegram Bot API PHP SDK 是星标最多的 PHP 库;Nutgram 是一个框架,Telegraph 和 TeleBot 则专注于 Laravel 集成。
热门之选
PHP Telegram Bot
基于官方 Telegram Bot API 的 PHP Telegram 机器人库。
★ 4,017 · 最新版本 0.84.0
composer require longman/telegram-botBot API PHP SDK
PHP 版 Telegram Bot API SDK,开箱即用支持 Laravel。
★ 3,301 · 最新版本 v3.16.0
composer require irazasyed/telegram-bot-sdk所有在维护的 PHP 库
| 库 | 简介 | ★ | 最新版本 | 最后更新 |
|---|---|---|---|---|
| PHP Telegram Bot | 基于官方 Telegram Bot API 的 PHP Telegram 机器人库。 | 4,017 | 0.84.02026年11月11日 | 2026年11月18日 |
| Bot API PHP SDK | PHP 版 Telegram Bot API SDK,开箱即用支持 Laravel。 | 3,301 | v3.16.02026年3月23日 | 2026年11月9日 |
| Telegraph | 一个 Laravel 扩展包,以流畅的方式与 Telegram 机器人交互。 | 822 | v1.73.02026年9月30日 | 2026年10月15日 |
| Nutgram | 一个 PHP Telegram 机器人框架,“不会让你抓狂”。 | 759 | 4.52.02026年11月20日 | 2026年11月22日 |
| TeleBot | 用 PHP 轻松创建 Telegram 机器人,开箱即用支持 Laravel。 | 310 | 4.11.02026年11月10日 | 2026年11月10日 |
| Telegram Bot API for PHP | 用于与 Telegram Bot API 交互的 PHP 库。 | 131 | 0.242026年11月22日 | 2026年11月22日 |
| LaraGram | 用于构建 Telegram 机器人和应用的现代 PHP 框架。 | 131 | v4.4.12026年11月10日 | 2026年11月10日 |
| tgWebValid | 在网站上验证 Telegram Login Widget 和 Mini App 用户的 PHP 库。 | 69 | v4.2.52026年3月26日 | 2026年3月26日 |
| TelegramBotsApi | Telegram Bot API 的 PHP SDK。 | 18 | v10.52026年11月22日 | 2026年11月22日 |
| TGram PHP | PHP 版 Telegram Bot API SDK。 | 1 | v0.2.12026年8月27日 | 2026年9月7日 |
Java
rubenlagus 的 TelegramBots 是最受欢迎的 Java 库,pengrad 的 java-telegram-bot-api 是主要替代方案。
热门之选
TelegramBots
简单易用的 Java Telegram 机器人开发库。
★ 5,553 · 最新版本 v10.3.0
Maven/Gradle: org.telegram:telegrambots-longpollingJava API
Java 版 Telegram Bot API 库。
★ 1,957 · 最新版本 10.4.0
Maven/Gradle: com.github.pengrad:java-telegram-bot-api所有在维护的 Java 库
| 库 | 简介 | ★ | 最新版本 | 最后更新 |
|---|---|---|---|---|
| TelegramBots | 简单易用的 Java Telegram 机器人开发库。 | 5,553 | v10.3.02026年9月7日 | 2026年11月10日 |
| Java API | Java 版 Telegram Bot API 库。 | 1,957 | 10.4.02026年11月21日 | 2026年9月26日 |
| Teleight Bots | 轻量级 Java 库,轻松创建 Telegram 机器人。 | 57 | v1.3.02026年5月8日 | 2026年8月3日 |
| Telebof | 简单而现代的 Java 版 Telegram Bot API 库。 | 55 | v2.3.02026年11月10日 | 2026年11月10日 |
Kotlin
Kotlin 开发者可以选择 kotlin-telegram-bot、类型安全的 ktgbotapi(TelegramBotAPI),或带 Kotlin DSL 的 vendelieu/telegram-bot。
所有在维护的 Kotlin 库
| 库 | 简介 | ★ | 最新版本 | 最后更新 |
|---|---|---|---|---|
| Kotlin Telegram Bot | 用 Kotlin 编写的 Telegram Bot API 封装。 | 983 | 10.0.02026年5月15日 | 2026年5月15日 |
| TelegramBotAPI | 类型安全的 Kotlin Telegram Bot API 库。 | 444 | v37.1.02026年10月10日 | 2026年11月19日 |
| Kotlin Telegram Bot | 带有便捷 Kotlin DSL 的 Telegram Bot API 封装。 | 249 | 9.8.02026年11月9日 | 2026年11月22日 |
| Kotlin Telegram Bot | 用于构建可伸缩、可扩展的 Telegram 机器人应用的 Kotlin 库。 | 47 | v1.4.22026年6月17日 | 2026年6月17日 |
| TelegramKitty | 类型安全的 Kotlin Telegram Bot API 封装,内置猫咪图片功能。 | 20 | 5.0.02026年7月15日 | 2026年7月15日 |
.NET
Telegram.Bot 是 Bot API 的标准 .NET 客户端;PRTelegramBot 和 Telegram Bot Framework 等多个框架都构建在它之上。
热门之选
所有在维护的 .NET 库
| 库 | 简介 | ★ | 最新版本 | 最后更新 |
|---|---|---|---|---|
| Telegram.bot | Telegram Bot API 的 .NET 客户端。 | 3,654 | v22.4.42025年2月24日 | 2026年11月9日 |
| Telegram Bot Framework | 模块化、基于上下文的 .NET 框架,提供表单、控件、状态管理、导航和本地化。 | 214 | v7.1.02026年1月8日 | 2026年11月3日 |
| Telegram.BotAPI for NET | Telegram Bot API 的 .NET 库,目标是成为功能最完整的库之一。 | 181 | v10.42026年11月10日 | 2026年11月10日 |
| RxTelegram.Bot | Telegram Bot API 的 C# 实现,以响应式方式提供更新。 | 44 | v8.2.02025年1月4日 | 2026年11月11日 |
| PRTelegramBot | 基于 Telegram.Bot 的 .NET 框架,支持基于特性的命令路由、菜单、中间件、依赖注入和后台任务。 | 39 | v1.1.32026年11月12日 | 2026年11月12日 |
| Minimal Telegram Bot | 语法简洁的 .NET Telegram 机器人框架,灵感来自 ASP.NET Core Minimal API。 | 38 | — | 2026年3月2日 |
| cnet | .NET 9 机器人工具包,提供类型化处理器、防刷屏与重试、会话与有限状态机、Long Polling 和 webhook。 | 10 | v1.7.02026年7月9日 | 2026年9月24日 |
Rust
teloxide 是目前最受欢迎的 Rust 框架;Frankenstein 是更轻量的 Bot API 客户端,telers 和 carapax 也是仍在维护的框架。
热门之选
所有在维护的 Rust 库
| 库 | 简介 | ★ | 最新版本 | 最后更新 |
|---|---|---|---|---|
| teloxide | 优雅的 Rust Telegram 机器人框架。 | 4,274 | v0.17.02025年7月11日 | 2026年9月15日 |
| Frankenstein | Rust 版 Telegram Bot API 客户端。 | 379 | 0.52.12026年9月25日 | 2026年11月14日 |
| carapax | Rust 版 Telegram Bot API 框架。 | 133 | 0.40.02026年9月6日 | 2026年9月6日 |
| telers | 用 Rust 编写的异步 Telegram Bot API 框架。 | 90 | — | 2026年11月16日 |
| botapi-rs | 自动生成的 Rust 版 Telegram Bot API 封装。 | 11 | 0.0.22022年10月17日 | 2026年11月10日 |
| rustigram | 功能全面的异步 Rust Telegram Bot API 框架。 | 8 | rustigram-v0.12.02026年8月16日 | 2026年8月16日 |
C++
tgbot-cpp 是使用最广泛的 Bot API C++ 库;tgbot 和 TGBM 是规模较小的替代方案。
所有在维护的 C++ 库
| 库 | 简介 | ★ | 最新版本 | 最后更新 |
|---|---|---|---|---|
| tgbot-cpp | C++ 版 Telegram Bot API 库。 | 1,189 | v1.142026年11月17日 | 2026年11月17日 |
| tgbot | 支持 Telegram Bot API 10.4 的 C++ 库,API 类型和方法均自动生成。 | 80 | 1.1.11.10.42026年11月9日 | 2026年11月9日 |
| TGBM | C++ Telegram 机器人库(“tg bots mother lib”)。 | 66 | v1.4.02026年11月3日 | 2026年11月3日 |
Ruby
telegram-bot-ruby 是最受欢迎的 Ruby 封装,telegram-bot gem 则提供可选的 Rails 集成。
热门之选
所有在维护的 Ruby 库
| 库 | 简介 | ★ | 最新版本 | 最后更新 |
|---|---|---|---|---|
| telegram-bot-ruby | Ruby 版 Telegram Bot API 封装。 | 1,426 | — | 2026年11月22日 |
| Telegram::Bot | 用于构建 Telegram 机器人的 Ruby gem,支持可选的 Rails 集成。 | 678 | v0.12.42018年1月19日 | 2026年4月5日 |
Dart
TeleDart 是星标最多的 Dart 库,而 Televerse 更新更为频繁。
所有在维护的 Dart 库
| 库 | 简介 | ★ | 最新版本 | 最后更新 |
|---|---|---|---|---|
| Televerse | 用于开发 Telegram 机器人的 Dart 框架。 | 102 | v3.8.02026年11月15日 | 2026年11月15日 |
Scala
bot4s.telegram 是 Scala 的强类型封装,Telegramium 则是纯函数式实现。
所有在维护的 Scala 库
| 库 | 简介 | ★ | 最新版本 | 最后更新 |
|---|---|---|---|---|
| bot4s.telegram | 简单、可扩展、强类型的 Scala 版 Telegram Bot API 封装。 | 432 | v7.1.02026年9月27日 | 2026年11月18日 |
| F[Tg] - Telegramium | 纯函数式的 Scala 版 Telegram Bot API 实现。 | 95 | 11.1004.02026年11月19日 | 2026年11月21日 |
Lua
telegram-bot-lua 是最受欢迎的 Lua 库;tnt-tg-bot 面向 Tarantool,ggram 可在 Garry's Mod 中使用。
所有在维护的 Lua 库
| 库 | 简介 | ★ | 最新版本 | 最后更新 |
|---|---|---|---|---|
| telegram-bot-lua | 简单而功能丰富的 Lua 版 Telegram Bot API 库。 | 210 | v3.72026年6月22日 | 2026年7月22日 |
| tnt-tg-bot | Lua/Tarantool 版 Telegram Bot API 库。 | 9 | — | 2026年9月29日 |
Clojure
Clojure 有两个仍在维护的选择:clj-tg-bot-api 和 telegrambot-lib。
所有在维护的 Clojure 库
| 库 | 简介 | ★ | 最新版本 | 最后更新 |
|---|---|---|---|---|
| telegrambot-lib | Telegram Bot API 的 Clojure 库实现。 | 75 | 2.15.02024年6月2日 | 2026年2月22日 |
| Clojure Telegram Bot API | Telegram Bot API 规范及面向 Clojure 应用的客户端库。 | 72 | — | 2026年11月10日 |
其他语言
官方列表还收录了 Swift、Elixir、Gleam、Pascal、OCaml、Haskell、Perl 和 Crystal 的库。
所有在维护的 其他语言 库
| 库 | 简介 | ★ | 最新版本 | 最后更新 |
|---|---|---|---|---|
| Swift | 实现全部 Telegram Bot API 方法的 Swift 库,可与 Vapor、Smoke、Hummingbird 和 FlyingFox 配合使用。 | 269 | 10.4.12026年11月19日 | 2026年11月19日 |
| Elixir | ExGram:Elixir 的底层 Telegram Bot API 客户端与框架。 | 242 | 0.67.02026年6月12日 | 2026年11月20日 |
| Gleam | Telega:用于构建 Telegram 机器人的 Gleam 库。 | 74 | — | 2026年11月11日 |
| Pascal | TGBotMini:Pascal 的迷你 Telegram Bot API 库。 | 38 | — | 2026年2月4日 |
| Crystal | hamilton:Crystal 版 Telegram Bot API 封装。 | 6 | v0.5.02026年4月30日 | 2026年10月21日 |
常见问题
开发 Telegram 机器人最好用的 Python 库是哪个?
没有唯一的最佳选择。python-telegram-bot 是 GitHub 上星标最多的 Python 库,文档详尽;aiogram 是基于 asyncio 的全异步框架;pyTelegramBotAPI 简单、可扩展,容易上手。三者都在积极维护,选择风格和文档最适合你的即可。
开发 Telegram 机器人应该用哪个 Node.js 库?
最受欢迎的选择是 grammY、Telegraf 和 node-telegram-bot-api。grammY 和 Telegraf 是带中间件的框架,适合组织大型机器人的代码;node-telegram-bot-api 是一个与 Bot API 方法紧密对应的模块。如果你使用 TypeScript,也可以看看 GramIO 和 puregram 等类型化库。
开发 Telegram 机器人必须使用库吗?
不必。Bot API 是一个 HTTPS 接口:每个方法都是对 https://api.telegram.org/bot<token>/<method> 的请求并返回 JSON,因此可以在任何语言中用标准 HTTP 客户端调用。使用库可以在类型定义、文件上传、更新处理和键盘方面节省时间。
这些库是官方的吗?
不是。它们都是社区项目。Telegram 在 core.telegram.org 的官方库列表中收录了它们,但并不负责开发或提供支持。本页列出了该列表中的全部 95 个库,以及截至 2026年11月22日 的 GitHub 活跃度。
如何判断一个库是否支持最新的 Bot API 版本?
将库最新版本的发布日期和说明与官方更新日志中的最新 Bot API 版本进行对比。许多库会在 README、发布说明或更新日志中注明所支持的 Bot API 版本;最近有更新是个好迹象,但并不能保证。