Hermes Telegram setup
Connect Hermes Agent to Telegram with a QR code
Create and connect a Telegram bot to your self-hosted Hermes Agent using ClawKickstart’s guided QR setup, with manual BotFather setup still available.
Your Hermes agent can meet you in Telegram without you copying a bot token into the dashboard. For a new Hermes instance, ClawKickstart can guide you through Telegram Login, a QR code, and creating a bot in Telegram. You can still choose the manual BotFather route if you prefer.
What you need before you start
- A ClawKickstart account and a provisioned, running Hermes instance that has not yet been set up.
- A Telegram account and access to Telegram on your phone or this device.
- A model provider, a model reference, and an API key if your chosen provider requires one.
The QR option is for the first setup of a Hermes instance when it is enabled in ClawKickstart. OpenClaw and an already configured Hermes instance use the manual Telegram setup path in the dashboard. The model provider and VPS may have their own charges.
1. Choose your Hermes instance and provider
Once your server is running, open the dashboard and select it in Agent Setup. Choose your model provider and model, and enter the provider API key when required. You can also choose a personality before connecting. Keep the dashboard open: you will return to it after creating the Telegram bot.
2. Link Telegram and open the QR code
In the Telegram section, choose Connect with Telegram. If you have not linked your Telegram account to ClawKickstart, you will first be sent to Telegram Login. Approve the request using the account that will own and use the bot, return to the dashboard, and start the connection again if needed.
Scan the QR code with Telegram on your phone, or use Open Telegram on this device. The code opens the ClawKickstart manager bot. Press Start in that chat, then choose Create bot when the manager sends the button. Use the same Telegram account you linked in the previous step. A QR code expires after five minutes; start again in the dashboard if it expires.
3. Create and confirm your bot
Telegram asks you to choose a display name and an available username for your new bot. Finish the creation in Telegram, then return to ClawKickstart. The dashboard shows the bot username and ID for you to review.
Confirm only a bot you recognize and own. Check both confirmations: that you own the bot and that you understand the ClawKickstart manager can access its token. Select Connect this bot to apply the configuration. You do not need to copy the token yourself, but the token still exists and the manager can access it.
4. Wait for setup and test a reply
Keep the dashboard open while the connection is applied. Once it reports that Telegram configuration was applied and the gateway is healthy, open your newly created bot—not the manager bot—in Telegram. Press Start if prompted and send a short message. A healthy gateway alone does not prove that the model or Telegram reply works; wait for a response from your agent.
Change your model in Telegram
The model you choose in Agent Setup is your starting point. After Hermes is running, send /model to your Hermes bot in Telegram to browse and select models from your configured provider. For example, with an OpenAI API key you can choose from OpenAI models available to your account. Availability and charges depend on the provider and account. To configure a different provider or its credentials, use Agent Setup in the dashboard.
Prefer the manual BotFather route?
Manual setup remains available. Choose Use manual setup instead in Agent Setup, create a bot through BotFather, and enter its token along with your personal numeric Telegram user ID. For Hermes, that ID identifies the account allowed to use the bot; it is not the bot ID, username, or phone number. Keep your token private.
If something does not work
- QR expired: start a new connection in the dashboard and scan the new code.
- No Create bot button: make sure you used the linked Telegram account and pressed Start from the fresh QR link. If the button still does not arrive, contact ClawKickstart support.
- Bot does not appear in the dashboard: return to Agent Setup, wait for the bot details, and confirm only the bot you created. Restart setup or use the manual path if it cannot be identified.
- No reply after setup: confirm you are messaging the new bot, check the provider details, and run Diagnostics or review Recent activity in the dashboard.
- Setup result could not be verified: check the server before retrying; follow the dashboard guidance or contact support.
QR setup saves the token-copying step while keeping the decision to create and confirm the bot in your hands. If manual setup suits you better, the original BotFather path remains available.