Hermes Agent Telegram Integration
Use Hermes Agent from Telegram for private mobile commands, voice notes, group alerts, topic replies, cron notifications, and memory-backed assistant workflows.
Quick answer
Use the Hermes Telegram integration when you want a mobile AI agent that can answer, run tools, remember context, and deliver scheduled work in chat. Self-hosting requires bot tokens, gateway uptime, provider keys, and monitoring; FlyHermes is the managed path when Telegram availability matters more than owning the server.
Managed cloud · API costs included · No gateway maintenance
Best for
Private mobile access to a local or VPS-hosted Hermes Agent
Cron/job alerts sent to a chat you already check
Voice-note and file handoffs when you are away from the terminal
Small trusted groups where Hermes only responds when mentioned
Features
- ✓Private messages
- ✓Voice memo transcription
- ✓File upload
- ✓Group support
- ✓Inline buttons
- ✓Image generation
Setup path
- 1Review whether Telegram is the right surface for the workflow
- 2Create a bot with @BotFather
- 3Add the token and allowed user IDs to the active Hermes profile
- 4Restart the Telegram gateway
- 5Verify private messages before groups, voice, or cron delivery
Safe Telegram rollout path
Start with one private chat and one Hermes profile. After the first smoke test, add voice notes, cron delivery, or group access one at a time so token overhead and permission mistakes stay visible.
- •Private chat first: token, allowed user ID, one smoke-test message.
- •Group/topic second: require mentions and verify the group or topic ID.
- •Always-on third: move to VPS, Docker Compose, or FlyHermes only after local behavior is correct.
Community evidence to include in the setup
Discord support history repeatedly surfaced messaging-gateway issues: Telegram token overhead from a bad startup directory, gateway restart questions, and platform bots reading more context than expected. The practical fix is to treat the gateway as production infrastructure, not a casual chat plugin.
- •Run Hermes from the intended home/project directory.
- •Keep gateway profiles smaller than your full local coding profile.
- •Check logs after every token, allowlist, or group-setting change.
Common setup issues
- If Telegram suddenly uses far more tokens than the CLI, check the gateway working directory and loaded AGENTS.md/SOUL.md files before blaming the model.
- If the bot responds in the wrong chat, verify numeric allowed user IDs, group IDs, and topic/thread configuration.
- If replies stop after a restart, confirm the token is loaded by the active Hermes profile, not a different shell or service environment.
FAQ
Is Telegram better than Discord for Hermes Agent?
Telegram is better for private mobile access, voice notes, quick approvals, and alerts. Discord is better for team/community channels, slash commands, and threaded collaboration.
Can Hermes Agent use Telegram groups and topics?
Yes, but verify private messages first, then add groups or topics with allowlisted users and mention-only behavior so Hermes does not free-respond in the wrong place.
Why does Telegram sometimes use more tokens than the CLI?
Gateway sessions can load different working-directory instructions, skills, or profile context than the CLI. Check the gateway working directory, active profile, and loaded context before changing models.
Where do I find the setup steps?
Use the connect Telegram checklist for short steps or the Telegram setup blog post for deeper hosting, group, and troubleshooting guidance.