Hermes Agent Telegram earns an 8.1 out of 10 from me: it's a very complete way to reach an AI agent from your phone, held back mainly by group-chat setup friction and Telegram's own file cap.
That score is my editorial reading of the official documentation, criterion by criterion, with the reason for each rating in the table below.
I've checked everything against the Hermes Telegram docs as they stand at release v0.23.1, dated 9 November 2026.
If you'd like my team to sanity-check whether it suits your business, book a free SEO strategy session.
The Scorecard
| Criterion | Score | Why, from the docs |
|---|---|---|
| Setup speed | 9/10 | Create with QR in the dashboard or desktop app makes the bot and writes the token and your ID for you. |
| Access control | 9/10 | Deny-by-default, numeric allowlists, one-hour pairing codes, separate group gates and admin-only commands. |
| Group chat handling | 7/10 | Powerful mention and topic rules, but Telegram's privacy mode forces a remove-and-re-add step that confuses people. |
| Voice | 9/10 | Voice notes are transcribed, with a local option that needs no key, and replies can come back as voice bubbles. |
| Files | 7/10 | Wide list of attachment types, but the public Bot API stops at 20 MB unless you self-host a Bot API server. |
| Hosting flexibility | 8/10 | Polling, webhook mode for sleeping cloud hosts, proxies, or the shared bot on Hermes Cloud. |
| Everyday polish | 8/10 | Inline model picker, tap-to-answer buttons, quiet notifications by default and a status indicator. |
| Documentation | 8/10 | Long and detailed, with a clear troubleshooting order, though one feature table disagrees with the page text. |
Average across the eight: 8.1.
These are judgements from reading the docs, not benchmark results.
I weighted nothing: each criterion counts the same, so a reader who cares only about voice can read that row and ignore the rest.
What Hermes On Telegram Actually Is
Hermes Agent is Nous Research's MIT-licensed open-source agent, published on GitHub.
Telegram is one of many platforms its messaging gateway connects, alongside Discord, Slack, WhatsApp, Signal, email and others.
The gateway is a single background process that holds the sessions, runs scheduled jobs and sends voice replies.
The v0.23.0 release made one gateway per machine the owner of every conversation, so Telegram, the desktop app and the CLI share one history.
Strength: The Fastest Start Of Any Messaging Route
Most chat integrations make you copy tokens between browser tabs.
Telegram's Create with QR button skips that: scan a code, and Hermes creates the bot, detects your user ID, writes both values to the profile's .env and restarts the gateway.
The manual BotFather path is still short: /newbot, a name, a username ending in bot, and a token.
That's why setup speed gets the top mark.
Strength: Access Control Is Strict By Default
This is where I'd put the most weight for a business.
The gateway turns away anyone not on an allowlist or paired through a DM code.
The team assistant guide documents the pairing safeguards: one-hour code expiry, one request per user every 10 minutes, at most three pending codes, and a one-hour lockout after five failed approvals.
On top of that you get group-only sender lists, whole-group allowlists and a split between admins and regular users for slash commands.
Exec approval asks you for a yes or no in the chat before a flagged command runs.
Even the inline command search respects the allowlist: people who aren't authorized get an empty list, so your installed skills stay hidden from strangers.
🔥 Rated it, now want it running properly? Inside the AI Profit Boardroom you get step-by-step video trainings, the installable Agent OS, four coaching calls a week and 3,400+ members comparing their Hermes messaging setups. → Join the AI Profit Boardroom
Strength: Voice That Works Like A Dictaphone
Voice notes go through speech-to-text before the agent reads them.
You choose the engine: faster-whisper on your own machine with no API key, Groq Whisper, or OpenAI Whisper.
Spoken replies arrive as Telegram voice bubbles, provided ffmpeg is installed for the default Edge TTS voice.
Turn transcription off and the agent gets the raw audio file path instead, which is handy if you run your own pipeline.
Strength: Small Touches That Add Up
The polish score comes from details most integrations skip.
- Model picker:
/modelopens an inline keyboard of providers and models that edits one message in place. - Choices as buttons: when the agent needs a decision, Telegram shows tap-to-answer options, with a typed fallback.
- Quiet by default: the
importantnotification mode only rings for final answers, approvals and command confirmations. - Status line: an optional indicator sets the bot's short description to Online or Offline.
- Missed messages: anything sent while the gateway was down waits up to 24 hours and is answered in order.
- Separate workspaces: DM topics give one bot several isolated conversations, each with its own history.
None of these is a headline feature, but together they make the bot pleasant to use all day.
It loses a couple of points only because some of them, like DM topics, need extra BotFather settings first.
Limit: Groups Need Deliberate Setup
The docs are blunt that privacy mode is the most common source of confusion.
It's on by default, so a bot in a group sees only commands, replies to itself, service messages and channel posts where it's an admin.
Turning it off isn't enough: you then have to remove and re-add the bot to each group.
Once that's done the controls are excellent: require_mention, regex wake words, topic allowlists, ignored threads and a mode that reads chatter as context without replying.
The friction is real, which is why this row sits at 7.
Limit: The 20 MB File Ceiling
Telegram's public Bot API won't hand over files larger than 20 MB, and Hermes replies "too large".
The documented workaround is a local telegram-bot-api server in --local mode, which raises the limit to 2 GB.
It works, but it means running Docker, getting API credentials from Telegram and logging the bot out of the public API.
For long meeting recordings that's worth it; for most office files 20 MB is plenty.
The docs also warn that the local server trusts anyone who can reach its port, so it must stay bound to localhost or a private network.
One more file trap: if Hermes runs commands in Docker, files it creates must sit on a path the host can see, or delivery fails.
A Documentation Conflict Worth Knowing
The capability table on the messaging overview shows no reactions for Telegram.
The Telegram page itself documents optional reactions, off by default, that show 👀 while working and 👍 or 👎 when finished.
I'd trust the Telegram page, since it gives the exact config key, but don't plan a workflow around reactions until the two agree.
Hermes Cloud's Shared Bot
On Hermes Cloud with Team Gateway, there's no bot of your own.
You press Link Telegram, send the one-time /link code to a shared Hermes bot, and talk to your agent through it.
That linking flow landed in v0.22.7 on 3 November 2026.
You can still run your own bot next to it with GATEWAY_RELAY_ALLOW_DIRECT_PLATFORMS=true, at the cost of the instance never sleeping.
It's the right pick for people who don't want to babysit a server, and a weaker pick if your brand needs to sit on the bot.
Where Nous Portal manages access for an agent, the linking happens from the Portal instead, through its Message platforms option.
Either way the setup is a few clicks, which keeps the hosting score high.
How It Holds Up In Three Small Businesses
A bakery owner
- Sends a voice note at 5am: tomorrow's order changes and a supplier question.
- The agent transcribes it, lists the changes and drafts the supplier message.
- She copies the draft and sends it herself.
Verdict: a strong fit, because voice is the bot's best feature.
An estate agency team
- The office group adds the bot, with privacy off and
require_mentionon. - An agent types "@officebot summarize this viewing feedback into three bullets".
- The bot replies in the group; other messages pass untouched.
Verdict: good, once someone has done the re-add step.
A freelance consultant
- Sets
/sethomein the DM. - Asks for a weekday 8am brief of the week's open tasks from a notes file on the machine.
- Uses
/bgto run a long research task while carrying on the chat.
Verdict: excellent for a one-person operation.
Across all three, the pattern holds: the bot drafts, summarises and schedules, and a person sends anything that reaches a customer or supplier.
That's the safest way to use it, because Hermes approvals are built around risky commands rather than outgoing messages, so "draft only" belongs in the request itself.
Who Should Use It
- Owners who want their agent on their phone without a new app.
- Small teams that already coordinate in Telegram groups.
- Anyone who thinks out loud and wants voice notes turned into tasks.
- People happy to keep a gateway running on a machine, or to use Hermes Cloud.
- Anyone already using Hermes on a desktop, since the Telegram chat joins the same session history.
Who Shouldn't
- Businesses wanting a public customer chatbot; unlisted users get a pairing code, not an answer.
- Anyone planning bulk or broadcast messaging.
- Teams that live in Slack or Discord, where Hermes also connects.
- Anyone unwilling to guard a bot token, since whoever holds it controls the bot.
📞 Want a straight answer for your business? Book a free SEO strategy session and my team will tell you whether an agent on Telegram is the right first move. → Book the free session
Final Verdict
8.1 out of 10.
Setup, access control and voice are the strongest parts of the integration, and the docs back every claim with a config key.
Groups and big files need extra setup steps, and that's the whole of the downside.
If customer support is what you're really after, compare it with our verdict on Hermes Agent for customer support and read the security docs before you open any bot to more people.
🔥 Get the setup files and the people who use them daily Inside the AI Profit Boardroom you get the trainings, the installable Agent OS, four weekly coaching calls and 3,400+ members to check your Telegram config with. → Join the AI Profit Boardroom
Also On Our Network
- 🌐 The six-step setup order, from BotFather token to locked-down group chats
- 🌐 Whether a small business should run it, with salon, shop and crew examples
- 🌐 Five copy-paste prompts that set up groups, pairing, briefs and voice from inside the Agent OS
- 🌐 Which AI model to run behind the bot, by real GoldieBench scores
FAQ: Hermes Agent Telegram Verdict
What is the weakest part of Hermes on Telegram?
Group setup. Privacy mode is on by default, so you must turn it off and re-add the bot, or make it an admin, before it sees normal group messages.
Is the 8.1 score from a benchmark?
No. It is an editorial rating built from reading the official Hermes docs criterion by criterion, with the reasoning shown in the scorecard.
Does Hermes support Telegram reactions?
The Telegram page documents optional reactions, off by default, but the messaging overview table shows none. Treat the feature as documented but unconfirmed until the two agree.
Is it good as a customer-facing bot?
Not with the defaults. Unknown users get a pairing code rather than an answer, which makes it a strong staff tool rather than a public chatbot.
Can it handle long voice recordings?
Up to 20 MB on the public Bot API. A self-hosted telegram-bot-api server in local mode raises the limit to 2 GB.
📺 Video notes + links to the tools 👉
🎥 Learn how I make these videos 👉
🆓 Get a FREE AI Course + Community + 1,000 AI Agents 👉
About Julian
I'm Julian Goldie, an SEO entrepreneur, author and founder of the AI Profit Boardroom, which has 3,400+ members.
I help business owners scale with AI agents, automation and SEO.
- I've built a 7-figure SEO and link building agency, Goldie Agency, with a team of 70+ SEO experts.
- I've grown a YouTube channel to 400,000+ subscribers.
- I wrote "Link Building Mastery".
- My Udemy courses have taught over 29,000 students.
→ Get my best AI training inside the AI Profit Boardroom
If the 8.1 fits how your team works, set it up this week, and book a free strategy session if you want my team to plan what you hand to Hermes Agent Telegram first.
