返回博客
AI AgentsTelegramTutorialAutomation

如何在 Telegram 上构建 AI 智能体(2026 年完整指南)

2026 年在 Telegram 上构建 AI 智能体的实用指南:BotFather 配置、四条主要路径(Python、n8n、托管 SaaS、智能体运行时),以及如何做出选择。

作者:Hermify Team||阅读约 3 分钟
深色背景上的 Telegram 纸飞机图标,以及粗体文字"在 Telegram 上构建 AI 智能体",旁边有一条绿色装饰线

你想要一个住在 Telegram 里的 AI 智能体——不是浏览器标签页,也不是又一款手机 App,而是侧边栏里的一个联系人:你发消息,它就回应;它记得你上周说过什么;它能真正做事,而不只是聊天。

好消息是,Telegram 是搭建这类智能体最友好的消息平台。Bot API 免费,通过 BotFather 两分钟即可开通,且不按消息收费——这一点与 WhatsApp Business 截然不同,后者按会话计费,还需要通过 Meta 验证。难点在于,"如何在 Telegram 上构建 AI 智能体"在 2026 年至少分成四条不同的路径,究竟走哪条,取决于你是喜欢自己搭技术栈的开发者,还是希望今晚就能用上智能体的非技术用户。

本指南将带你了解实际需要什么、四条真实路径,以及最后一个实用的决策树。

"Telegram 上的 AI 智能体"究竟是什么

选择技术栈之前,先想清楚你在构建什么。这个说法涵盖的范围很广:

  • 简单的聊天包装器。 机器人将你的消息转发给大语言模型,再把回答转发回来。实用,但聊天记录一滚动就什么都忘了。
  • 带记忆的聊天机器人。 流程相同,但增加了会话记忆或向量数据库,能够回忆之前的消息。
  • 智能体。 一个长期运行的进程,有自己的人格、可以调用的工具(网页搜索、日历、邮件、你自己的 API)、跨会话的持久化记忆,以及独立完成多步骤任务的能力。

网上大多数"构建 Telegram 机器人"的教程止步于聊天包装器。如果你只需要聊天,这完全够用。但如果你希望智能体记住你上周三描述的项目,或者按计划每天早上推送一份早报,你就需要持久化记忆和调度器——正是这两个功能让机器人进化成智能体。

选择技术栈时,以下维度至关重要:

  • 跨会话记忆 — 智能体下周还记得你吗,还是每次新对话都从零开始?
  • 工具与技能 — 它能真正做事(发邮件、搜网页、总结 PDF、调用你的 API)吗,还是只会聊天?
  • BYOK(自带密钥) — 能接入你自己的 OpenAI、Anthropic 或 OpenRouter 密钥吗,还是只能用平台捆绑的额度?
  • 托管方式 — 托管 SaaS、无代码云平台、自托管服务器,还是完全托管的运行时?
  • 白名单 — 能把机器人限定为只响应你自己的 Telegram 用户 ID 吗,还是任何人找到它都能消耗你的 API 额度?

记忆是最关键的差异所在。聊天机器人回答问题;个人智能体记住问题。

对比图:单条一次性 Telegram 消息,与跨越数周的长期持久化记忆线程

第零步:在 BotFather 创建机器人

以下所有路径都从同一个五分钟操作开始,所以先把它做完。

打开 Telegram,搜索 @BotFather,发送 /newbot。BotFather 会依次询问两件事:

  1. 显示名称(可包含空格,之后可以更改)。
  2. 用户名,必须以 bot 结尾,且永久不可更改。

两项都确认后,BotFather 会回复一个形如 123456789:ABCdef... 的 API 令牌。请像保管密码一样保管它——任何人拿到这个令牌都能以你的机器人名义发消息。请将其保存在密码管理器或不会提交到版本库的 .env 文件中。

第一天值得了解的几个常用 BotFather 命令:

  • /setdescription — 用户首次打开聊天时看到的简短介绍。
  • /setcommands — 斜线命令的自动补全菜单。
  • /setprivacy — 在群组中,若希望机器人看到所有消息(而不只是 @ 它的消息),将此项切换为"Disable"。

最后两点常让新手感到意外。第一,Telegram Bot API 是真正免费的,即使规模很大也不按消息收费。第二,默认情况下,Telegram 中的机器人只有在用户先发消息后才会开始对话——因此在开发阶段,先主动给机器人发一条消息,再等待它回复。

