Technology Encyclopedia Home >Deploy & Use Hermes Agent on Tencent Cloud Lighthouse

Deploy & Use Hermes Agent on Tencent Cloud Lighthouse

(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

Table of Contents

  1. Introduction to Hermes Agent
  2. Why Deploy on Tencent Cloud Lighthouse?
  3. Prerequisites
  4. Deploy Hermes Agent via App Template (Easy Method)
  5. Configure Hermes Agent (LLM Setup with DeepSeek)
  6. Integrate Messaging Platforms
  7. Developer Community & Support
  8. Final Tips & Troubleshooting

1. Introduction to Hermes Agent

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:

  • Persistent Memory & Closed-Loop Learning: Runs 24/7 on your server, remembers past interactions, and continuously improves its performance without manual intervention.
  • OpenClaw Compatibility: Built-in 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.
  • Cross-Platform Integration: Seamlessly connects to Telegram, Discord, Slack, WhatsApp, Email, Microsoft Teams, and 10+ other messaging platforms.
  • LLM Flexibility: Supports over 200 large language models (LLMs) from all major providers, giving you complete control over your AI "brain."
  • Full System Automation: Enables natural language automation of complex tasks (from scheduling to web scraping to terminal commands) with just simple text instructions.
  • Extensible Tool Ecosystem: Comes with 11 built-in tool categories including vision analysis, browser automation, terminal access, text-to-speech, and more.

šŸ”’ 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).


2. Why Deploy on Tencent Cloud Lighthouse?

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:

  • Instant Deployment: Get your Hermes Agent up and running in under 5 minutes using the official pre-built application template -- no manual Docker installation or dependency configuration needed.
  • Unbeatable Affordability: Start with plans as low as a few dollars per month, with flexible configurations to match your performance needs.
  • 24/7 Uptime: Run Hermes Agent continuously without worrying about power outages, internet disconnections, or keeping your personal computer on 24/7.
  • Secure Isolation: The cloud environment is fully isolated from your local machine, protecting your personal data even if Hermes executes potentially risky commands.
  • Global Region Coverage: Choose from multiple overseas regions (including Singapore, Silicon Valley, and Frankfurt) for reliable connectivity to Discord, WhatsApp, and other international platforms.
  • Simplified Management: Intuitive web console with built-in terminal access (OrcaTerm), one-click backups, and easy scaling as your needs grow.

šŸ’” 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


3. Prerequisites

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)

Tencent Cloud Active account with payment method configured
Account

šŸ’” 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!


4. Deploy Hermes Agent via App Template (Easy Method)

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.

