ESP32接Telegram机器人:手机远程控制LED

2026-11-18 20:26:10 69阅读 所属项目:ESP32 开发板

家里那块 ESP32 吃灰半年了,上周把它翻出来做了个很实用的东西:给 Telegram 上建个机器人,手机发一条 /led_on,板载 LED 就亮;发 /led_off 就灭。人不在家也能控制,只要板子连着 Wi-Fi,全世界有网的地方都能发命令。整个流程下来没有用到内网穿透,也没有在路由器上开端口,因为 ESP32 是主动去连 Telegram 服务器的,流量方向是出站,这在家用网络里最省事。

这篇按步骤把流程走一遍:建机器人、装库、贴代码、烧录、实测。代码来自 Random Nerd Tutorials 的开源教程(Rui Santos 写的,基于 Brian Lough 的 Universal Telegram Bot 库),我把它理顺并补了几个新手容易卡住的地方,代码本体逐字符搬运,没有改动逻辑。

ESP32 Telegram 控制 LED 效果

先看整体思路:手机上的 Telegram 客户端把消息发给你的机器人,ESP32 每秒轮询一次 Telegram Bot API 拉新消息,收到命令后操作 GPIO,再把结果发回聊天窗口。三种命令对应三个动作,/state 用来查询当前状态。

ESP32 Telegram 控制流程示意图

第一步:BotFather 建机器人,myidbot 查用户 ID

手机装好 Telegram(Google Play 或 App Store 都有),搜索 botfather,或者直接打开 t.me/botfather。点 start 之后发送 /newbot,按提示给机器人起名字和用户名,创建成功它会回一条消息,里面带着 bot token,一串形如 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw 的字符串。

token 就是机器人的钥匙,代码里要用,先存好。官方原话也提醒了:keep your token secure and store it safely,token 泄露等于机器人被人接管。

BotFather 返回 bot token 截图

接着查自己的 Telegram 用户 ID。因为任何知道机器人用户名的人都能给它发消息,代码里要靠用户 ID 把陌生人拦掉。搜索 IDBot 或打开 t.me/myidbot,点 start 后发 /getid,它会回你的 user ID,记下来。

第二步:Arduino IDE 装两个库

ESP32 或 ESP8266 的开发板支持包要先装好(开发板管理器里装 esp32 / esp8266 那两个包),然后装两个库。

第一个是 Universal Telegram Bot Library,Brian Lough 维护的,封装了 Telegram Bot API。注意一个坑:要从 GitHub 仓库下载最新 release 的 zip,走 Sketch > Include Library > Add .ZIP Library 手动装。不要用库管理器装它,教程里明确说 library manager 里可能是过时的 deprecated 版本,装了跑不起来。

第二个是 ArduinoJson,走库管理器直接搜 ArduinoJson 安装就行,教程用的版本是 6.15.2,太新的 7.x API 有变动,报错的话退回 6.x。

Arduino IDE 库管理器安装 ArduinoJson

第三步:完整代码,替换三处占位符

代码 ESP32 和 ESP8266 通用,用条件编译自动选对库。要改的只有三处:REPLACE_WITH_YOUR_SSID 和 REPLACE_WITH_YOUR_PASSWORD 换成你的 Wi-Fi 名和密码,BOTtoken 填 BotFather 给的 token,CHAT_ID 填 myidbot 给的用户 ID。占位符保持原样别乱猜,烧不进去是小事,连不上网查半天。

