chatgpt_telegram_bot

在 Telegram 里直接聊 ChatGPT/Claude，即聊即得

这是一个基于 Python 的 Telegram 机器人，集成了 ChatGPT 和 Claude 模型，通过 OpenAI API 提供对话能力。它解决了在 Telegram 上直接使用大语言模型的需求，无需切换应用。核心能力包括：支持多模型切换、流式回复、对话历史管理、权限控制、以及通过 Telegram 的交互界面进行自然语言问答。项目配置灵活，支持自定义提示词和系统角色，适合个人或团队快速部署一个私有 AI 助手。

开源 unknown 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 5530

维护状态低维护

是否开源是

定价模式 unknown

项目数据

分类对话助手

开发团队father-bot

所属国家

官网地址

GitHubhttps://github.com/father-bot/chatgpt_telegram_bot

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型chat-gpt,chatbot,openai,python,telegram

GitHub 星标★ 5530

30天Star增速

HF 下载量

上线时间2022-12-05 00:00:00

最近更新2026-09-22 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 15 分钟部署方式：本地安装 7 步

环境要求

Python 运行环境（项目为 Python 项目）
OpenAI API Key（用于对话与图像生成）
Telegram 账号，并通过 @BotFather 获取 Bot Token
可选：OpenRouter API Key（使用 Claude、GPT-5.5 时需要）

安装与启动步骤

1获取 OpenAI Key

到 OpenAI 平台申请 API Key，用于对话和 gpt-image-1 图像生成，注意妥善保存不要外泄。
2获取 OpenRouter Key

可选步骤。想使用 Claude（Opus/Sonnet/Haiku）或 GPT-5.5 时，去 OpenRouter 申请 API Key。
3获取 Bot Token

在 Telegram 中打开 @BotFather，按提示创建机器人，拿到形如 123456:AA... 的 token。
4下载项目代码

从 GitHub 拉取项目到本地，然后进入项目目录再执行后续命令。
```
git clone https://github.com/father-bot/chatgpt_telegram_bot.git
```
5复制配置文件

把示例配置复制成正式配置，config.yml 放主要配置，config.env 放环境变量类配置。
```
mv config/config.example.yml config/config.yml
mv config/config.example.env config/config.env
```
6填写密钥信息

编辑 config/config.yml，填入 telegram_token、openai_api_key；用 Claude/GPT-5.5 时再填 openrouter_api_key。
7启动机器人

按仓库完整 README 的方式运行项目；本次节选未给出启动命令，请以官方 README 为准。

关键配置

配置项	必填	说明	示例
`telegram_token`	是	@BotFather 生成的 Telegram 机器人 Token	`123456789:AAxxxxxxxxxxxxxxxxxxxxxxxx`
`openai_api_key`	是	你的 OpenAI API 密钥，用于对话与图像生成	`sk-xxxxxxxxxxxxxxxx`
`openrouter_api_key`	否	仅当使用 provider 为 openrouter 的模型（Claude、GPT-5.5）时需要	`sk-or-xxxxxxxxxxxxxxxx`
`openai_api_base`	否	自定义接口地址，如 LocalAI；使用默认服务时留 null	`null`
`allowed_telegram_usernames`	否	允许使用的用户白名单，留空表示所有人可用	`[]`
`enable_message_streaming`	否	是否开启逐字流式回复	`true`

如何确认成功

在 Telegram 里给机器人发一条消息，通常 3–5 秒内收到回复，说明部署成功。

常见问题

Q：必须要有 OpenRouter API Key 吗？

A：不是。只有使用 provider: openrouter 的模型（Claude、GPT-5.5）时才需要，只用默认 OpenAI 模型可以不填。

Q：怎么限制只有自己或团队能用？

A：在 allowed_telegram_usernames 中填写用户名或 ID 白名单；留空表示对所有人开放。

Q：回复不是逐字流式出现怎么办？

A：检查 config.yml 中 enable_message_streaming 是否设为 true，改完保存后重启机器人。

Q：能用本地或自建模型吗？

A：可以。把 openai_api_base 指向兼容 OpenAI 的接口地址（例如 LocalAI）；用官方服务时保持 null。

Q：为什么没有每日次数限制？

A：项目不设中转限流，调用费用由你直接向 API 提供方结算，因此请求数量取决于你的额度。

注意事项

必须先把 config.example.yml 和 config.example.env 重命名/复制为 config.yml 和 config.env 再填写，否则配置不生效。
请勿把含 API Key 的 config.yml 提交到公开仓库。
本次 README 节选未包含安装依赖与启动命令，实际启动方式请参考仓库完整 README。
各模型的定价与能力见 config/models.yml。

核心亮点

支持 ChatGPT 和 Claude 双模型，用户可自由切换
流式回复响应快，体验接近原生聊天
权限控制完善，可限制特定用户或群组使用

不足之处

依赖 OpenAI API，需要自备 API Key 且产生费用
文档/社区待观察

适用场景

个人在 Telegram 中快速获取 AI 问答
团队在群组中共享 AI 助手，提升协作效率
开发者集成测试 OpenAI API 的交互原型

替代项目

telegpt、telegram-chatgpt-bot、gpt-telegram-bot

项目介绍

chatgpt_telegram_bot 是对话助手领域的开源项目，由 father-bot 开发，2022 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（5,530）位列前 8%，在对话助手分类的 907 个项目里位列前 6%。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-22。从国内网络环境看，可用性暂无实测数据。

它主要面向的使用场景是：个人在Telegram中快速获取AI问答。同类可对比的替代方案包括 telegpt、telegram-chatgpt-bot、gpt-telegram-bot。

上一篇：Red-DiscordBot

下一篇：Bard-API