Telegram Bot API

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-bot

AIOGram

现代化的全异步 Python Telegram Bot API 框架,基于 asyncio 和 aiohttp 构建。

★ 5,948 · 最新版本 3.33.0

pip install aiogram

pyTelegramBotAPI

简单但可扩展的 Python 版 Telegram Bot API 实现。

★ 8,795 · 最新版本 4.37.1

pip install pyTelegramBotAPI

所有在维护的 Python 库

库简介★最新版本最后更新
python-telegram-bot流行的 Python 版 Telegram Bot API 封装(“一个你无法拒绝的封装”)。29,614v22.8
2026年6月12日
2026年11月22日
pyTelegramBotAPI简单但可扩展的 Python 版 Telegram Bot API 实现。8,7954.37.0
2026年9月21日
2026年10月31日
AIOGram现代化的全异步 Python Telegram Bot API 框架,基于 asyncio 和 aiohttp 构建。5,948v3.33.0
2026年11月19日
2026年11月22日
OrigamiBotPython 风格的 Telegram Bot API 库。86v2.3.6
2023年6月25日
2026年10月23日
Telegrinder现代化的 Python Telegram 机器人框架。70v1.1.3
2026年5月19日
2026年11月19日
Shingram轻量级 Python Telegram 机器人库,自动支持 API 方法。8—2026年1月30日
Telekit声明式、对开发者友好的 Python Telegram 机器人库。5v2.6.1
2026年11月20日
2026年11月20日
telegram-easy极其简单的 Python 包,用于收发 Telegram 消息。00.2.0
2026年1月30日
2026年1月30日

超过一年未更新: telegram-text (2024年9月16日), MicroPython (2024年10月19日), telegram.py (2025年2月28日), pure-teleapi (2025年3月12日)

JavaScript

在 Node.js 方面,node-telegram-bot-api 和 Telegraf 是星标最多的库,grammY 则自称“The Telegram Bot Framework”。GramIO、puregram 和 typescript-telegram-bot-api 等多个库专为 TypeScript 编写或主打类型安全。

热门之选

grammY

适用于 JavaScript 和 TypeScript 的 Telegram 机器人框架。

★ 3,808 · 最新版本 1.46.0

npm install grammy

Telegraf

现代化的 Node.js Telegram 机器人框架。

★ 9,212 · 最新版本 4.16.3

npm install telegraf

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,217v2.4.0
2026年11月9日
2026年11月21日
Telegraf现代化的 Node.js Telegram 机器人框架。9,212v4.16.3
2024年2月29日
2026年11月16日
grammY适用于 JavaScript 和 TypeScript 的 Telegram 机器人框架。3,808v1.46.0
2026年8月26日
2026年11月21日
GramIO强大、可扩展且类型安全的 Telegram Bot API 框架。305v0.15.3
2026年10月21日
2026年10月21日
puregram适用于 Node.js 和 TypeScript 的现代 Telegram Bot API SDK。210@puregram/media-cacher@4.0.0
2026年11月22日
2026年11月9日
typescript-telegram-bot-api用 TypeScript 编写的 Node.js 版 Telegram Bot API 封装。52—2026年8月24日
Telegramsjs用于与 Telegram Bot API 交互的库。524.15.0
2026年10月3日
2026年10月3日
tg-bot-sdk完整支持 Telegram Bot API 类型的全面库。31@effect-ak/tg-bot@1.13.0
2026年11月13日
2026年11月13日
wrappergram简单、小巧、代码生成的 TypeScript/JavaScript 版 Telegram Bot API 封装,支持文件上传。9v2.0.0
2026年8月24日
2026年10月27日
ayotbl更易用、完全类型化的 Node.js 版 Telegram Bot API 库。4—2026年9月8日

Go

最受欢迎的 Go 库是 telebot,其次是 go-telegram/bot、Telego 以及自动生成的 gotgbot。

热门之选

telebot

Go 语言的 Telegram 机器人框架。

★ 4,643 · 最新版本 v4.0.0

go get gopkg.in/telebot.v4

