Blog / Telegram setup
How to Set Up a BotFather Token for Hermes Agent
A BotFather token is the credential that lets Hermes Agent connect to a Telegram bot. Create the bot in Telegram, store the token carefully, paste it only into the guided deployment flow, and verify one private reply before inviting the assistant into a group.
- 01
Create the bot
Open BotFather in Telegram, create a new bot, choose a name and username, and keep the issued token private.
- 02
Secure the token
Treat the token like a password. Do not paste it into chats, screenshots, support tickets, or public repositories.
- 03
Connect Hermes Agent
Paste the token into the Telegram channel step of the Hermes Agent deployment flow and save the configuration.
- 04
Verify one reply
Send a test message in a private chat before inviting the bot to a group or production workflow.
Four-step path
How do you create and use a BotFather token?
The safe path is to create the bot, copy the token once, store it securely, and test Hermes Agent in a private chat.
- Step 01
Create the bot
Open BotFather in Telegram, create a new bot, choose a name and username, and keep the issued token private.
- Step 02
Secure the token
Treat the token like a password. Do not paste it into chats, screenshots, support tickets, or public repositories.
- Step 03
Connect Hermes Agent
Paste the token into the Telegram channel step of the Hermes Agent deployment flow and save the configuration.
- Step 04
Verify one reply
Send a test message in a private chat before inviting the bot to a group or production workflow.
What is a BotFather token for Hermes Agent?
A BotFather token is the Telegram bot credential that allows Hermes Agent to receive messages from and send replies through a specific Telegram bot identity.
The token binds the deployment to one bot. If the token is wrong, revoked, or copied from the wrong bot, the Hermes Agent runtime can be healthy while Telegram messages still fail.
How should you protect the Telegram bot token?
Protect the Telegram bot token as a secret credential: store it in the deployment flow or secret manager only, avoid screenshots, and rotate it immediately if it is exposed.
- Never commit the token to GitHub or a shared note.
- Do not send the token in Telegram, Discord, WhatsApp, or email.
- Rotate the token through BotFather if it appears in logs or screenshots.
- Use a separate test bot when validating a new deployment.
Why should you test Telegram privately first?
A private Telegram test isolates token, runtime, and reply issues before group permissions and human traffic add more variables.
Private testing gives the clearest success signal: the bot receives one message and Hermes Agent returns one expected reply. After that succeeds, group rollout is safer.
How do you move from private chat to a Telegram group?
Move to a Telegram group only after the private chat works, then invite the bot, check its group permissions, and test with a low-risk prompt.
If group messages fail but private messages work, the issue is usually group privacy mode, missing access, or the way the group is addressing the bot rather than the token itself.
Which primary sources support this page?
Product behavior is checked against the current deployment flow. These external links provide the upstream project or channel documentation used for setup details.
Direct answers
Frequently asked questions
Can one BotFather token run multiple Hermes Agent deployments?
Use one active deployment per Telegram bot token when possible. Reusing the same token across deployments makes message routing and troubleshooting harder.
What should I do if the token was leaked?
Revoke or regenerate the token in BotFather, update the Hermes Agent deployment, and remove the exposed value from any logs or shared files.
Do I need a Telegram group to test Hermes Agent?
No. A private chat is the better first test because it proves the token and runtime before group permissions are involved.
Why does the bot not respond after I pasted the token?
Check that the token belongs to the intended bot, the deployment is running, the bot was messaged directly, and no old revoked token is still configured.
Key takeaways
- A BotFather token is the credential that lets Hermes Agent connect to a Telegram bot. Create the bot in Telegram, store the token carefully, paste it only into the guided deployment flow, and verify one private reply before inviting the assistant into a group.
- Start with one model, one channel, and one controlled test conversation.
- Use managed hosting when deployment speed matters more than operating the server yourself.
Continue the setup
Related Hermes Agent guides
Blog guide
How to Deploy Hermes Agent on Telegram
Deploy Hermes Agent on Telegram with a guided BotFather token setup, model selection, managed runtime, deployment checks, and practical troubleshooting.
Read nextBlog guide
Why Hermes Agent Is Not Sending or Receiving Messages
Troubleshoot Hermes Agent message failures across Telegram, Discord, and WhatsApp by checking channel access, runtime state, model keys, and logs.
Read nextBlog guide
How to Choose a Hermes Agent Channel
Compare Telegram, Discord, and WhatsApp for Hermes Agent deployment. Choose the best channel for support, daily briefings, and team operations.
Read next