plugin.yaml 1.5 KB

123456789101112131415161718192021222324252627282930313233343536373839
  1. name: telegram-platform
  2. label: Telegram
  3. kind: platform
  4. version: 1.0.0
  5. description: >
  6. Telegram gateway adapter for Hermes Agent.
  7. Connects to Telegram via python-telegram-bot and relays messages between
  8. Telegram chats/groups/topics and the Hermes agent. Supports threads/topics,
  9. streaming edits, native media, inline keyboards, slash commands, fallback
  10. network transport (direct-IP failover), notification modes, mention gating,
  11. and per-user/chat allowlists.
  12. author: NousResearch
  13. requires_env:
  14. - name: TELEGRAM_BOT_TOKEN
  15. description: "Telegram bot token from @BotFather"
  16. prompt: "Telegram bot token"
  17. url: "https://t.me/BotFather"
  18. password: true
  19. optional_env:
  20. - name: TELEGRAM_ALLOWED_USERS
  21. description: "Comma-separated Telegram user IDs allowed to talk to the bot"
  22. prompt: "Allowed users (comma-separated)"
  23. password: false
  24. - name: TELEGRAM_ALLOW_ALL_USERS
  25. description: "Allow any Telegram user to trigger the bot (dev only)"
  26. prompt: "Allow all users? (true/false)"
  27. password: false
  28. - name: TELEGRAM_HOME_CHANNEL
  29. description: "Default chat ID for cron / notification delivery"
  30. prompt: "Home channel ID"
  31. password: false
  32. - name: TELEGRAM_HOME_CHANNEL_NAME
  33. description: "Display name for the Telegram home channel"
  34. prompt: "Home channel display name"
  35. password: false
  36. - name: TELEGRAM_WEBHOOK_SECRET
  37. description: "Secret token Telegram sends with each webhook update (required with TELEGRAM_WEBHOOK_URL)"
  38. prompt: "Webhook secret"
  39. password: true