Guides · 5 分钟阅读

ChatGPT Telegram 机器人设置:从 BotFather 到首次回复的完整指南

想搭建 ChatGPT Telegram 机器人?本指南详细介绍如何通过 BotFather 创建机器人、配置 OpenAI API、选择托管方案及避开常见限流陷阱,助你快速完成从开发到上线的全过程。

Mathias Gilson

作者

Mathias Gilson

CEO, Qualtir

ChatGPT Telegram 机器人设置:从 BotFather 到首次回复的完整指南
本页内容

通过 ChatGPT Telegram 机器人设置,你可以将 Telegram Bot API 与 OpenAI 的聊天模型连接起来,让用户直接在 Telegram 中与 AI 对话。由于 OpenAI 官方并未推出 Telegram 版本的 ChatGPT 机器人,你需要通过 @BotFather 创建自己的机器人,并配置 OpenAI API 密钥,最后运行一个简单的“桥接程序”来转发消息。

本指南将涵盖所有关键步骤:凭据获取、部署方案、测试、成本分析及故障排除。如果你只需要在群组中添加机器人且不想编写代码,请先查看我们关于将 ChatGPT 添加到 Telegram 群组的五种方法的对比分析。

核心要点:

  • BotFather 令牌 + OpenAI API 密钥是每个设置流程必备的两个凭据。
  • Telegram Bot API 是免费的。你主要的持续成本在于服务器托管费用和 OpenAI 的 Token 使用量。
  • 三种实现路径: 自托管代码、无代码自动化(Zapier/Make)或直接添加现成的 AI 机器人。
  • 注意限流: 在群组中,根据 python-telegram-bot 的流量限制指南,建议每个群组每分钟不超过 20 条消息。
  • 隐私审查: 在上线前,请阅读关于 AI Telegram 机器人存储数据的内容,特别是当机器人涉及客户或团队消息时。

开始前的准备工作

无论你是编写 Python 代码还是使用无代码工作流,ChatGPT Telegram 机器人的基础需求都是一样的。

需求获取渠道备注
Telegram 账号telegram.org用于与 BotFather 对话
Bot 令牌@BotFather 通过 /newbot务必保密。拥有令牌即可控制机器人
OpenAI API 密钥platform.openai.com生产环境需绑定支付方式
托管或自动化VPS, Railway, Replit, Zapier, Make除非使用托管类 AI 机器人产品,否则必须
HTTPS 端点 (仅 Webhook)你的服务器或平台可选。长轮询 (Long Polling) 无需公网 URL

根据 Telegram 的机器人教程,BotFather 是注册机器人并获取令牌的唯一官方途径。OpenAI 通过 Chat Completions API 提供 ChatGPT 式的回复,而非通过特定的 Telegram 产品。

Telegram BotFather conversation creating a new bot with API token

第一步:使用 BotFather 创建 Telegram 机器人

BotFather 是 Telegram 官方的机器人管理界面,整个过程只需两分钟。

  1. 打开 Telegram 并搜索 @BotFather。
  2. 发送 /start,然后发送 /newbot。
  3. 输入一个显示名称(用户看到的名称,例如“Acme 支持助手”)。
  4. 输入一个以 bot 结尾的用户名(例如 acme_support_bot),该名称必须全局唯一。
  5. 复制 BotFather 返回的 HTTP API 令牌。请将其保存在密码管理器中,不要上传到公开的代码仓库。

上线前,你可以通过 BotFather 设置以下有用功能:

  • /setdescription:用户打开与机器人的对话时显示的说明。
  • /setabouttext:简短的个人简介。
  • /setcommands:设置菜单项,如 start - 开始 和 reset - 清除历史记录。
  • /setuserpic:设置头像或 Logo。
BotFather 对话示例
你: /newbot
BotFather: 好的,创建一个新机器人。我们要给它起什么名字?
你: Acme 支持助手
BotFather: 不错。现在为你的机器人选择一个用户名。
你: acme_support_bot
BotFather: 完成!使用此令牌访问 HTTP API: 7123456789:AAH...

第二步:获取 OpenAI API 密钥

接下来,为你的机器人开启 API 访问权限。

  1. 登录 platform.openai.com。
  2. 打开 API keys 页面并创建一个新的密钥。
  3. 复制并保存好,OpenAI 不会再次显示完整密钥。
  4. 如果计划处理大量流量,请在 Billing 中添加支付方式。

