| name: telegram-platform |
| label: Telegram |
| kind: platform |
| version: 1.0.0 |
| description: > |
| Telegram gateway adapter for Hermes Agent. |
| Connects to Telegram via python-telegram-bot and relays messages between |
| Telegram chats/groups/topics and the Hermes agent. Supports threads/topics, |
| streaming edits, native media, inline keyboards, slash commands, fallback |
| network transport (direct-IP failover), notification modes, mention gating, |
| and per-user/chat allowlists. |
| author: NousResearch |
| requires_env: |
| - name: TELEGRAM_BOT_TOKEN |
| description: "Telegram bot token from @BotFather" |
| prompt: "Telegram bot token" |
| url: "https://t.me/BotFather" |
| password: true |
| optional_env: |
| - name: TELEGRAM_ALLOWED_USERS |
| description: "Comma-separated Telegram user IDs allowed to talk to the bot" |
| prompt: "Allowed users (comma-separated)" |
| password: false |
| - name: TELEGRAM_ALLOW_ALL_USERS |
| description: "Allow any Telegram user to trigger the bot (dev only)" |
| prompt: "Allow all users? (true/false)" |
| password: false |
| - name: TELEGRAM_HOME_CHANNEL |
| description: "Default chat ID for cron / notification delivery" |
| prompt: "Home channel ID" |
| password: false |
| - name: TELEGRAM_HOME_CHANNEL_NAME |
| description: "Display name for the Telegram home channel" |
| prompt: "Home channel display name" |
| password: false |
|
|