Golang Telegram Bot

Go 版 Telegram Bot API 框架。

★ 1,893 · 最新版本 v1.30.0

go get github.com/go-telegram/bot

Telego

Go 版 Telegram Bot API 库。

★ 1,082 · 最新版本 v1.13.0

go get github.com/mymmrac/telego

所有在维护的 Go 库

库简介★最新版本最后更新
telebotGo 语言的 Telegram 机器人框架。4,643v4.0.0
2026年11月18日
2026年11月18日
Golang Telegram BotGo 版 Telegram Bot API 框架。1,893v1.30.0
2026年11月19日
2026年11月19日
TelegoGo 版 Telegram Bot API 库。1,082v1.13.0
2026年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-tgTelegram Bot API 的 Go 客户端库,内置构建复杂机器人所需的各种工具。136v0.18.0
2026年2月9日
2026年11月10日
Telegram Bot API helper for GolangGo 版 Telegram Bot API 封装。52—2026年9月12日
Golang Telegram Bot FrameworkGo 语言的 Telegram 机器人框架。18v2.5.0
2026年11月22日
2026年11月22日
Telegram Bot API: Go implementationTelegram Bot API 的 Go 语言实现。16—2026年4月15日
goram零依赖的 Go 版 Telegram Bot API 库。4—2026年6月18日
gogrammyGo 语言的 Telegram 机器人框架,基于 go-telegram/bot 封装。3—2026年10月25日

超过一年未更新: TG

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-bot

Bot API PHP SDK

PHP 版 Telegram Bot API SDK,开箱即用支持 Laravel。

★ 3,301 · 最新版本 v3.16.0

composer require irazasyed/telegram-bot-sdk

Nutgram

一个 PHP Telegram 机器人框架,“不会让你抓狂”。

★ 759 · 最新版本 4.52.0

composer require nutgram/nutgram

所有在维护的 PHP 库

库简介★最新版本最后更新
PHP Telegram Bot基于官方 Telegram Bot API 的 PHP Telegram 机器人库。4,0170.84.0
2026年11月11日
2026年11月18日
Bot API PHP SDKPHP 版 Telegram Bot API SDK,开箱即用支持 Laravel。3,301v3.16.0
2026年3月23日
2026年11月9日
Telegraph一个 Laravel 扩展包,以流畅的方式与 Telegram 机器人交互。822v1.73.0
2026年9月30日
2026年10月15日
Nutgram一个 PHP Telegram 机器人框架,“不会让你抓狂”。7594.52.0
2026年11月20日
2026年11月22日
TeleBot用 PHP 轻松创建 Telegram 机器人,开箱即用支持 Laravel。3104.11.0
2026年11月10日
2026年11月10日
Telegram Bot API for PHP用于与 Telegram Bot API 交互的 PHP 库。1310.24
2026年11月22日
2026年11月22日
LaraGram用于构建 Telegram 机器人和应用的现代 PHP 框架。131v4.4.1
2026年11月10日
2026年11月10日
tgWebValid在网站上验证 Telegram Login Widget 和 Mini App 用户的 PHP 库。69v4.2.5
2026年3月26日
2026年3月26日
TelegramBotsApiTelegram Bot API 的 PHP SDK。18v10.5
2026年11月22日
2026年11月22日
TGram PHPPHP 版 Telegram Bot API SDK。1v0.2.1
2026年8月27日
2026年9月7日

超过一年未更新: PHP Telegram Bot Api (2025年7月10日), TuriBot (2025年6月18日), klev-o/telegram-bot-api (2025年1月20日), laragram (2025年9月29日)

Java

rubenlagus 的 TelegramBots 是最受欢迎的 Java 库,pengrad 的 java-telegram-bot-api 是主要替代方案。

热门之选

TelegramBots

简单易用的 Java Telegram 机器人开发库。

★ 5,553 · 最新版本 v10.3.0

Maven/Gradle: org.telegram:telegrambots-longpolling

Java API

Java 版 Telegram Bot API 库。

★ 1,957 · 最新版本 10.4.0