Step 1: Purchase Your Lighthouse Instance

  1. Go to the Tencent Cloud Lighthouse Promo Page to access exclusive discounts and double voucher rewards.
  2. Log in to your Tencent Cloud account (or create a new one if you don't have one).
  3. Browse the available Lighthouse plans and select the one that best fits your needs (LH 2C4G Linux is recommended).
  4. Choose your preferred region (select Singapore or another overseas region if you plan to use Discord or WhatsApp frequently).
  5. Complete the payment process.

šŸ’” 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 2: Create the Hermes Agent Instance

  1. After purchasing, you'll be redirected to the Tencent Cloud Lighthouse Console.
  2. Click Create Instance.
  3. Under Application Creation Method, select Application template.
  4. Scroll through the template list and find Hermes Agent (it will be clearly labeled with the official Hermes logo).
  5. Confirm your region and server bundle (the one you purchased earlier).
  6. Click Create Instance and wait approximately 30 seconds for the server to boot up and initialize the Hermes Agent environment.

Step-by-Step Screenshots: Tencent Cloud Lighthouse Console Overview - Hermes Agent Deployment Figure 1: Tencent Cloud Lighthouse main console showing your account overview and instance management options

Hermes Agent Application Template Selection Screen Figure 2: Application template selection page highlighting the official Hermes Agent template

Create Instance Button in Lighthouse Console Figure 3: Blue "Create Instance" button to start provisioning your Hermes Agent server

Hermes Agent Template Preview and Configuration\ Figure 4: Final confirmation screen showing Hermes Agent template details before deployment


5. Configure Hermes Agent (LLM Setup with DeepSeek)

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.

Step 1: Log In to the Lighthouse Server

  1. In the Tencent Cloud Console, find your newly created Hermes Agent instance in the instance list.
  2. Click the Login button on the instance card.
  3. The browser will automatically redirect to OrcaTerm, Tencent Cloud's built-in web terminal tool.
  4. Configure the login settings in the popup window:
    • Protocol: Select Password-free Login
    • Username: Change to ubuntu (Hermes Agent is pre-installed under this user account)
  5. Click Log in to access the server terminal.

Step-by-Step Screenshots: Login Button on Hermes Agent Instance Card Figure 5: Instance card showing the "Login" button to access the web terminal

OrcaTerm Web Terminal Login Configuration Window Figure 6: OrcaTerm login settings with pre-configured password-free access for the ubuntu user

OrcaTerm Terminal Interface After Successful Login Figure 7: Fully functional OrcaTerm terminal ready for Hermes Agent configuration commands

Step 2: Obtain a DeepSeek API Key

  1. Go to the DeepSeek Platform and log in or register for a new account.
  2. Navigate to the API Keys section.
  3. Click Create API Key and enter a descriptive name for the key (e.g., "Hermes Agent").
  4. The system will generate a key string starting with 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.
  5. Verify that your DeepSeek account has a positive balance. If the balance is zero, Hermes Agent will not be able to call the model even if the API key is configured correctly. You can check and recharge your balance in the DeepSeek Billing Center.

Step-by-Step Screenshots: Create New API Key Button in DeepSeek Platform Figure 8: DeepSeek API keys page highlighting the "Create new API key" button

Create New API Key Button in DeepSeek Platform Figure 8.1: DeepSeek API keys page highlighting the "Create new API key" button

DeepSeek API Key Copy Prompt - One-Time View Figure 9: Critical one-time view of your generated DeepSeek API key -- copy it immediately

Step 3: Run hermes setup to Configure the LLM

In the server terminal, launch the interactive configuration wizard by running:

hermes setup

Step 3.1: Select Quick Setup

Use the up and down arrow keys to navigate the menu and select: Quick setup — provider, model & messaging (recommended) Press Enter to confirm.

Hermes Agent Setup Wizard Main Menu Figure 10: Hermes setup wizard showing the recommended Quick Setup option

Step 3.2: Select LLM Provider

Scroll through the list of supported model service providers and select DeepSeek. Press Enter to confirm.

LLM Provider Selection Menu - DeepSeek Highlighted Figure 11: Complete list of supported LLM providers with DeepSeek selected as the active option

Step 3.3: Enter DeepSeek API Key

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).

DeepSeek Base URL Confirmation Screen Figure 12: Base URL configuration screen showing the default DeepSeek API endpoint

Step 3.4: Select Default Model

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

DeepSeek Model Selection Menu - deepseek-v4-flash Recommended Figure 13: Model selection screen highlighting the recommended deepseek-v4-flash model

Step 3.5: Skip Messaging Platform Setup (For Now)

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.

Step 4: Verify LLM Configuration

To verify that the LLM connection is working correctly:

  1. When prompted Launch hermes chat now? [Y/n]:, enter Y and press Enter.
  2. The Hermes command-line chat interface (TUI) will launch.
  3. Send a test message (e.g., "Hi, introduce yourself") and confirm that Hermes responds correctly.

If everything is working, you're ready to connect messaging platforms and start using your Hermes Agent from anywhere!

Hermes Agent TUI Command-Line Chat Interface Figure 14: Hermes Agent's interactive text-based chat interface showing successful LLM connection

Tool Availability Notes

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

6. Integrate Messaging Platforms

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):

Hermes Agent Messaging Gateway Setup Menu Figure 15: Complete list of 19 supported messaging platforms available for integration


6.1 Telegram (Recommended)

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.

Step 1: Create a Telegram Bot

  1. Open the Telegram app and use the search bar to find @BotFather.
  2. Send /start to launch the BotFather interface.
  3. Send /newbot to create a new bot:
    • Enter a name for your bot (e.g., "My Hermes Assistant").
    • Enter a username for your bot. This must end with the word bot (e.g., my_hermes_ai_bot).
  4. BotFather will generate an HTTP API Token for your bot. Copy this token and keep it secure -- it's the authentication key that allows Hermes to control the bot.

Complete Telegram Bot Creation Process with @BotFather Figure 16: Step-by-step 6-panel guide showing the entire Telegram bot creation process

