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
