想用 Python 做一个 TG 机器人，却不知道从哪下手？本文用最直接的方式带你走完整个流程：先给结论，再分步操作。你不需要精通网络编程，只要会一点 Python 基础，就能在半小时内让机器人跑起来。

结论：三步就能跑通一个机器人

用 Python 开发 TG 机器人，本质上就是注册机器人账号、写代码调用接口、保持程序运行这三件事。具体来说：

  • 通过官方机器人 @BotFather 创建机器人，拿到一串 API Token；
  • 用 Python 的 HTTP 请求库或封装库调用 TG Bot API；
  • 把程序部署到能长期运行的服务器上，机器人就会持续响应消息。

下面按顺序展开，每一步都给出可操作的说明。

第一步：注册机器人并获取 Token

1.1 找 @BotFather 创建机器人

在 TG 客户端里搜索 @BotFather，这是官方提供的机器人管理工具。发送 /newbot，按提示依次输入机器人显示名称和用户名（用户名必须以 bot 结尾，且全局唯一）。创建成功后，BotFather 会返回一串形如 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ 的 Token。

1.2 保管好 Token

Token 相当于机器人的密码，拿到后不要发到公开群组或提交到代码仓库。一旦泄露，他人可以完全控制你的机器人。如果不慎泄露，可以在 BotFather 中使用 /revoke 重置。

第二步：配置 Python 环境

2.1 安装 Python 与依赖

建议使用 Python 3.8 及以上版本。开发 TG 机器人有两种常见方式：

  • 直接调用 HTTP API：用 requests 库发送请求，适合理解原理；
  • 使用封装库：如 python-telegram-bot、aiogram 等，封装了常用方法，开发效率更高。

新手可以从 python-telegram-bot 入手，文档较全，社区示例多。安装命令为 pip install python-telegram-bot。注意不同大版本之间 API 有变化，安装时留意版本号，建议固定版本以免代码突然失效。

2.2 写一个最小可运行示例

下面是一个“收到消息就回复”的最小示例，使用 python-telegram-bot 的异步写法：

提示：示例仅用于演示逻辑，实际运行时请替换为你自己的 Token，并确保网络环境可以访问 TG 接口。

核心逻辑是：创建 Application 对象、注册消息处理函数、启动轮询。处理函数里通过 update.message.text 取到用户发来的文字，再用 reply_text 回复。代码量不大，但已经具备了一个机器人的基本骨架。

第三步：理解消息处理与常用功能

3.1 轮询与 Webhook 的区别

TG Bot API 支持两种获取消息的方式：

  • 轮询（Polling）：程序主动向 TG 服务器询问有没有新消息，适合本地开发和测试；
  • Webhook：你提供一个 HTTPS 地址，TG 服务器收到消息后主动推送过来，适合正式部署，响应更及时。

新手先用轮询跑通，部署到服务器后再考虑 Webhook。

3.2 常见功能入口

机器人能做的事很多，入门阶段可以先掌握这几类：

  • 命令处理：识别以 / 开头的消息，如 /start、/help；
  • 文本回复：根据关键词返回内容；
  • 按钮与菜单：使用内联键盘或回复键盘引导用户操作；
  • 群组管理：欢迎新成员、过滤广告等，需要机器人有相应权限。

注意事项：新手最容易踩的坑

  • Token 泄露：不要把 Token 写死在公开代码里，建议用环境变量读取；
  • 网络问题：TG 接口在部分地区访问不稳定，部署前先确认服务器网络环境；
  • 频率限制：机器人发送消息有速率限制，群发时注意控制节奏，避免被限流；
  • 隐私与合规：不要收集与业务无关的用户信息，群组内使用机器人应遵守群规；
  • 版本兼容：封装库升级可能带来破坏性变更，生产环境建议锁定版本。

常见问题

Q1：机器人创建后没反应？

先检查程序是否在运行，再确认 Token 是否正确、网络是否可达。如果使用轮询，可以查看控制台有没有报错信息。

Q2：机器人能主动给用户发消息吗？

不能随意主动私聊。用户必须先与机器人有过交互（例如发送过 /start），机器人才能向其发送消息。这是平台规则，目的是防止骚扰。

Q3：一定要用服务器吗？

本地电脑运行也可以，但关机后机器人就离线了。想让机器人持续在线，需要一台长期运行的服务器或云主机。

Q4：Python 之外的语言可以吗？

可以。TG Bot API 是通用的 HTTP 接口，任何语言都能调用。选择 Python 是因为生态成熟、上手快，适合快速验证想法。

小结

用 Python 写 TG 机器人的路径很清晰：BotFather 拿 Token、选一个封装库、写处理逻辑、部署上线。真正决定机器人好不好用的，不是代码多复杂，而是你是否清楚它要解决什么问题。先做一个能跑的最小版本，再逐步加功能，比一开始追求大而全更靠谱。