路径 1:从零开始用 Python(BotFather + python-telegram-bot + OpenAI)

经典的开发者路径。你编写一个小型 Python 服务,将 Telegram Bot API 与大语言模型 API 连接起来,并决定中间发生什么。

大家普遍采用的技术栈:

# requirements.txt
python-telegram-bot==22.1
openai==1.40.0
python-dotenv==1.0.1

最精简的循环如下:

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

client = OpenAI(api_key=os.environ["OPENAI_API_KEY"])

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

app = Application.builder().token(os.environ["TELEGRAM_BOT_TOKEN"]).build()
app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, reply))
app.run_polling()

这段代码是聊天机器人,还不是智能体。要将其升级为智能体,还需要在此基础上添加四样东西:

  • 记忆。chat_id 为键的 SQLite 或 Postgres 表,用于短期历史记录。对于更长期的回忆,可使用 ChromaDB、Qdrant 或 pgvector 等向量数据库。
  • 工具。 为大语言模型配置函数调用,使其能访问你的 API、网页或文件系统。
  • 白名单。update.effective_user.idALLOWED_USERS 环境变量进行比对,防止随机 Telegram 用户耗尽你的密钥额度。
  • 托管环境。 某个能在你的笔记本睡眠时保持进程运行的地方。每月 $5 的 VPS(如 Hetzner CX22)或树莓派完全够用——模型运行在 OpenAI 的服务器上,不在你这里。

达到"能记忆、会用工具的智能体"的时间成本:熟悉 Python 的话大约一个周末,否则更长。费用:服务商的 token 消耗(个人用量每月几美元)加上托管费用。

最适合: 想要完全控制权、不依赖任何厂商、愿意维护 Python 服务的开发者。

路径 2:用 n8n(或 Make)零代码搭建

如果你不想写代码,但又想对工作流有完整的控制权,n8n 是 2026 年最强的开源选项。它是一个可视化工作流构建器,可以在 $5 的 VPS 上自托管,也可以使用 n8n.cloud。

大致需要四个节点:

  1. Telegram Trigger — 监听机器人上的新消息。
  2. AI Agent 节点 — n8n 内置的智能体节点,配置大语言模型(OpenAI、Anthropic、Groq 等)和记忆缓冲区。
  3. 工具节点(可选)— HTTP Request、Google Sheets、Postgres、你自己的 API。
  4. Telegram Send Message — 在同一聊天中回复。

AI Agent 节点内置了"Memory"选项。选择 Window Buffer Memory 可保留最近 N 轮对话,或者接入 Postgres 或 Redis 记忆节点,以实现跨 n8n 重启的持久化。

有一个值得坦诚说明的权衡:n8n 首先是工作流工具,其次才是智能体平台。当机器人主要作为你已有工作流的分层入口时——线索收录、费用记录、CRM 更新、客服预分类——它表现出色。但当智能体需要真正"思考"而不是"路由"时,它开始显得吃力。一旦你发现自己为了处理自然语言输入的边缘情况而不断添加 IF 节点,就意味着你在用分支模拟推理,智能体最终会失控。我们在Hermes Agent vs n8n中深入探讨了这一权衡。

最适合: 非开发者,或已经在使用 n8n 处理其他工作流、希望为其添加 Telegram 入口的开发者。

路径 3:托管 SaaS 构建平台

这类平台将整个技术栈封装在一个网页界面后面。你注册账号,粘贴 BotFather 令牌,拖拽几个模块,点击发布,机器人就上线了。Voiceflow、Botpress、Mosaia、Lobster Father 以及一长串细分领域的构建工具都属于这一类。

权衡如你所料:

  • 上手最容易——通常不到一小时,有时五分钟内搞定。
  • BYOK 很少见。你通常以溢价消耗平台捆绑的额度,或者一天之内就用完了免费层。
  • 营销页面上宣传的"记忆"往往是会话级别的,而非跨会话的。在承诺之前,第八天再测试一次。
  • 你的消息和用户的消息都会流经平台的基础设施。请仔细阅读隐私政策。

当机器人是面向客户的常见问题解答或线索获取入口,且不需要跨会话的个人记忆时,这条路径完全可行。

最适合: 希望以最低运营成本搭建面向客户的 Telegram 机器人、且不需要跨会话个人记忆的小型企业。