Maven/Gradle: com.github.pengrad:java-telegram-bot-api

所有在维护的 Java 库

库简介★最新版本最后更新
TelegramBots简单易用的 Java Telegram 机器人开发库。5,553v10.3.0
2026年9月7日
2026年11月10日
Java APIJava 版 Telegram Bot API 库。1,95710.4.0
2026年11月21日
2026年9月26日
Teleight Bots轻量级 Java 库,轻松创建 Telegram 机器人。57v1.3.0
2026年5月8日
2026年8月3日
Telebof简单而现代的 Java 版 Telegram Bot API 库。55v2.3.0
2026年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 封装。98310.0.0
2026年5月15日
2026年5月15日
TelegramBotAPI类型安全的 Kotlin Telegram Bot API 库。444v37.1.0
2026年10月10日
2026年11月19日
Kotlin Telegram Bot带有便捷 Kotlin DSL 的 Telegram Bot API 封装。2499.8.0
2026年11月9日
2026年11月22日
Kotlin Telegram Bot用于构建可伸缩、可扩展的 Telegram 机器人应用的 Kotlin 库。47v1.4.2
2026年6月17日
2026年6月17日
TelegramKitty类型安全的 Kotlin Telegram Bot API 封装,内置猫咪图片功能。205.0.0
2026年7月15日
2026年7月15日

.NET

Telegram.Bot 是 Bot API 的标准 .NET 客户端;PRTelegramBot 和 Telegram Bot Framework 等多个框架都构建在它之上。

热门之选

Telegram.bot

Telegram Bot API 的 .NET 客户端。

★ 3,654 · 最新版本 22.10.4

dotnet add package Telegram.Bot

所有在维护的 .NET 库

库简介★最新版本最后更新
Telegram.botTelegram Bot API 的 .NET 客户端。3,654v22.4.4
2025年2月24日
2026年11月9日
Telegram Bot Framework模块化、基于上下文的 .NET 框架,提供表单、控件、状态管理、导航和本地化。214v7.1.0
2026年1月8日
2026年11月3日
Telegram.BotAPI for NETTelegram Bot API 的 .NET 库,目标是成为功能最完整的库之一。181v10.4
2026年11月10日
2026年11月10日
RxTelegram.BotTelegram Bot API 的 C# 实现,以响应式方式提供更新。44v8.2.0
2025年1月4日
2026年11月11日
PRTelegramBot基于 Telegram.Bot 的 .NET 框架,支持基于特性的命令路由、菜单、中间件、依赖注入和后台任务。39v1.1.3
2026年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。10v1.7.0
2026年7月9日
2026年9月24日

Rust

teloxide 是目前最受欢迎的 Rust 框架;Frankenstein 是更轻量的 Bot API 客户端,telers 和 carapax 也是仍在维护的框架。

热门之选

teloxide

优雅的 Rust Telegram 机器人框架。

★ 4,274 · 最新版本 0.17.0

cargo add teloxide

Frankenstein

Rust 版 Telegram Bot API 客户端。

★ 379 · 最新版本 0.53.0

cargo add frankenstein

所有在维护的 Rust 库

库简介★最新版本最后更新
teloxide优雅的 Rust Telegram 机器人框架。4,274v0.17.0
2025年7月11日
2026年9月15日
FrankensteinRust 版 Telegram Bot API 客户端。3790.52.1
2026年9月25日
2026年11月14日
carapaxRust 版 Telegram Bot API 框架。1330.40.0
2026年9月6日
2026年9月6日
telers用 Rust 编写的异步 Telegram Bot API 框架。90—2026年11月16日
botapi-rs自动生成的 Rust 版 Telegram Bot API 封装。110.0.2
2022年10月17日
2026年11月10日
rustigram功能全面的异步 Rust Telegram Bot API 框架。8rustigram-v0.12.0
2026年8月16日
2026年8月16日

超过一年未更新: Ferrisgram (2025年3月19日), tgbotapi (2025年8月7日)

C++

