chatgpt_telegram_bot

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

开源 🏷️定价信息待确认 ⏳ 访问状态待核验对话助手 🍴 复刻 1903 🐛 待处理 57 👀 关注 68

GitHub ↗

GitHub 星标 ★ 5555

维护状态低维护

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

chatgpt_telegram_bot 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类对话助手

开发团队father-bot

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

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态⏳ 访问状态待核验

是否开源是

开源协议MIT

主要语言Python

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

GitHub 星标★ 5555

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

代码更新2026-06-14

仓库体积1.1 MB

本站数据更新2026-11-10

维护状态低维护

收录时间2026-08-09

浏览次数5

项目介绍

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

Star 增长趋势

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

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

技术标签

chat-gpt chatbot openai python telegram

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 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。