| 123456789101112131415161718192021222324252627282930313233343536373839 |
- 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
- - name: TELEGRAM_WEBHOOK_SECRET
- description: "Secret token Telegram sends with each webhook update (required with TELEGRAM_WEBHOOK_URL)"
- prompt: "Webhook secret"
- password: true
|