在 OpenAI 控制面板中设置使用限额,防止因意外循环调用或垃圾消息导致账户余额耗尽。对于大多数小型机器人,gpt-4o-mini 是平衡成本与性能的最佳选择。在选择模型前,请查看 OpenAI 定价页面了解当前的 Token 费率。

Telegram chat with AI bot replying to a user message

第三步:选择你的 ChatGPT Telegram 机器人部署路径

没有唯一的“官方”技术栈,请根据你的技术水平和需求选择适合的路径。

路径 A:自托管代码(适合开发者)

当你需要自定义逻辑、访问内部 API 或完全控制数据流时,这是最佳选择。

常见技术栈:

  • 语言: Python (python-telegram-bot, aiogram) 或 Node.js (telegraf, grammY)
  • 流程: 接收 Telegram 更新 → 调用 OpenAI Chat Completions → 使用 sendMessage 发送回复
  • 部署: Docker 运行在 VPS、Railway、Render 或 Fly.io 上
  • 更新方式: 本地开发使用长轮询,生产环境使用 Webhook

Python 极简示例代码:

from openai import OpenAI
from telegram import Update
from telegram.ext import Application, MessageHandler, filters

client = OpenAI()
TOKEN = "YOUR_TELEGRAM_BOT_TOKEN"

async def handle_message(update: Update, context):
 user_text = update.message.text
 response = client.chat.completions.create(
 model="gpt-4o-mini",
 messages=[{"role": "user", "content": user_text}],
 )
 await update.message.reply_text(response.choices[0].message.content)

app = Application.builder().token(TOKEN).build()
app.add_handler(MessageHandler(filters. TEXT & ~filters. COMMAND, handle_message))
app.run_polling()

开源项目如 ChatGPT-Telegram-Bot 提供了管理员白名单、模型切换和一键云部署模板。搭建一个基础的私人机器人大约需要一个下午,而生产环境的加固(错误处理、限流、日志记录)则需要 1 到 3 周。我们的 TeleClaw 与自定义机器人成本对比分析中详细介绍了这一时间线。

路径 B:无代码自动化(Zapier 或 Make)

当你需要一个个人机器人或低频使用的机器人,且不想维护服务器时,这是最佳选择。

工作流结构:

  1. 触发器: Telegram Bot,监听新消息
  2. 动作: OpenAI,使用用户文本创建聊天补全
  3. 动作: Telegram Bot,将模型输出发送回原聊天 ID

Make 的 ChatGPT Telegram 指南遵循此三步模式。Zapier 也提供类似的 Telegram + OpenAI 集成。权衡点:设置简单,但对对话记忆的控制较少,且免费层级有任务次数限制。

路径 C:添加现成的 AI 机器人(群组最快方案)

如果你只是想立即在 Telegram 群组中获得 AI 协助,而不想拥有机器人基础设施,这是最佳选择。

在 Telegram 中搜索成熟的 AI 机器人,或使用专门为群组打造的产品。我们的2026 年最佳 Telegram AI 机器人盘点对比了设置时间、群组表现和定价,其中包括无需 API 密钥即可实现基于提及回复的 TeleClaw。

第四步:部署并连接更新

对于自托管机器人,你需要保持进程 24/7 运行,并选择 Telegram 传递消息的方式。

长轮询 (getUpdates): 你的脚本循环询问 Telegram 是否有新消息。适合开发阶段,无需公网 URL。

Webhook: 当有人给机器人发消息时,Telegram 会向你的 HTTPS URL 发送 POST 请求。延迟更低,更适合生产环境。根据 Bot API 规范,需要 TLS 支持 443、80、88 或 8443 端口。

注册 Webhook(替换占位符):

curl "https://api.telegram.org/bot<TOKEN>/setWebhook?url=https://your-domain.com/webhook"

在服务器上设置环境变量:

  • TELEGRAM_BOT_TOKEN:来自 BotFather
  • OPENAI_API_KEY:来自 OpenAI
  • 可选:ALLOWED_USER_IDS:逗号分隔的 Telegram 用户 ID,用于忽略陌生人

重启策略:在 Docker 中使用 restart: always 或使用你所在平台的等效设置,确保程序崩溃后机器人不会长时间离线。

第五步:测试、限制访问并上线