Step 2: Configure Telegram in Hermes

  1. Return to the hermes setup gateway menu in your server terminal.
  2. Enter 1 to select Telegram and press Enter.
  3. When prompted, paste the API token you copied from BotFather.
  4. The wizard will save the token and automatically start the Telegram gateway.

Step 3: Test the Telegram Bot

  1. In Telegram, search for your bot using the username you created (e.g., @my_hermes_ai_bot).
  2. Send /start to initiate the conversation.
  3. Send /new to create a new chat thread with fresh context.
  4. Send a test message (e.g., "Hi, what can you do?") -- Hermes should reply within a few seconds.

Telegram Chat Test with Working Hermes Agent Bot Figure 17: Successful test conversation showing Hermes Agent responding in Telegram


6.2 Discord

Discord is an excellent platform for using Hermes Agent with teams or communities. It supports slash commands, thread-based conversations, and direct messages.


Phase 1: Create a Discord Application & Bot

  1. Log in to the Discord Developer Portal using your Discord account.
  2. Click the New Application button in the top-right corner.
  3. Enter "Hermes" as the application name and click Create.

Step-by-Step Screenshots: New Application Button in Discord Developer Portal Figure 18: Discord Developer Portal homepage highlighting the "New Application" button

Discord Application Creation Window - Name Your Bot Figure 19: Popup window for entering your Discord bot application name

Step 1: Customize the Bot (Optional)
  1. In the General Information tab, you can upload an avatar for your bot (e.g., the official Hermes logo).
  2. Click Save Changes to apply your changes.

Discord Application General Information Tab Figure 20: General Information page where you can upload a custom bot avatar

Discord Bot Avatar Upload and Crop Editor Figure 21: Image editor for cropping and adjusting your bot's avatar

Step 2: Configure Installation & Permissions
  1. Go to the Installation tab in the left-hand menu:
    • Under Installation Contexts, check both User Install and Guild Install.
    • Under Guild Install, select the scopes: bot and applications.commands.
    • After selecting bot, a Permissions section will appear. Check the following permissions:
      • Add Reactions
      • Embed Links
      • Read Message History
      • Send Messages
      • Send Messages in Threads
      • Send TTS Messages
      • Send Voice Messages
      • Use Application Commands
      • View Channels
  2. Click Save Changes at the bottom of the page.

Discord Application Installation Tab - Permissions Configuration Figure 22: Installation tab showing default permission settings

Complete Discord Bot Permissions Configuration Figure 23: Fully configured permissions list showing all required permissions for Hermes Agent

Step 3: Enable Privileged Gateway Intents

For Hermes to read messages and interact with users properly, you need to enable privileged gateway intents:

  1. Go to the Bot tab in the left-hand menu.
  2. Scroll down to the Privileged Gateway Intents section.
  3. Toggle the following intents to the ON position (they will turn blue):
  • Presence Intent
  • Server Members Intent
  • Message Content Intent (this is critical for reading chat messages)
  1. Save your changes if prompted.

Discord Bot Privileged Gateway Intents - All Enabled Figure 24: Critical Privileged Gateway Intents section showing all three intents enabled

Step 4: Generate the Bot Token
  1. In the Bot tab, scroll to the top and click the Reset Token button.
  2. Confirm the action by clicking "Yes, do it!" in the warning popup.
  3. If you have 2FA enabled on your Discord account, you will be prompted to enter your authentication code.
  4. A new token will be generated. Click the Copy button to copy it to your clipboard.

šŸ”’ 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.

Reset Token Button in Discord Bot Tab Figure 25: Bot tab highlighting the "Reset Token" button to generate your authentication key

Token Reset Confirmation Popup Warning Figure 26: Warning popup confirming that resetting the token will invalidate the old one

Copy New Discord Bot Token Button Figure 27: Generated bot token screen with the "Copy" button to save your key


Phase 2: Invite the Bot to Your Discord Server

  1. Return to the Installation tab in the Discord Developer Portal.
  2. Under the Install Link section, copy the generated URL.
  3. Paste this link into any Discord channel and click it.
  4. A Discord authorization popup will appear. Under "Add to server:", select the server you want to add the bot to.
  5. Click Continue, then Authorize.
  6. Complete the human verification Captcha if prompted.
  7. You will see a "Success!" screen. Hermes is now in your server!
  8. To add Hermes Agent Discord bot to your personal apps for easy access:
  9. Click Add to My Apps on the success screen.
  10. You will see a second "Success!" screen confirming Hermes has been added to your account apps.

