如何在 Telegram 上设置挖矿警报？ （机器人配置）

创建用于挖掘通知的 Telegram 机器人

1. 访问 Telegram 上的 BotFather 帐户并发送命令/newbot来启动机器人创建。

2. 提供您的机器人的名称和用户名；用户名必须以bot结尾，例如Miningalertbot 。
3. 确认后，BotFather 返回一个 API 令牌——这对于与挖掘软件或脚本集成至关重要。
4. 安全存储令牌；它可以完全控制您的机器人的消息传递功能，并且如果丢失则无法再次检索。
5. 通过向机器人发送一条类似/start 的消息来验证机器人是否处于活动状态——如果注册正确，它应该会做出响应。

将机器人连接到您的采矿设备

1. 确定您的挖矿软件：常见的平台包括PhoenixMiner 、 T-Rex和GMiner ，每个平台都支持自定义通知挂钩。

2. 找到用于启动矿工的配置文件（例如， miner.conf或start.bat ）。
3. 添加在特定事件上执行的脚本触发器 - 例如哈希率下降到基线的 90% 以下、池断开连接或 GPU 温度超过 85°C。
4. 使用cURL或基于 Python 的 HTTP POST 请求将格式化消息发送到 Telegram 的 API 端点： https://api.telegram.org/bot{YOUR_TOKEN}/sendMessage 。
5. 在有效负载中包含聊天 ID — 通过向您的机器人发送消息并检查https://api.telegram.org/bot{YOUR_TOKEN}/getUpdates来获取它。

有效地格式化警报消息

1. 具有清晰标识符的结构警报：包括设备名称、时间戳、GPU 型号、当前算力和偏差百分比。

2. 使用 Unicode 符号，例如 ⚠️ 表示警告，📈 表示性能峰值，使用 ❌ 表示失败，以改善视觉扫描。
3. 将消息长度限制在 4096 个字符以下 - 更长的有效负载需要拆分或截断逻辑。
4. 使用 URL 编码正确编码特殊字符 — 空格变为%20 ，换行符变为%0A 。
5. 通过parse_mode=HTML有选择地应用粗体格式并包装关键值，例如Hashrate: 87.3 MH/s 。

确保机器人通信和访问的安全

1. 将机器人访问限制为仅授权的聊天 ID — 通过根据白名单验证传入的chat_id来忽略来自未知用户的消息。

2. 避免将 API 令牌直接嵌入到暴露于系统日志或版本控制存储库的 shell 脚本中。
3. 如果检测到可疑活动，请使用 BotFather 的/revoke命令定期轮换令牌。
4. 除非明确需要，否则禁用内联模式和组权限 - 组中的机器人可能会被滥用于发送垃圾邮件或网络钓鱼。
5. 通过 Telegram 的机器人分析仪表板监控机器人的使用情况，可通过 BotFather 的/stats命令访问。

常见问题解答

问：我可以在不运行本地脚本的情况下接收警报吗？答：是的 - 2Miners和F2Pool等一些矿池通过仪表板设置提供原生 Telegram 警报集成。通过链接您的机器人令牌并指定钱包地址来启用它们。

问：为什么我的机器人不响应 /start 但接受 API 消息？答：除非经过编程，否则 Telegram 机器人不会自动回复命令。 /start消息出现在getUpdates输出中，但需要后端服务来处理和回复。

问：在 Docker 容器内公开我的机器人令牌是否安全？答：本质上不是——容器可能会通过日志或检查泄漏环境变量。通过 Docker 机密传递令牌或将它们挂载为只读文件，而不是将它们作为纯文本 ENV 变量注入。

问：我可以通过 Telegram 机器人发送挖矿仪表板的屏幕截图吗？答：是的 — 使用scrot或ffmpeg等工具捕获终端输出或 Web UI，然后通过带有 multipart/form-data 编码的sendPhoto端点上传图像。