在 TG 上创建一个机器人，第一步就是拿到机器人令牌（Token）。它相当于机器人的“账号密码”，谁持有令牌，谁就能以机器人的身份调用接口、收发消息。本文围绕令牌的获取、保管与常见问题展开，先给结论：令牌只在创建时完整显示一次，拿到后应立即妥善保存，绝不公开分享。
什么是机器人令牌
机器人令牌是一串由数字、字母和符号组成的字符串，通常形如“数字:字母数字组合”。它是 TG 机器人平台分配给每个机器人的唯一凭证，用于在调用接口时表明“我是哪个机器人”。没有令牌，程序无法代表机器人工作；令牌泄露，他人也能冒充你的机器人。
需要区分的是：令牌不是聊天账号密码，也不是 API 密钥的通用叫法。它只对应某一个机器人，且可以随时重置。
获取令牌的步骤
- 在 TG 客户端中搜索并打开官方的机器人管理账号（通常名为 BotFather，带官方认证标识）。
- 发送创建机器人的指令，按提示依次填写机器人显示名称和用户名。用户名需以“bot”结尾且全局唯一。
- 创建成功后，管理账号会返回一段消息，其中包含“Use this token to access the HTTP API”字样，后面的字符串就是令牌。
- 立即复制并保存到安全位置，例如本地密码管理器或加密笔记。离开该消息后，完整令牌通常不再重复展示。
如果机器人是他人转让或团队协作创建，令牌应由创建者通过安全渠道传递，避免在群聊、公开频道或代码仓库中明文发送。
令牌保管的三条原则
- 不入库：不要把令牌写进公开代码仓库、前端代码或可被他人访问的配置文件。需要版本管理时，使用环境变量或密钥管理服务。
- 不截图：包含令牌的截图、录屏一旦流出，等同于泄露。演示或教程中应打码或使用已重置的示例令牌。
- 最小知悉：只给实际需要运维机器人的人员授权，定期检查谁接触过令牌。
常见泄露场景与风险
令牌泄露后，他人可以读取机器人收到的消息、以机器人名义发送内容、修改机器人资料，甚至滥用接口导致机器人被限制。常见泄露场景包括：
- 把令牌直接写在开源项目的配置文件中并推送到公开仓库；
- 在群组里求助时贴出完整令牌；
- 使用来历不明的第三方“机器人托管”服务，把令牌交给不可信平台；
- 在教程文章或视频中展示未打码的令牌。
一旦怀疑令牌泄露，不要犹豫，立即重置。重置后旧令牌立刻失效，可最大限度降低损失。
如何重置令牌
- 打开机器人管理账号，选择对应的机器人。
- 进入机器人设置，找到令牌相关选项，选择重置或重新生成。
- 按提示确认后，系统会返回新的令牌。旧令牌随即失效。
- 把新令牌更新到你的程序或托管环境中，并检查机器人是否恢复正常。
重置不会删除机器人，也不会改变机器人的用户名和已有聊天记录，但所有使用旧令牌的程序都需要同步更新。
注意事项
- 令牌区分大小写，复制时避免多余空格或换行。
- 不要把令牌交给声称能“代运营”“刷量”的第三方，这类服务往往伴随风险。
- 团队协作时，建议为不同环境（测试、正式）使用不同机器人，降低单点泄露的影响。
- 如果机器人部署在服务器上，注意配置文件权限，避免其他用户读取。
常见问题
令牌可以找回吗？
创建后完整令牌通常只展示一次。如果丢失，无法“找回”原令牌，只能重置生成新的。因此拿到令牌后应立即保存。
令牌和机器人用户名是一回事吗？
不是。用户名是公开的，用于搜索和提及机器人；令牌是私密的，用于程序调用接口。公开用户名不会导致令牌泄露。
重置令牌会影响机器人用户吗？
不会直接影响普通用户。用户仍可通过用户名找到机器人，但你的程序需要用新令牌重新连接，否则机器人将无法正常响应。
可以把令牌放在手机备忘录里吗？
可以，但建议使用带锁屏和加密功能的笔记应用，并避免同步到不可信的云端。更稳妥的方式是使用密码管理器。
为什么我的令牌调用接口失败？
常见原因包括：令牌复制不完整、令牌已被重置、程序未正确读取环境变量、网络无法访问接口。先核对令牌是否最新且完整，再检查网络与配置。
总结：机器人令牌是 TG 机器人的核心凭证，获取不难，难在长期安全保管。记住“只存必要位置、不公开、泄露即重置”，就能避开大多数风险。