(Complete Guide with Telegram, Discord & E-Mail Setup)
Author: Pavol Labuda (aclassickoder)
ā±ļø Time Required: 15 minutes š What You Need: Tencent Cloud account + LLM API key ā Final Result: 24/7 running Hermes Agent with Telegram/Discord/Email access
Nous Research officially released the open-source Hermes Agent in April 2026, a true Autonomous AI Agent that stands out from IDE-bound coding assistants or single-API chatbots. Unlike traditional chatbots that only respond to direct prompts, Hermes Agent operates independently on your server with persistent memory and a complete self-learning loop. It autonomously creates new skills, improves existing ones through use, and retains memories across sessions -- truly becoming "smarter the more you use it."
Key capabilities include:
hermes claw migrate command for one-click migration of all OpenClaw settings, memories, skills, and API keys -- making the transition seamless for existing OpenClaw users.š Critical Deployment Note: Hermes Agent requires full system permissions (terminal execution, file read/write, browser automation, etc.) to deliver its full capabilities. For maximum security, deploy it in an isolated environment separate from your personal main computer. It officially supports Linux (most recommended), macOS, WSL2, and Android (Termux) -- native Windows is not supported (Windows users must install WSL2 first).
Tencent Cloud Lighthouse is the ideal platform for running Hermes Agent. It's a lightweight, cost-effective cloud server designed specifically for developers, startups, and small businesses -- no complex cloud computing knowledge required.
Key advantages for Hermes Agent deployment:
š” Exclusive Offer: Purchase your Lighthouse instance through my referral link to unlock double voucher rewards and additional discounts on top of the already low prices! š Get Tencent Cloud Lighthouse with Exclusive Rewards
To deploy Hermes Agent on Tencent Cloud Lighthouse, ensure you meet these requirements:
Component Specification
Operating System Ubuntu Server 24.04 LTS 64-bit (pre-installed with the
Hermes Agent template)
Memory Minimum 2GB RAM (4GB recommended for smooth
performance with multiple tools)
Disk Space At least 30GB SSD (sufficient for Hermes Agent, logs,
and cached data)
LLM API Key Valid API key for an LLM provider (e.g., DeepSeek --
ensure account balance > 0)
š” Pro Tip: For the best experience, I recommend the LH 2C4G Linux plan. It provides the perfect balance of performance and cost for running Hermes Agent with all core features enabled. You can purchase this plan directly through my exclusive link here: š Deploy Hermes Agent on LH 2C4G Linux Now By using this link, you'll receive double voucher rewards that can be used for future renewals or additional services!
Avoid the hassle of manual setup by using Tencent Cloud's official pre-built Hermes Agent application template. This method automatically installs all required dependencies, Docker, and the latest version of Hermes Agent -- so you can focus on using your AI agent instead of configuring servers.
š” Important: Using the link above ensures you receive the maximum available discounts and double voucher rewards on your purchase. These vouchers can be applied to future renewals or used to upgrade your instance later.
Step-by-Step Screenshots:
Figure 1: Tencent Cloud Lighthouse main console showing your account overview and instance management options
Figure 2: Application template selection page highlighting the official Hermes Agent template
Figure 3: Blue "Create Instance" button to start provisioning your Hermes Agent server
\ Figure 4: Final confirmation screen showing Hermes Agent template details before deployment
Hermes Agent does not include a built-in AI model -- it requires connecting to an external large language model (LLM) to power its intelligence. This section uses DeepSeek as the example provider due to its excellent performance, low cost, and reliable API.
ubuntu (Hermes Agent is pre-installed under this user account)Step-by-Step Screenshots:
Figure 5: Instance card showing the "Login" button to access the web terminal
Figure 6: OrcaTerm login settings with pre-configured password-free access for the ubuntu user
Figure 7: Fully functional OrcaTerm terminal ready for Hermes Agent configuration commands
sk-api-. Copy this key immediately and save it in a secure location -- you will not be able to view the complete key again after closing the page.Step-by-Step Screenshots:
Figure 8: DeepSeek API keys page highlighting the "Create new API key" button
Figure 8.1: DeepSeek API keys page highlighting the "Create new API key" button
Figure 9: Critical one-time view of your generated DeepSeek API key -- copy it immediately
hermes setup to Configure the LLMIn the server terminal, launch the interactive configuration wizard by running:
hermes setup
Use the up and down arrow keys to navigate the menu and select: Quick setup ā provider, model & messaging (recommended) Press Enter to confirm.
Figure 10: Hermes setup wizard showing the recommended Quick Setup option
Scroll through the list of supported model service providers and select DeepSeek. Press Enter to confirm.
Figure 11: Complete list of supported LLM providers with DeepSeek selected as the active option
When prompted with DeepSeek API key:, paste the API key you copied earlier. You can paste using Ctrl+Shift+V or by right-clicking in the terminal window.
š Security Note: For security reasons, no characters (including asterisks) will be displayed on the screen when entering the API key. Simply paste the key and press Enter.
You will see the confirmation message:
API Key Saved.
Press Enter to confirm the default Base URL (no changes are needed for DeepSeek).
Figure 12: Base URL configuration screen showing the default DeepSeek API endpoint
The wizard will display a list of models supported by DeepSeek:
Select default model:
-> deepseek-v4-flash <- currently in use
deepseek-chat
deepseek-reasoner
deepseek-v4-pro
Enter custom model name
Skip (keep current)
Use the arrow keys to select deepseek-v4-flash (recommended for its excellent balance of speed, performance, and cost) and press Enter.
Confirmation:
ā Default model set to: deepseek-v4-flash
Figure 13: Model selection screen highlighting the recommended deepseek-v4-flash model
When asked if you want to connect a messaging platform, select: Skip ā set up later with 'hermes setup gateway' Press Enter to complete the initial setup wizard.
To verify that the LLM connection is working correctly:
Launch hermes chat now? [Y/n]:, enter Y and press Enter.If everything is working, you're ready to connect messaging platforms and start using your Hermes Agent from anywhere!
Figure 14: Hermes Agent's interactive text-based chat interface showing successful LLM connection
After setup, you may see a summary of enabled and disabled tools:
ā Tool Availability Summary
6/11 tool categories available:
ā Vision (image analysis)
ā Mixture of Agents (missing OPENROUTER_API_KEY)
ā Web Search & Extract (missing EXA_API_KEY, PARALLEL_API_KEY, FIRECRAWL_API_KEY/FIRECRAWL_API_URL, or TAVILY_API_KEY)
ā Browser Automation (Local browser)
ā Image Generation (missing FAL_KEY or OPENAI_API_KEY)
ā Text-to-Speech (Edge TTS)
ā RL Training (Tinker) (missing TINKER_API_KEY)
ā Skills Hub (GitHub) (missing GITHUB_TOKEN)
ā Terminal/Commands
ā Task Planning (todo)
ā Skills (view, create, edit)
To enable additional tools, run:
hermes setup tools # Interactive tool configuration wizard
Or edit the configuration files directly:
nano /home/ubuntu/.hermes/.env # Store API keys here
nano /home/ubuntu/.hermes/config.yaml # Core Hermes configuration
The real power of Hermes Agent comes from being able to interact with it from anywhere using your favorite messaging apps. To connect platforms, run the gateway setup wizard:
hermes setup gateway
The wizard will display a list of all supported messaging platforms:
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
ā ā Hermes Setup ā Messaging Platforms (Gateway) ā
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
ā Messaging Platforms
Connect to messaging platforms to chat with Hermes from anywhere.
Toggle with Space, confirm with Enter.
Select platforms to configure:
Toggle by number, Enter to confirm.
[ā] 1. š± Telegram (configured)
[ā] 2. š¬ Discord (configured)
[ ] 3. š¼ Slack (not configured)
[ ] 4. š Matrix (not configured)
[ ] 5. š¬ Mattermost (not configured)
[ ] 6. š² WhatsApp (enabled, not paired)
[ ] 7. š” Signal (not configured)
[ ] 8. š§ Email (not configured)
[ ] 9. š± SMS (Twilio) (not configured)
[ ] 10. š¬ DingTalk (not configured)
[ ] 11. šŖ½ Feishu / Lark (not configured)
[ ] 12. š¬ WeCom (Enterprise WeChat) (not configured)
[ ] 13. š¬ WeCom Callback (Self-Built App) (not configured)
[ ] 14. š¬ Weixin / WeChat (not configured)
[ ] 15. š¬ BlueBubbles (iMessage) (not configured)
[ ] 16. š§ QQ Bot (not configured)
[ ] 17. š Yuanbao (not configured)
[ ] 18. š¬ IRC (not configured)
[ ] 19. š¼ Microsoft Teams (not configured)
Toggle # (or Enter to confirm):
Figure 15: Complete list of 19 supported messaging platforms available for integration
Telegram is the most stable, reliable, and easiest platform to integrate with Hermes Agent. It offers excellent performance, low latency, and full support for all Hermes features including file uploads, image analysis, and voice messages.
@BotFather./start to launch the BotFather interface./newbot to create a new bot:
bot (e.g., my_hermes_ai_bot).
Figure 16: Step-by-step 6-panel guide showing the entire Telegram bot creation process
hermes setup gateway menu in your server terminal.1 to select Telegram and press Enter.@my_hermes_ai_bot)./start to initiate the conversation./new to create a new chat thread with fresh context.
Figure 17: Successful test conversation showing Hermes Agent responding in Telegram
Discord is an excellent platform for using Hermes Agent with teams or communities. It supports slash commands, thread-based conversations, and direct messages.
Step-by-Step Screenshots:
Figure 18: Discord Developer Portal homepage highlighting the "New Application" button
Figure 19: Popup window for entering your Discord bot application name
Figure 20: General Information page where you can upload a custom bot avatar
Figure 21: Image editor for cropping and adjusting your bot's avatar
bot and applications.commands.bot, a Permissions section will appear. Check the following permissions:
Figure 22: Installation tab showing default permission settings
Figure 23: Fully configured permissions list showing all required permissions for Hermes Agent
For Hermes to read messages and interact with users properly, you need to enable privileged gateway intents:
Figure 24: Critical Privileged Gateway Intents section showing all three intents enabled
š CRITICAL SECURITY WARNING: Treat this token like a master password. Never share it with anyone, and paste it into your Hermes configuration immediately. If your token is compromised, anyone can take control of your bot.
Figure 25: Bot tab highlighting the "Reset Token" button to generate your authentication key
Figure 26: Warning popup confirming that resetting the token will invalidate the old one
Figure 27: Generated bot token screen with the "Copy" button to save your key
Step-by-Step Screenshots:
Figure 28: Installation tab showing the generated bot invite link
Figure 29: Authorization screen where you select which server to add the bot to
Figure 30: Final authorization screen showing all permissions the bot will receive
Figure 31: Success screen with the option to add the bot to your personal apps
Figure 32: Final confirmation that the bot has been successfully added to your account
hermes setup gateway menu in your server terminal.2 to select Discord and press Enter.#hermes) and type / to see Hermes' slash commands./new to start a new session -- Hermes will reply with "⨠New session started!"./ may reveal specific administrative commands (like /agents or /branch).Step-by-Step Screenshots:
Figure 33: Discord chat showing the available slash commands for Hermes Agent
Figure 34: Successful test conversation showing Hermes Agent responding in a Discord channel
Figure 35: Bot profile card showing the "Message" button to start a direct message
Figure 36: Successful test conversation showing Hermes Agent responding in a direct message
For easier bot development:
Deploying Hermes Agent as an email entity allows you to interact with it using standard email protocols, making it accessible from any device with an email client -- no additional apps required. This is especially useful for asynchronous communication and long-running tasks.
ā ļø Important Domain Note: All examples below use my personal domain
aclassickoder.tkfor demonstration purposes. You must replaceaclassickoder.tkwith your own actual domain name when following this guide. Do not use my domain for your deployment.
bot.aclassickoder.tk -- replace with your own domain), configure the following DNS records with your email provider:
hermes@bot.aclassickoder.tk). > š Security Warning: Never bind Hermes to your personal email inbox. The agent requires unrestricted IMAP read access to parse emails, which would expose all your personal emails to the agent.
Figure 37: Email creation form showing the setup of a dedicated hermes@bot.aclassickoder.tk mailbox
In the server terminal, run:
hermes setup gateway
Enter 8 to select Email from the platform list and press Enter.
Figure 38: Gateway setup menu showing Email selected as the platform to configure
The wizard will prompt you to enter the following information:
hermes@bot.aclassickoder.tk -- replace with your own).imap.gmail.com for Gmail).smtp.gmail.com for Gmail).Y and press Enter.
Figure 39: Email configuration screen showing all credentials entered and saved successfully
Since we enabled Zero-Trust mode, you need to securely pair your personal email address with Hermes:
hermes@bot.aclassickoder.tk).69RVKU5P).sh hermes pairing approve email 69RVKU5P (Replace 69RVKU5P with the actual token you received.)Approved! User... on email can now use the bot.
Figure 40: Automated email from Hermes containing the unique pairing token for authorization
In-Reply-To and References) to maintain conversation context.
Figure 41: Test email composed and ready to send to the Hermes Agent email address
Figure 42: Successful reply from Hermes Agent showing the email integration is working
Email is a stateless protocol. To ensure Hermes can send you proactive notifications (e.g., results from background tasks, Cron jobs, or alerts), you need to set your email as the "home channel":
/sethome.
Figure 43: System message explaining the home channel feature and how to enable it
Join the growing Hermes Agent community to access advanced tips, share skills, get help with troubleshooting, and stay updated on the latest developments:
The official community for both OpenClaw and Hermes Agent users. Here you'll find:
For direct technical support, join these channels:
Platform Join Link/QR Code

