op-packages/telegrambot/README.md
github-actions[bot] 32600acc60 🌴 Sync 2026-03-05 23:51:42
2026-03-05 23:51:42 +08:00

50 lines
1.6 KiB
Markdown

# Openwrt Telegram Bot
Telegram bot for router with firmware Lede/Openwrt.
## Implemented functions (Commands via Telegram message)
- */memory* return RAM info
- */clients* connected clients
- */wll_list* wifi clients
- */wifi_list* wifi info
- */reboot* reboot the device
- */wol <mac_address>* wake on lan over the Internet
- */wanip* WAN ip address
- */<script_name>* any scripts in the `plugins` directory
## Prerequisites
Telegram bot run under Lede or Openwrt firmware than the first prerequisite is to have Lede/Openwrt installed.
Second prerequisite is to have `curl` package installed. You can do this with command `opkg update && opkg install curl`.
## Installation Steps
### Step one:
- Get your chat_id of Telegram. If you don't know what is your chat_id you can use bot @get_id_bot.
- Get a bot token and start your bot. If you don't know how get it you can use bot @BotFather. Send him /newbot command , name of your new bot and a username. Get the returned string "Use this token to access the HTTP API:"
### Step two:
Install Package [telegrambot_0.0.3-1_all.ipk](http://openwrt.132lan.ru/packages/packages-19.07/mipsel_24kc/packages/telegrambot_0.0.3-1_all.ipk) of your Lede/Openwrt system.
### Step three:
Set your variables (bot token and chat id) in `telegrambot` file under `/etc/config/` dir.
```sh
uci set telegrambot.config.bot_token='[PUT YOUR BOT TOKEN HERE]'
uci set telegrambot.config.chat_id='[PUT YOUR CHAT ID HERE]'
uci commit telegrambot
```
Start `telegrambot` service with commands:
```/etc/init.d/telegrambot restart```
Enjoy your bot!