Telegram Bot 告警与通知配置实战指南 (Telegram Alert Setup Guide)
💡 文档背景 :本指南结合本项目在实际部署过程中的实战踩坑与配置经验编写,手把手指导如何从零创建 Telegram Bot、获取个人/群组 Chat ID、配置代理与阈值,并将现货-合约 Delta 中性套利监控服务部署至后台常驻运行。 目录 (Table of Contents) 一、准备工作:创建 Telegram 机器人与获取 Token 二、获取接收通知的 Chat ID(私聊 vs 群组) 三、环境变量配置 ( .env ) 四、连通性与推送功能验证 五、后台常驻运行(Tmux 与 Systemd) 六、实战高频踩坑与常见问题 (FAQ) 一、准备工作:创建 Telegram 机器人与获取 Token 1. 向 @BotFather 申请 Bot 在 Telegram 搜索栏搜索官方机器人 @BotFather (带蓝色认证对勾)并打开对话。 发送指令: /newbot 。 按照提示输入机器人的 显示名称 (Name,如 My Arbitrage Alert )。 输入机器人的 唯一用户名 (Username,必须以 bot 结尾,如 web3arbitrage_alert_bot )。 BotFather 会生成一段 API Token (形如 8875314269:AAHR_ZNcI_I3e5ZINV22222222222222222 )。 ⚠️ 关键避坑点(Token 完整性) : 完整的 Token 必须包含前面的 数字 ID 、 英文冒号 以及 后缀密钥 (例如 8875314269:AAxxxxxxxxx )。 切勿漏掉冒号前面的数字 ID ,否则请求 Telegram API 时会直接报错 HTTP 404 Not Found 。 配置时 无需手动添加 bot 前缀 (直接填写 8875314269:AAxxxx... 即可)。 二、获取接收通知的 Chat ID(私聊 vs 群组) 通知推送支持发送给 个人私聊 或 多人协作群组 。 场景 A:发送到「个人私聊」 打开 Telegram,私聊您的新机器人并点击一次底部的 START (或发送 /start )。 在终端运行本项目的内置辅助命令: python cli.py monitor get-chat-id 系统将自动输出您的个人 Chat ID(正整数,例如 69...