跳转至

如何申请 Telegram Bot 并获取 Token

TG-FF 对接 Telegram Bot API 时，需要你先创建一个 Telegram 机器人，并从 BotFather 获取 Bot Token。

本教程会带你完成：

  1. 找到官方 BotFather
  2. 发送 /newbot 创建机器人
  3. 按提示设置名称和用户名
  4. 复制并保存 Bot Token

安全提示

Bot Token 相当于机器人密钥，不要发给他人，也不要提交到公开仓库。Token 泄露后，他人可以控制你的机器人。

开始之前，请先准备好

准备项 说明
Telegram 账号 手机 App、桌面版或 Telegram Web 均可
可联网环境 需能正常访问 Telegram
记事本或密码管理器 用于保存 Bot Token

第一步：找到 BotFather

BotFather 是 Telegram 官方提供的机器人管理工具，所有 Bot 都通过它创建。

  1. 打开 Telegram，点击顶部 搜索框
  2. 输入 BotFather
  3. 在结果中选择带 蓝色认证标记 ✔ 的 BotFather（用户名 @BotFather）
  4. 点击进入对话

搜索并打开 BotFather

认准官方账号

请务必选择带认证标记的 @BotFather。不要使用名称相似的非官方账号。

第二步：发送 /newbot 创建机器人

进入 BotFather 对话后：

  1. 点击底部 输入框
  2. 输入 /，会弹出 BotFather 的命令菜单
  3. 选择 /newbot（create a new bot）
  4. 发送该命令

选择 /newbot 命令

发送后，BotFather 会回复并提示你设置机器人的 显示名称：

发送 /newbot 后设置名称

其他常用命令

  • /mybots —— 管理已有机器人
  • /token —— 重新获取 Bot Token
  • /revoke —— 撤销当前 Token

第三步：设置名称和用户名

BotFather 会分两步询问：

3.1 设置显示名称

  1. BotFather 提示 「How are we going to call it?」 时，输入你想要的 显示名称
  2. 显示名称可以包含中文、空格和 emoji，例如 TG-FF Stream Bot
  3. 发送消息

3.2 设置用户名

  1. BotFather 接着会要求设置 用户名（Username）
  2. 用户名规则：
  3. 必须 以 bot 结尾（不区分大小写）
  4. 只能包含英文字母、数字和下划线
  5. 全局唯一，若已被占用需换一个
  6. 输入符合规则的用户名并发送，例如 tg_ff_stream_bot

若提示用户名已被占用，换一个名字重试即可。

第四步：复制 Bot Token

用户名设置成功后，BotFather 会返回创建成功的消息，其中包含：

  • 机器人链接（形如 t.me/你的用户名）
  • HTTP API Token（即 Bot Token）

操作步骤：

  1. 找到消息中 「Use this token to access the HTTP API:」 下方的 Token 字符串
  2. Token 格式类似 7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  3. 点击或长按 Token 后复制
  4. 立即粘贴到记事本或密码管理器中保存

复制 Bot Token

Token 请立即保存

创建成功后请马上复制 Token。若当时没有保存，可向 BotFather 发送 /mybots → 选择你的 Bot → API Token 查看或重新生成。

在 TG-FF 中使用

将复制的 Bot Token 填入 TG-FF 对应配置项并保存即可。

常见问题

用户名必须以 bot 结尾吗？

是的。这是 Telegram 的硬性规则。例如 tg_ff_stream_bot 合法，tg_ff_stream 不合法。

创建时没复制 Token 怎么办？

  1. 向 BotFather 发送 /mybots
  2. 选择你的机器人
  3. 点击 API Token 查看或重新生成

重新生成会使旧 Token 失效

若旧 Token 已填入 TG-FF 或其他服务，重新生成后需同步更新所有使用处。

Token 泄露了怎么办？

  1. 向 BotFather 发送 /revoke，或在 /mybots 中撤销 Token
  2. 重新生成新 Token
  3. 在 TG-FF 及所有相关服务中更新为新 Token

手机 App 和电脑版操作一样吗？

一样。BotFather 的对话流程在所有 Telegram 客户端上相同，本文以桌面版界面为例，手机端步骤一致。

流程回顾

flowchart LR
    A[搜索 BotFather] --> B[/newbot 创建]
    B --> C[设置名称和用户名]
    C --> D[复制 Bot Token]

按以上步骤操作，你就能完成 Telegram Bot 申请并获取 Token。遇到问题可加入 TG-FF 用户交流群 交流。