QQ Bot Setup Guide: Connect Hermes Agent to QQ Official Bot
Overview
QQ Bot is an official bot platform provided by Tencent. Hermes Agent supports conversational interactions with users through QQ Official Bot. Compared to WeChat, QQ Bot uses official APIs, making it secure, stable, and ban-free.
Estimated setup time: 5-10 minutes
Required information:
- QQ Bot Secret
Advantages of QQ Bot
Compared to WeChat
| Feature | QQ Bot | |
|---|---|---|
| Rich text messages | ✅ Supported | ❌ Not supported |
| Ban risk | ✅ None (official API) | ⚠️ Risky |
| Online status | ✅ Clearly visible | ❌ Not obvious |
| Setup complexity | Low-Medium | Low |
Compared to Feishu
| Feature | QQ Bot | Feishu |
|---|---|---|
| Message translation | ❌ Not supported | ✅ Supported |
| Emoji reactions | ❌ Not supported | ✅ Supported |
| Interactive cards | ❌ Not supported | ✅ Supported |
| Group chat bot | ❌ Not supported | ✅ Supported |
Step 1: Create a QQ Bot
1.1 Access QQ Bot Open Platform
- Open QQ Bot Open Platform
- Log in with your QQ account
- Complete developer verification if required
1.2 Create a Bot
- In the console, click "Create Bot"
- Fill in the bot information:
- Bot Name: Enter an identifiable name, e.g., "Hermes AI Assistant"
- Bot Description: Brief description of the bot's purpose
- Bot Avatar: Upload an avatar (optional)
- Complete creation
1.3 Get Bot Secret
After creation, go to the bot details page:
- Find the "Secret" or "Bot Secret" section
- Copy the bot secret
Save this secret securely - you'll need it for configuration.
Step 2: Configure Hermes Gateway
2.1 Open Hermes Service Manager
Log in to your Hermes Service Manager web interface.
2.2 Configure QQ Bot
- Switch to the "Environment" or "Config" tab
- Find the QQ bot configuration fields
- Enter your bot secret
- Save configuration
The gateway will restart automatically.
Step 3: Pairing Verification
3.1 First Message Triggers Verification
When you send your first message to the QQ bot, Hermes will trigger a security verification process.
3.2 Execute Pairing Command
The bot will reply with a message containing a pairing command, similar to:
hermes pairing approve qqbot xxxxx
You need to execute this command on your Hermes server to complete pairing:
- Log in to Hermes Service Manager
- Switch to the "Terminal" tab
- Enter and execute the complete command from the bot's reply
3.3 Verification Complete
Once the command executes successfully, you can chat with your QQ bot normally!
FAQ
Q: Why do I need to execute a pairing command?
A: This is Hermes Agent's security mechanism to verify the legitimacy of message sources. Only paired users can chat with the bot, preventing unauthorized access.
Q: What if the pairing command fails?
A: Please check:
- Was the command copied completely (including all parameters)?
- Are you executing it on the correct terminal (Hermes server)?
- Is the Hermes service running normally?
Q: Can I use QQ bot in group chats?
A: Currently, QQ bot does not support group chat functionality. It can only be used in private chats. If you need group chat features, consider using Feishu platform.
Q: What if there's no reply after sending a message?
A: Please check:
- Has pairing verification been completed?
- Is Hermes Gateway running normally?
- Is the LLM API configured correctly?
Next Steps
After configuration, you can:
- Start chatting: Find your bot in QQ and send messages to start chatting
- Install skills: Use
hermes skill installto install various useful skills - Switch models: Switch between different AI models as needed
If you have any questions, please contact our technical support.