Task Command
Run full setup wizard hermes setup
Reconfigure LLM model hermes setup model
Connect messaging platforms hermes setup gateway
Enable/disable tools hermes setup tools
View current configuration hermes config
Edit config in default editor hermes config edit
Set specific config value hermes config set <key> <value>
Start command-line chat hermes
Start messaging gateway hermes gateway
Diagnose system issues hermes doctor
Approve email pairing hermes pairing approve email <TOKEN>
hermes claw migrateFor best performance, use the LH 2C4G Linux plan on Tencent Cloud Lighthouse. You can get this plan with exclusive discounts and double voucher rewards here: š Get LH 2C4G Linux with Exclusive Rewards
If you experience slow responses, try switching to a faster LLM model like deepseek-v4-flash.
Regularly clean up old session logs to free up disk space:
rm -rf ~/.hermes/sessions/*
For long-running tasks, use the /background command to run them in the background without blocking the chat.
Check that the gateway is running:
hermes gateway
Verify your API key is valid and has a positive balance\
Run hermes doctor to diagnose system issues
hermes setup tools to configure additional tool providers~/.hermes/.env and restart Hermes/sethome commandsystemd or screen.š” Last Reminder: If you haven't purchased your Lighthouse instance yet, use my exclusive link to get the best possible price and double voucher rewards: š Deploy Your Hermes Agent on Tencent Cloud Lighthouse Now
Enjoy your self-evolving AI agent that gets smarter every day! š