路径 4:自托管智能体运行时

这是最新的一类,也是最适合"Telegram 上的个人智能体"这一使用场景的选项。自托管智能体运行时是一个专门为智能体构建的长期运行进程——它开箱即带结构化记忆、技能层、调度器,以及对 Telegram(及其他消息平台)的原生支持。

两个真正的开源选项:

  • OpenClaw 将所有内容以纯 Markdown 和 YAML 文件存储在你的工作区下。本地优先,透明可见,技能可跨机器迁移,因为它们只是文件。
  • Hermes Agent 是我们最熟悉的,因为 Hermify 正是它的托管版本。它跨会话维护持久化的用户画像和记忆,在工作过程中自动创建和优化技能,可运行在 $5 的 VPS 或树莓派上,并对 Telegram 提供原生支持,包括白名单执行、语音模式和自然语言调度。关于 Hermes Agent 的分步操作指南,请参阅如何在 Telegram 上部署 Hermes Agent

这条路径的费用结构与路径 1 相似(你自己托管),优势在于运行时已为记忆、技能和可靠性做好了大量工作。你只需接入自己的 OpenAI 或 Anthropic 密钥,在配置中填入 BotFather 令牌,就能拥有一个能记忆、能行动的智能体——无需维护任何 Python 服务。

最适合: 想要真正的个人智能体(能记忆、能学习、能做事)、注重掌控技术栈、且能接受在 $5 VPS 上运行或熟悉树莓派的用户。

照片写实风格的深色家庭办公桌,手机屏幕显示一条绿色 Telegram 通知,背后一台小型服务器的 LED 指示灯微微发光

如何做出选择

一个简短的决策树,按照大多数人的实际需求排序:

你的情况 路径
只想要一个聊天机器人,不在乎记忆和工具 托管 SaaS(路径 3)。免费或近乎免费,即开即用。
已经在用 n8n / Make 处理其他工作流 n8n(路径 2)。使用 Telegram Trigger + AI Agent 节点。
是 Python 开发者,想要完全控制权 从零开始用 Python(路径 1)。预留一个周末。
想要真正能记忆、能学习的个人智能体 自托管智能体运行时(路径 4)。
想要路径 4 但不想自己运维服务器 托管运行时——这正是 Hermify 的定位。

做出决定前的一项验证:搭好机器人后,用一周时间和它聊天,然后在第八天回来,看看它还记得什么。如果它能回忆起你上周三描述的项目,那你拥有的就是智能体;如果不能,那就是聊天机器人。聊天机器人本身没什么问题,但你应该清楚自己最终做了哪一个。

为什么选 Telegram,而不是 WhatsApp 或 Discord

这是被问得第二多的问题,值得单独说一下。Telegram 之所以在个人智能体领域胜出,是因为三件事同时成立:Bot API 免费且即时可用(无消息费、无需商业验证、无需模板审批),平台允许第三方机器人零摩擦接入,而且聊天界面(回复、文件附件、语音消息、内联键盘)足够丰富,能够支持智能体风格的交互。WhatsApp Business 按会话收费,需要 Meta 验证和预审批模板——用于事务型客服还算可行,但对于每月 $19 的个人智能体来说实在繁琐。Discord 是个不错的替代方案,前提是你的社群本就在那里;我们在另一篇部署指南中单独介绍了它。

如果你想要的不是自己动手,而是并排对比现有的主流选项,我们也写了一篇更详细的比较文章:Telegram 最佳 AI 助手

结语

最简单的路径——托管 SaaS——对于聊天机器人来说真的够用。如果你享受自己搭技术栈、希望每一行代码都归你所有,Python 从零开始是正确答案。如果你的机器人主要是工作流管道,n8n 是正确答案。如果你想要一个越用越好的长期助手,自托管智能体运行时是正确答案。

如果你想要个人智能体版本、又不想自己运维服务器,立即开始使用 Hermify。它是 Hermes Agent 的托管版本——持久化记忆、BYOK(自带密钥)、Telegram 投递、白名单执行,无需折腾 Docker。

无论你选择哪条路径,终点都是一样的:一个住在你每天查看五十次的那个 App 里的助手。

参考资料

运行你自己的 Hermes Agent

自带 API 密钥,连接 Telegram,60 秒内即可上线一个自我改进的 AI 智能体。

立即开始