Deploy Hermes Agent on WhatsApp — Build Your Personal 24/7 AI Assistant
1. Introduction: Why Choose Hermes Agent?
Hermes Agent is an open-source autonomous AI Agent project developed by Nous Research, widely regarded as a strong challenger to OpenClaw. Unlike traditional chatbots, Hermes features "procedural memory" and "autonomous skill evolution" capabilities. It not only remembers your preferences but also automatically distills execution experience into reusable "Skill Cards" after completing complex tasks.
By deploying Hermes to WhatsApp, you can command the AI to perform web scraping, data analysis, or automation tasks anytime, anywhere from your mobile device. Compared to other platforms, WhatsApp integration offers exceptional real-time responsiveness and convenience.
2. Pre-Deployment Preparation
Before starting the deployment, ensure your environment meets the following requirements:
- Server Environment: A Lighthouse server instance.
- WhatsApp Account: A phone number ready for QR code login.
Installing Hermes Agent on Tencent Cloud Lighthouse
Option 1: Purchase a New Lighthouse Server
Go to the Tencent Cloud Lighthouse purchase page to purchase a server. The recommended configuration is as follows:
- Image: Hermes Agent
- Region: Choose based on your use case. For connecting to overseas platforms such as Discord, select an overseas region (e.g., Hong Kong, China). If you need to call domestic models (e.g., Kimi, MiniMax, GLM by Zhipu), a mainland China region is recommended.
- Plan Configuration: 2 vCPUs / 4 GB RAM or higher is recommended. The minimum supported configuration is 2 vCPUs / 2 GB RAM (suitable for basic testing).
Click Buy Now, follow the on-screen instructions to complete payment, and wait approximately 30 seconds for the server to be created.
Option 2: Reinstall an Existing Lighthouse Server
Warning: Reinstalling the system will erase all data on the server. Proceed with caution!
If you already have an idle Lighthouse instance, you can select the Hermes Agent image via the "Reinstall System" option, then follow the subsequent steps to configure Hermes Agent.
3. Deployment Mode Selection
The Hermes Agent WhatsApp gateway supports two operating modes. Choose based on your use case:
| Mode | Description | Recommended Scenario |
|---|---|---|
| Bot Mode | Uses a dedicated number (e.g., WhatsApp Business). Supports multiple users with low risk of account suspension. | Long-term use, team collaboration |
| Self-Chat Mode | Uses your personal account. Interact with the Agent by sending messages to yourself. | Quick testing, personal private use |
4. Step-by-Step Deployment Guide
4.1 Launch the Gateway Setup Wizard
Run the following commands in the terminal to enter the interactive configuration interface:
su lighthouse
hermes gateway setup
If the system indicates that the gateway service is installed but not running, enter y to start the service.
4.2 Select Messaging Platform and Mode
In the platform selection list that appears, enter the number 6 to select WhatsApp. The system will then ask you to choose a mode. It is recommended to start with Separate bot number for a more stable experience; however, if you only have one phone number, select Personal Number and define it for personal use only. This tutorial follows the Personal Number path.
4.3 Permission Configuration
For security purposes, you need to specify which numbers can access your Agent:
- Enter a specific phone number (with country code, without the
+sign, e.g.,86138...). - Or enter
*to allow anyone to send commands to the Bot.
Enter your phone number, paying attention to the format: for example, if your number is+86 133XXX, enter86133XXXhere.
4.4 QR Code Pairing
The system will generate a QR code in the terminal. Open WhatsApp on your phone, go to "Linked Devices", tap "Link a Device", and scan the QR code displayed in the terminal. Once pairing is successful, the terminal will show a configured + paired status.
After scanning, the following screen will appear. Simply press Enter to continue.
4.5 Install as a System Service
To ensure the Agent runs continuously in the background, it is recommended to install it as a systemd service:
Select Y.
| Your Goal | Recommended Choice |
|---|---|
| Writing articles / AI project demos / Quick setup | User service |
| Enterprise-grade long-term operation | System service |
| Just trying it out temporarily | Skip |
Start the service now, select Yes.
5. Verification and Maintenance
5.1 Verify the Interaction
Open WhatsApp and send a message (e.g., "Hi") to your Bot account. If you receive a reply with the "Hermes Agent" header, the deployment was successful.
6. Risk Warnings and Security Recommendations
Since Hermes uses a built-in bridge based on Baileys (which emulates WhatsApp Web) rather than the official Business API, please keep the following in mind:
- Account Suspension Risk: Avoid using the Bot account to mass-send spam messages or engage in high-frequency harassment.
- Security Approval: When the Agent attempts to execute potentially dangerous commands involving network downloads, a warning will pop up in WhatsApp. Be sure to manually confirm by entering
/approve session[4].
Related Guides:
- Want to integrate high-performance models like Xiaomi MiMo V2 Pro? See Integrating Xiaomi MiMo V2 Pro Model.
- After deployment, how to leverage side-project scraping? See Hands-On Demo — Automated Side-Project Information Filtering System.
Join Our Discord Community!
Scan the QR code to join the user discussion group
🚀 Tencent Cloud Developer Community & Support
1️⃣ Tencent Cloud Developer Community
Unlock more advanced use cases on Discord
2️⃣ Dedicated Service Support
Join via WhatsApp / WeCom for exclusive technical support
| Channel | Scan / Click to Join |
|---|---|
| WhatsApp Channel |
|
| WeCom |
|