说明一句:原教程代码里的头文件是尖括号写法(#include 这种),本站编辑器会把尖括号剥掉,所以下面统一改成了编译等价的引号写法(#include "WiFi.h"),对 Arduino 工具链的库搜索路径来说两种写法等价,其余代码逐字符原样。

/*
  Rui Santos
  Complete project details at https://RandomNerdTutorials.com/telegram-control-esp32-esp8266-nodemcu-outputs/
  
  Project created using Brian Lough's Universal Telegram Bot Library: https://github.com/witnessmenow/Universal-Arduino-Telegram-Bot
  Example based on the Universal Arduino Telegram Bot Library: https://github.com/witnessmenow/Universal-Arduino-Telegram-Bot/blob/master/examples/ESP8266/FlashLED/FlashLED.ino
*/

#ifdef ESP32
  #include "WiFi.h"
#else
  #include "ESP8266WiFi.h"
#endif
#include "WiFiClientSecure.h"
#include "UniversalTelegramBot.h"   // Universal Telegram Bot Library written by Brian Lough: https://github.com/witnessmenow/Universal-Arduino-Telegram-Bot
#include "ArduinoJson.h"

// Replace with your network credentials
const char* ssid = "REPLACE_WITH_YOUR_SSID";
const char* password = "REPLACE_WITH_YOUR_PASSWORD";

// Initialize Telegram BOT
#define BOTtoken "XXXXXXXXXX:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"  // your Bot Token (Get from Botfather)

// Use @myidbot to find out the chat ID of an individual or a group
// Also note that you need to click "start" on a bot before it can
// message you
#define CHAT_ID "XXXXXXXXXX"

#ifdef ESP8266
  X509List cert(TELEGRAM_CERTIFICATE_ROOT);
#endif

WiFiClientSecure client;
UniversalTelegramBot bot(BOTtoken, client);

// Checks for new messages every 1 second.
int botRequestDelay = 1000;
unsigned long lastTimeBotRan;

const int ledPin = 2;
bool ledState = LOW;

// Handle what happens when you receive new messages
void handleNewMessages(int numNewMessages) {
  Serial.println("handleNewMessages");
  Serial.println(String(numNewMessages));

  for (int i=0; i lastTimeBotRan + botRequestDelay)  {
int numNewMessages = bot.getUpdates(bot.last_message_received + 1);

while(numNewMessages) {
Serial.println("got response");
handleNewMessages(numNewMessages);
numNewMessages = bot.getUpdates(bot.last_message_received + 1);
}
lastTimeBotRan = millis();
}
}

第四步:代码是怎么跑起来的

核心就三个角色。WiFiClientSecure 是带 TLS 的网络客户端,UniversalTelegramBot 拿 token 和这个客户端初始化,负责所有和 Telegram 服务器的对话。

loop() 里是一个不带 delay 的定时轮询:millis() 记时间,botRequestDelay 设成 1000 毫秒,也就是每秒问一次有没有新消息。getUpdates(bot.last_message_received + 1) 这个参数写法是拉取上一次之后的新消息,避免重复处理。有人发过消息就进 while 循环,逐批交给 handleNewMessages()。

handleNewMessages() 先做鉴权:取出这条消息的 chat_id,和代码里的 CHAT_ID 对不上就直接回一句 Unauthorized user 然后 continue,陌生人的命令根本到不了 GPIO 那一步。这是整个方案安全性的基础,别图省事把这四行删了。

鉴权过了就按文本匹配命令。/start 回欢迎语和命令清单,/led_on 把 ledState 置 HIGH 并 digitalWrite 到 GPIO 2,/led_off 反过来,/state 用 digitalRead 读一下实际电平再回 LED is ON 或 LED is OFF。sendMessage() 三个参数:对方 chat_id、内容、解析模式(这里留空)。

setup() 里 ESP8266 分支多两行:configTime 走 NTP 拿 UTC 时间,再用 setTrustAnchors 挂上 TELEGRAM_CERTIFICATE_ROOT 这个根证书,因为 api.telegram.org 是 HTTPS,8266 的硬件加密能力较弱,需要先校验根证书。ESP32 分支简单一些,setCACert 一行搞定。TELEGRAM_CERTIFICATE_ROOT 是 Universal Telegram Bot 库自带的常量,不用自己去找证书文件。

第五步:烧录、实测和几个坑

烧录链路上新手最容易卡的就是选板子和选串口。Tools > Board 选你手上对应的板子(我这次是 ESP32 Dev Module),Tools > Port 选板子插上的那个 COM 口。上传完按一下板子上的 EN/RST 键让它复位跑起来,打开串口监视器,波特率 115200,看到打印出本地 IP 就说明 Wi-Fi 连上了。

ESP32 板载 LED 点亮实拍

然后打开和机器人的聊天窗口,按顺序发 /start、/led_on、/state、/led_off、/state,机器人应该回欢迎语、LED state set to ON、LED is ON、LED state set to OFF、LED is OFF,板载 LED 跟着亮灭。串口那边同步能看到 handleNewMessages 和收到的命令文本。

Telegram 命令对话实测截图

几个坑列一下。第一,ESP8266 的板载 LED 是反逻辑,发 /led_on 它反而灭、/led_off 它才亮,代码没写错,是硬件就这样,想改正逻辑把 HIGH/LOW 对调即可。第二,忘记先和机器人点 start 的话,bot 没法主动给你发消息,官方在代码注释里专门写了这一条,所以拿到 token 先去聊天窗口点一下 start。第三,token 别提交到公开仓库,也别截图发群里,BotFather 那张图里官方把 token 打码就是这个意思,泄露了在 BotFather 里发 /revoke 换新的。第四,getUpdates 是轮询不是推送,一秒一次已经是比较合理的频率,调太快 Telegram 那边会限流。

这套玩法真正的价值在于:不用公网 IP、不做端口映射、不搞内网穿透,天然适合远程控制的场景。把 LED 换成继电器就是远程开关,把命令换成读传感器就是远程监控,架构一点不用动。家里有吃灰 ESP32 的,值得一试。


作者:固件烧录仔
链接:https://www.aiddithome.com/p/ae5b546281fdd.html
本作版权归作者所有,未经允许请勿转载。若存在违规行为,您可以点击 “举报”。


登录 后发表评论
5条评论
电烙铁爱好者
1楼 · 2026-11-18 20:26:42

这个方案我去年就在家里跑着了,走 Telegram 的好处是真的不用碰路由器,ESP32 主动 getUpdates 轮询出去,运营商 NAT 后面照样能用。我后来把 LED 换成继电器控制鱼缸水泵,botRequestDelay 保持 1000 没被限流过。提醒一句 token 千万别传 GitHub,我见过真泄露的,BotFather 里 /revoke 换一个就行。

板砖搬不动
2楼 · 2026-11-18 20:26:42

ESP8266 那个反逻辑 LED 坑过我一晚上,还以为代码抄错了,最后翻库的 example 才发现板载灯是低电平亮。文章里能专门拎出来说很良心。

调参到凌晨
3楼 · 2026-11-18 20:26:42

库管理器里的 UniversalTelegramBot 真的是老版本,装了直接编译报错,之前就是卡在这,后来去 GitHub 下 zip 才好。

刷视频进来围观
4楼 · 2026-11-18 20:26:42

Unauthorized user 那个鉴权建议再强调下,好多人嫌麻烦把 CHAT_ID 校验删了,bot 用户名被人猜到就等于家里的开关随便别人按。

学生党玩机
5楼 · 2026-11-18 20:26:42

GPIO 2 就是板载灯那颗,想外接 LED 记得换 GPIO 别直灌,串个电阻。整体思路清晰,收藏了。