Telegram Mini App

From its catalog listing
Phone control panel for Hermes inside Telegram: live status and usage, sessions and their messages, agent cron jobs (create, edit, pause, run now, stop, catch-up per job), logs, skills and memory, a send-to-Telegram box and error alerts, opened from your bot's menu button. Login is Telegram initData (HMAC-SHA256 with Ed25519 fallback, freshness window) checked by a token-only dashboard-auth provider on one token route, against a plugin-owned admin list (TELEGRAM_OWNER_ID plus the plugin setting admins) that refuses everyone until set; being allowed to chat with the bot never grants login. Alerts and the send box reach admins only. Built by Muhammad Aiman (aimanmalib) at Sasa Teguh.
Good to know before installing
a verified login returns the dashboard session token, which authorises the whole dashboard API; because Hermes asks every token provider on every token route, valid initData also passes the token gate of /api/gateway/drain when HERMES_DASHBOARD_DRAIN_SECRET is set (a route the session token cannot reach); the plugin's principals carry the scope telegram-app and its login route demands it once Hermes has per-route scopes (#146551), which also closes drain to initData; loopback dashboard mode only, with the phone app (web/ in the repo) served by your own reverse proxy that forwards only /api/plugins/telegram-app/*. Calls api.telegram.org with TELEGRAM_BOT_TOKEN (read through Hermes's secret route) for the send box and alerts. Runs one background alert thread in the dashboard process (polls errors.log and cron state every 30 s; the plugin setting alerts_enabled: false turns it off) and stores its settings under $HERMES_HOME/state/telegram-app. Reads Hermes sessions, cron jobs, logs, skills and memories; writes only agent cron jobs (no script, no_agent or workdir). No telemetry, no self-update.
From its catalog listing.
How to install
- Install it. Hermes asks for any API keys it needs (this one needs
TELEGRAM_BOT_TOKEN), then asks whether to turn it on.hermes plugins install telegram-app - Said no? Turn it on later:
hermes plugins enable telegram-app - Restart Hermes so it loads the plugin.
Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).
- Category
- Chat apps & voice · Hermes Desktop add-ons
- Maintained by
- aimanmalib (Community)
- Needs
TELEGRAM_BOT_TOKENAPI key- Needs Hermes
- 0.23.0 or newer
- Version
- 0.6.1
- In the catalog
- 2026-11-09
Using the Hermes desktop app? See where plugins live

Full setup & settings ↗Source code ↗
More in chat apps & voice
New Hermes Agent updates every day on X. Follow @HermesWatcher