tgbot-cpp 是使用最广泛的 Bot API C++ 库;tgbot 和 TGBM 是规模较小的替代方案。

所有在维护的 C++ 库

库简介★最新版本最后更新
tgbot-cppC++ 版 Telegram Bot API 库。1,189v1.14
2026年11月17日
2026年11月17日
tgbot支持 Telegram Bot API 10.4 的 C++ 库,API 类型和方法均自动生成。801.1.11.10.4
2026年11月9日
2026年11月9日
TGBMC++ Telegram 机器人库(“tg bots mother lib”)。66v1.4.0
2026年11月3日
2026年11月3日

Ruby

telegram-bot-ruby 是最受欢迎的 Ruby 封装,telegram-bot gem 则提供可选的 Rails 集成。

热门之选

telegram-bot-ruby

Ruby 版 Telegram Bot API 封装。

★ 1,426 · 最新版本 2.10.0

gem install telegram-bot-ruby

所有在维护的 Ruby 库

库简介★最新版本最后更新
telegram-bot-rubyRuby 版 Telegram Bot API 封装。1,426—2026年11月22日
Telegram::Bot用于构建 Telegram 机器人的 Ruby gem,支持可选的 Rails 集成。678v0.12.4
2018年1月19日
2026年4月5日

超过一年未更新: TelegramWorkflow (2023年7月21日)

Dart

TeleDart 是星标最多的 Dart 库,而 Televerse 更新更为频繁。

所有在维护的 Dart 库

库简介★最新版本最后更新
Televerse用于开发 Telegram 机器人的 Dart 框架。102v3.8.0
2026年11月15日
2026年11月15日

超过一年未更新: TeleDart (2024年4月6日)

Scala

bot4s.telegram 是 Scala 的强类型封装,Telegramium 则是纯函数式实现。

所有在维护的 Scala 库

库简介★最新版本最后更新
bot4s.telegram简单、可扩展、强类型的 Scala 版 Telegram Bot API 封装。432v7.1.0
2026年9月27日
2026年11月18日
F[Tg] - Telegramium纯函数式的 Scala 版 Telegram Bot API 实现。9511.1004.0
2026年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 库。210v3.7
2026年6月22日
2026年7月22日
tnt-tg-botLua/Tarantool 版 Telegram Bot API 库。9—2026年9月29日

超过一年未更新: ggram (2025年3月25日)

Clojure

Clojure 有两个仍在维护的选择:clj-tg-bot-api 和 telegrambot-lib。

所有在维护的 Clojure 库

库简介★最新版本最后更新
telegrambot-libTelegram Bot API 的 Clojure 库实现。752.15.0
2024年6月2日
2026年2月22日
Clojure Telegram Bot APITelegram Bot API 规范及面向 Clojure 应用的客户端库。72—2026年11月10日

其他语言

官方列表还收录了 Swift、Elixir、Gleam、Pascal、OCaml、Haskell、Perl 和 Crystal 的库。

所有在维护的 其他语言 库

库简介★最新版本最后更新
Swift实现全部 Telegram Bot API 方法的 Swift 库,可与 Vapor、Smoke、Hummingbird 和 FlyingFox 配合使用。26910.4.1
2026年11月19日
2026年11月19日
ElixirExGram:Elixir 的底层 Telegram Bot API 客户端与框架。2420.67.0
2026年6月12日
2026年11月20日
GleamTelega:用于构建 Telegram 机器人的 Gleam 库。74—2026年11月11日
PascalTGBotMini:Pascal 的迷你 Telegram Bot API 库。38—2026年2月4日
Crystalhamilton:Crystal 版 Telegram Bot API 封装。6v0.5.0
2026年4月30日
2026年10月21日

超过一年未更新: Haskell (2023年3月7日), OCaml (2022年5月31日), Perl (2025年4月17日)

来源:core.telegram.org 上的官方库列表;星标数、版本和更新日期来自 GitHub,截至 2026年11月22日。 core.telegram.org/bots/samples

常见问题

开发 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 版本;最近有更新是个好迹象,但并不能保证。