Step-by-Step Screenshots: Discord Bot Install Link Copy Figure 28: Installation tab showing the generated bot invite link

Select Server Dropdown in Discord Authorization Screen Figure 29: Authorization screen where you select which server to add the bot to

Discord Bot Permissions Authorization Screen Figure 30: Final authorization screen showing all permissions the bot will receive

Add to My Apps Button on Success Screen Figure 31: Success screen with the option to add the bot to your personal apps

App Added Successfully Confirmation Screen Figure 32: Final confirmation that the bot has been successfully added to your account


Phase 3: Configure Discord in Hermes & Test

  1. Return to the hermes setup gateway menu in your server terminal.
  2. Enter 2 to select Discord and press Enter.
  3. Paste the bot token you copied from the Discord Developer Portal.
  4. The wizard will save the token and start the Discord gateway.
  5. In your Discord server, go to a channel (e.g., #hermes) and type / to see Hermes' slash commands.
  6. Select /new to start a new session -- Hermes will reply with "✨ New session started!".
  7. Send a test message (e.g., "Hi") to confirm the bot responds correctly.
Step 9: Test Direct Messages (DMs)
  1. Click on Hermes' profile picture in the server to open its profile card.
  2. Type a message in the "Message @Hermes" box to send a DM.
  3. āš ļø Important: The first time you DM the bot, Discord's anti-spam system might interrupt with a "Wait! Are you human?" pop-up. Check the Captcha box to proceed.
  4. Once verified, Hermes will reply to you in a private DM thread. In DMs, typing / may reveal specific administrative commands (like /agents or /branch).

Step-by-Step Screenshots: Discord Slash Commands Test - /new Command Figure 33: Discord chat showing the available slash commands for Hermes Agent

Discord Channel Chat Test - Full Conversation Figure 34: Successful test conversation showing Hermes Agent responding in a Discord channel

Hermes Bot Profile Card with Message Button Figure 35: Bot profile card showing the "Message" button to start a direct message

Discord Direct Message (DM) Test Conversation Figure 36: Successful test conversation showing Hermes Agent responding in a direct message

Bonus: Enable Discord Developer Mode

For easier bot development:

  1. Open Discord → click User Settings (bottom-left).
  2. Go to Advanced → toggle Developer Mode ON.
  3. Right-click users/channels/servers to copy their IDs (useful for custom code).

6.3 Email (IMAP/SMTP)

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.tk for demonstration purposes. You must replace aclassickoder.tk with your own actual domain name when following this guide. Do not use my domain for your deployment.

Phase 1: Prepare the Email Infrastructure

  1. DNS Configuration: If using a custom domain (e.g., bot.aclassickoder.tk -- replace with your own domain), configure the following DNS records with your email provider:
    • MX records pointing to your email provider's receiving servers.
    • SPF, DKIM, and DMARC TXT records to prevent outgoing emails from being marked as spam.
  2. Create a Dedicated Mailbox: Create a brand new, separate inbox specifically for Hermes Agent (e.g., 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.
  3. Enable Protocols: Verify that IMAP (typically port 993/SSL) and SMTP (typically port 587/STARTTLS) are enabled for the dedicated mailbox.

Dedicated Email Mailbox Creation for Hermes Agent Figure 37: Email creation form showing the setup of a dedicated hermes@bot.aclassickoder.tk mailbox

Phase 2: Configure the Email Gateway

  1. In the server terminal, run:

    hermes setup gateway
    
  2. Enter 8 to select Email from the platform list and press Enter.

Email Platform Selection in Hermes Gateway Setup Figure 38: Gateway setup menu showing Email selected as the platform to configure

Phase 3: Enter Email Credentials

The wizard will prompt you to enter the following information:

  1. Email address: The dedicated Hermes email address you created (e.g., hermes@bot.aclassickoder.tk -- replace with your own).
  2. Email password: The password for the email account. If your provider uses OAuth2 or 2FA, you must generate and use an app-specific password here.
  3. IMAP host: Your email provider's IMAP server address (e.g., imap.gmail.com for Gmail).
  4. SMTP host: Your email provider's SMTP server address (e.g., smtp.gmail.com for Gmail).
  5. Allowed sender emails: Leave this blank and press Enter to enable Zero-Trust DM Pairing Mode. This ensures that only explicitly authorized users can interact with your Hermes Agent.
  6. When prompted to restart the gateway, enter Y and press Enter.

Email Credential Configuration Wizard - Complete Setup Figure 39: Email configuration screen showing all credentials entered and saved successfully

Phase 4: Complete the Zero-Trust Pairing Handshake

Since we enabled Zero-Trust mode, you need to securely pair your personal email address with Hermes:

  1. Open your personal email client and send a test email (e.g., "Hi!") to the Hermes email address (e.g., hermes@bot.aclassickoder.tk).
  2. Hermes will intercept the email, recognize that your address is not authorized, and send an automated reply containing a unique pairing token (e.g., 69RVKU5P).
  3. Return to the server terminal and run: sh hermes pairing approve email 69RVKU5P (Replace 69RVKU5P with the actual token you received.)
  4. You will see the confirmation: Approved! User... on email can now use the bot.

Automated Pairing Token Request Email from Hermes Figure 40: Automated email from Hermes containing the unique pairing token for authorization

Phase 5: Test Email Integration

  1. Reply to the pairing email thread with a prompt (e.g., "Hi, how are you? What can you do?").
  2. Hermes will parse the email headers (In-Reply-To and References) to maintain conversation context.
  3. After processing your request, Hermes will send a reply directly to the email thread.

Test Email Prompt Sent to Hermes Agent Figure 41: Test email composed and ready to send to the Hermes Agent email address

Successful Hermes Agent Email Reply Figure 42: Successful reply from Hermes Agent showing the email integration is working

Phase 6: Set a Home Channel for Asynchronous Notifications

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":

  1. After your first successful email exchange, Hermes will automatically send a system message: > šŸ“­ No home channel is set for Email. A home channel is where Hermes delivers cron job results and cross-platform messages. > Type /sethome to make this chat your home channel, or ignore to skip.
  2. Reply to this email thread with the exact command: /sethome.
  3. Hermes will permanently register your email address as the default destination for all asynchronous outputs.

Home Channel Warning Message from Hermes Agent Figure 43: System message explaining the home channel feature and how to enable it


7. Developer Community & Support

Join the growing Hermes Agent community to access advanced tips, share skills, get help with troubleshooting, and stay updated on the latest developments:

7.1 OpenClaw Developer Discord

The official community for both OpenClaw and Hermes Agent users. Here you'll find:

  • The latest plugin templates and custom skills
  • Advanced deployment guides and best practices
  • Direct support from developers and experienced users
  • Early access to new features and updates

7.2 Dedicated Support Channels

For direct technical support, join these channels:


Platform Join Link/QR Code


Discord Discord Community QR Code
Community


8. Final Tips & Troubleshooting

Key Hermes CLI Commands (Quick Reference)


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>

Migrate from OpenClaw hermes claw migrate

Performance Optimization Tips

  • For 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.

Troubleshooting Common Issues

  1. Hermes doesn't respond to messages:
    • 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

  2. Discord bot doesn't read messages:
    • Ensure you enabled Message Content Intent in the Discord Developer Portal
    • Verify the bot has the correct permissions in your server
  3. Email integration not working:
    • Check that IMAP and SMTP are enabled on your email account
    • Verify your DNS records (SPF/DKIM/DMARC) are configured correctly
    • Ensure you completed the Zero-Trust pairing process
  4. Tools are disabled:
    • Run hermes setup tools to configure additional tool providers
    • Add the required API keys to ~/.hermes/.env and restart Hermes
  5. Missing asynchronous notifications:
    • Ensure you set a home channel for your messaging platform using the /sethome command
    • Verify the gateway service is running continuously

Final Notes

  • Always keep your API keys and bot tokens secure. Never share them publicly or commit them to version control.
  • To ensure 24/7 uptime, run the Hermes gateway as a background service using systemd or screen.
  • Regularly check for Hermes Agent updates to access new features, performance improvements, and security patches.
  • If you need to upgrade your Lighthouse instance later, you can do so with just a few clicks in the Tencent Cloud Console -- and remember to use your exclusive vouchers from the initial purchase!

šŸ’” 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! šŸš€