电报机器人详细教程：从零开始创建你的第一个Telegram Bot

Telegram（电报）不仅是即时通讯工具，更是一个开放的自动化平台。通过机器人（Bot），你可以实现自动回复、消息推送、群组管理、数据查询等功能。很多人以为开发机器人需要高深技术，其实只要跟着本教程走，零基础也能完成第一个Bot。

本文将用最清晰的方式，带你完成从注册到运行的全过程。

一、准备工作：你需要什么？

在开始之前，请确认以下几点：

• 一个Telegram账号（手机号注册即可）
• 能访问Telegram客户端（手机或桌面版）
• 一台能联网的电脑（用于运行代码）
• 基础的命令行操作知识（不会也没关系，会逐步说明）

如果你想省去写代码的步骤，也可以使用现成的自动化平台，但本教程以“自己动手”为主线，帮助你真正理解原理。

二、第一步：通过BotFather创建机器人

Telegram官方有一个专门管理机器人的账号，叫 @BotFather。所有机器人都在这里注册。

操作步骤：

1. 在Telegram搜索栏输入 `@BotFather`，认准官方蓝色认证标记。 2. 点击“开始”按钮，发送 `/newbot`。 3. BotFather会问你机器人的显示名称（例如：我的助手）。 4. 然后问你机器人的用户名，必须以 `bot` 结尾，例如 `myhelper_bot`。 5. 创建成功后，你会收到一条消息，里面包含 Token（一串类似 `123456:ABC-DEF...` 的字符）。

这个Token就是机器人的“钥匙”，不要泄露给任何人，否则别人可以控制你的机器人。

三、第二步：理解Token与API基础

Telegram Bot API 是一个HTTP接口。你只需要向特定的URL发送请求，就能让机器人发消息、收消息。

基本格式：

https://api.telegram.org/bot<你的Token>/方法名

例如，获取机器人信息：

https://api.telegram.org/bot123456:ABC-DEF/getMe

在浏览器打开这个链接，如果返回JSON数据，说明Token有效。

常用方法：

• `getUpdates`：获取收到的消息
• `sendMessage`：发送消息
• `setMyCommands`：设置命令菜单

四、第三步：编写最简单的机器人（Python示例）

我们使用 Python 的 `python-telegram-bot` 库，它封装了API，让代码更简洁。

1. 安装库

pip install python-telegram-bot

2. 编写代码

新建文件 `bot.py`：

from telegram.ext import Updater, CommandHandler
TOKEN = '你的Token'
def start(update, context):
    update.message.reply_text('你好！我是你的第一个机器人。')
def main():
    updater = Updater(TOKEN, use_context=True)
    dp = updater.dispatcher
    dp.add_handler(CommandHandler('start', start))
    updater.start_polling()
    updater.idle()
if __name__ == '__main__':
    main()

3. 运行

python bot.py

然后在Telegram中向你的机器人发送 `/start`，它会回复“你好！我是你的第一个机器人。”

这就是最基础的机器人。你可以继续添加更多命令，比如 `/help`、`/time` 等。

五、第四步：设置命令菜单与描述

为了让用户知道机器人能做什么，你可以通过BotFather设置命令列表。

在BotFather中发送 `/setcommands`，选择你的机器人，然后输入：

start - 启动机器人
help - 获取帮助
time - 显示当前时间

这样用户在聊天框输入 `/` 时，就会看到这些命令提示。

六、第五步：使用Webhook实现实时响应

上面的例子使用 `start_polling`，即机器人主动向Telegram请求更新。另一种方式是 Webhook：Telegram主动把消息推送到你的服务器。

Webhook适合部署在公网服务器上，响应更快、更省资源。你需要：

1. 一个HTTPS地址（可以用Nginx反向代理） 2. 设置Webhook：

https://api.telegram.org/bot<Token>/setWebhook?url=https://你的域名/你的路径

3. 在代码中监听该路径并处理更新。

对于新手，建议先用轮询（polling）跑通逻辑，再尝试Webhook。

七、常见问题与注意事项

• Token泄露：一旦泄露，立即在BotFather中使用 `/revoke` 重置。
• 机器人被限制：不要发送垃圾信息，否则可能被Telegram封禁。
• 隐私模式：默认机器人只能收到以 `/` 开头的命令。如果希望收到群组所有消息，需在BotFather中关闭隐私模式（`/setprivacy`）。
• 调试工具：可以使用 `getUpdates` 查看原始消息格式，方便开发。

八、进阶方向

掌握基础后，你可以尝试：

• 接入第三方API（天气、翻译、新闻）
• 使用数据库存储用户数据
• 制作 inline 机器人（在任意聊天中调用）
• 部署到云服务器（如VPS、Heroku、Railway）

总结

本篇电报机器人详细教程覆盖了从BotFather注册、Token获取、代码编写到Webhook部署的完整流程。核心步骤只有四步：创建机器人、拿到Token、写处理逻辑、运行并测试。只要动手实践一次，你就能理解机器人的工作原理。接下来，尝试添加自己的命令和功能，让它真正为你所用。