Telegram
Telegram Setup Hermes Agent integrates with Telegram as a full featured conversational bot. Once connected, you can chat with your agent from any device, send v
Hermes Agent integrates with Telegram as a full-featured conversational bot. Once connected, you can chat with your agent from any device, send voice memos that get auto-transcribed, receive scheduled task results, and use the agent in group chats. The integration is built on python-telegram-bot and supports text, voice, images, and file attachments. …
What this page covers
- Step 1: Create a Bot via BotFather
- Step 2: Customize Your Bot (Optional)
- Step 3: Privacy Mode (Critical for Groups)
- How to disable privacy mode
- Observe group chatter without auto-replying
- Step 4: Find Your User ID
- Step 5: Configure Hermes
- Option A: Interactive Setup (Recommended)
- Option B: Manual Configuration
- Start the Gateway
- Sending Generated Files from Docker-backed Terminals
- Supported MEDIA: file extensions
- Webhook Mode
- Configuration
- Cloud deployment example (Fly.io)
- Proxy Support
- Home Channel
- Cron deliveries in topic mode
- Voice Messages
- Incoming Voice (Speech-to-Text)
- Outgoing Voice (Text-to-Speech)
- Large Files (>20MB) via Local Bot API Server
- Step 1: Obtain Telegram API credentials
- Step 2: Run the telegram-bot-api server
- Step 3: Log the bot out of the public API (one-time)
- Step 4: Point Hermes at the local server
- Step 5: localmode — file access on disk
- Step 6: Test it
- Group Chat Usage
- Multiple Hermes bots in one group
- Troubleshooting: works in DMs but not groups
- Example group trigger configuration
- Notes on mentionpatterns
- Private Chat Topics (Bot API 9.4)
- Use case
- Configuration
- How it works
- Root DM handling
- Skill binding
- Multi-session DM mode (/topic)
- /topic subcommands
- DM Topics vs Multi-session DM mode
- Prerequisites
- Activation flow
- Creating a new topic (end-user flow)
- Auto-renamed topics
- /new inside a topic
- Restoring a previous session
- /topic inside a topic (no argument)
- Under the hood
- Disabling multi-session mode
- Downgrading Hermes
- Group Forum Topic Skill Binding
- Use case
- Configuration
- How it works
- Differences from DM Topics
- Recent Bot API Features
- Streaming transport (gateway.streaming.transport)
- Rendering: Rich Messages, Tables and Link Previews
- Group Allowlisting
- Migration from before PR #17686
- Guest @mention bypass (guestmode)
- Slash Command Access Control
- Interactive Model Picker
- DNS-over-HTTPS Fallback IPs
- How it works
- Configuration
- Proxy Support
- Supported variables
- Configuration
- Message Reactions
- Per-Channel Prompts
- Troubleshooting
- Exec Approval
- Interactive Prompts (clarify)
- Push notification volume
- Status messages edited in place
- Pin incoming user message during agent turn
- Security
Section outline mirrored from the official Hermes Agent documentation. Follow any heading to read the complete text on the source site.
More in Messaging Platforms
Messaging Gateway
Chat with Hermes from Telegram, Discord, Slack, WhatsApp, Signal, SMS, Email, Home Assistant, Mattermost, Matrix, DingTalk, Feishu/Lark, WeCom, Weixin, BlueBubb
Discord
Discord Setup Hermes Agent integrates with Discord as a bot, letting you chat with your AI assistant through direct messages or server channels. The bot receive
Slack
Slack Setup Connect Hermes Agent to Slack as a bot using Socket Mode. Socket Mode uses WebSockets instead of public HTTP endpoints, so your Hermes instance does
WhatsApp Setup Hermes connects to WhatsApp through a built in bridge based on Baileys . This works by emulating a WhatsApp Web session — not through the officia
Signal
Signal Setup Hermes connects to Signal through the signal cli daemon running in HTTP mode. The adapter streams messages in real time via SSE (Server Sent Events
Email Setup Hermes can receive and reply to emails using standard IMAP and SMTP protocols. Send an email to the agent's address and it replies in thread — no sp