在分享机器人链接之前,请执行以下检查清单:

  1. 私聊测试: 私下给机器人发消息,确认几秒内能收到连贯的回复。
  2. 群组测试(如适用): 将机器人加入测试群组,验证它是否仅在预期情况下(如命令、提及或回复)做出响应。
  3. 错误路径: 发送空消息或不支持的文件类型。机器人应优雅地处理错误,而不是导致进程崩溃。
  4. 白名单: 在测试阶段将使用权限限制给已知的 Telegram 用户 ID。许多开源模板内置此功能。
  5. 系统提示词 (System Prompt): 在 OpenAI 调用中设置 system 消息,让机器人明确其语气、范围和禁忌规则。
  6. 隐私: 记录你的日志内容及保留时长。查看Telegram 机器人隐私实践,了解你需要向服务商确认的问题。
示例:首次成功对话
你: /start
机器人: 你好,我已连接到 ChatGPT。你可以问我关于 Acme 文档的任何问题,或输入 /reset 清除会话。
你: 你们的退款政策是什么?
机器人: 如果你购买后 14 天内且 API 调用次数未超过 100 次,可以申请退款。如果需要人工客服,请在此回复。

成本、限制与常见错误

Telegram: Bot API 没有单条消息费用。你可以免费创建多个机器人。

OpenAI: 按 Token(输入 + 输出)付费。一个低频的个人机器人每月可能只需几美元。一个活跃在大型群组的支持机器人,根据消息量和模型选择,费用可能达到几十甚至几百美元。

托管: 预算每月约 5-15 美元用于小型 VPS,或者在 Railway/Replit 上使用免费层级进行实验(注意休眠和配额限制)。

限流: Telegram 会限制发送频率过高的机器人。社区公认的安全阈值约为每秒 30 条消息(跨所有聊天),单群组每分钟约 20 条消息。触及限制会返回 HTTP 429 错误。请在繁忙群组中实现退避机制并排队处理出站消息。

常见错误:

  • 机器人令牌泄露: 如果令牌出现在 GitHub 或截图中,请立即通过 BotFather 的 /revoke 命令进行撤销。
  • 未设置 OpenAI 消费上限: 未加白名单的公共机器人可能在几小时内被滥用。
  • 无限的对话历史: 每次请求都发送完整的聊天记录会迅速增加成本。请截断或总结旧的对话轮次。
  • 忽视群组礼仪: 回复每一条消息的机器人会惹恼成员。请使用提及、命令或回复过滤器。

常见问题解答

OpenAI 是否提供官方的 ChatGPT Telegram 机器人?

没有。OpenAI 没有发布原生的 Telegram ChatGPT 机器人。你需要通过 BotFather、OpenAI API 以及托管或自动化工具自行连接,或者使用已经完成这些工作的第三方机器人。

我可以免费设置 ChatGPT Telegram 机器人吗?

Telegram 端是免费的。但 OpenAI API 使用超出免费试用额度后需要付费,且大多数生产环境需要付费托管。你可以通过低频测试在小模型上低成本尝试,但如果机器人长期在线,请务必规划好 API 和服务器成本。

设置 ChatGPT Telegram 机器人需要懂代码吗?

不一定。像 Zapier 或 Make 这样的无代码工具可以在不编写 Python 或 Node.js 的情况下连接 Telegram 和 OpenAI。如果需要自定义行为、内部数据库查找或严格的数据驻留,通常需要代码或专门的托管平台。

我应该使用 Webhook 还是长轮询?

本地开发时使用长轮询。生产环境切换到 Webhook,这样 Telegram 会将更新推送到你的 HTTPS 端点,而不是让机器人不断询问是否有新消息。同一个机器人不能同时使用这两种方式。

如何将 ChatGPT 添加到现有的 Telegram 群组?

在群组信息页面将机器人添加为成员,然后配置它是监听所有消息还是仅监听命令和提及。群组机器人比私聊机器人面临更严格的发送限制。如需包括无代码选项在内的方法对比,请阅读我们关于将 ChatGPT 添加到 Telegram 群组的指南。

总结

完整的 ChatGPT Telegram 机器人设置归结为三个核心部分:BotFather 令牌、OpenAI API 密钥,以及两者之间始终在线的桥接程序。开发者通过自托管脚本和 Webhook 可以获得最大的灵活性;非开发者可以使用 Zapier 或 Make 进行轻量级的个人使用。如果团队需要在群组中使用 AI 且不想维护基础设施,请在决定自定义构建之前,先查看我们最佳 Telegram AI 机器人指南中的现成选项。

从 BotFather 和私人测试聊天开始。一旦回复效果满意,请在邀请真实用户之前收紧白名单、设置 OpenAI 消费上限并审查隐私政策。如果构建时间和维护是主要障碍,可以探索 TeleClaw,这是一个无需代码即可在 Telegram 群组中实现提及回复的替代方案。

相关文章