Hermes WeChat Integration Tutorial: Connect Your Personal WeChat in 5 Minutes (Native Hermes Agent Support) ​

Hermes Agent now natively supports personal WeChat! No public IP, no complex configuration — just scan a QR code with WeChat to bind. Private chats, group chats, images, videos, files, and voice messages are all supported, with direct long-polling connections for an ultra-smooth experience.

If you've been searching Hermes WeChat integration, this beginner-friendly tutorial is built for fast onboarding — the whole process takes under 5 minutes. Whether you want Hermes to look up information, set reminders, organize group chats, or send daily pushes, you can do it all easily.

Table of Contents ​

• Prerequisites
• Step 1: Update & Install Dependencies
• Step 2: Configure the WeChat Gateway Interactively
• Step 3: Authorization Settings (DMs & Group Chats)
• Step 4: Restart the Gateway and Bind
• FAQ
• What You Can Do After Integrating Hermes with WeChat

Prerequisites

• Hermes Agent already installed (if not, see the Hermes official docs for installation)
• Python 3.10 or higher
• A personal WeChat account that can log in normally (not WeChat Work / Enterprise WeChat)

Step 1: Update & Install Dependencies

# 安装必要 Python 包
pip install aiohttp cryptography

# 可选：终端二维码展示（强烈建议安装）
pip install qrcode

# 更新 Hermes 到最新版本（支持微信的关键）
hermes update

Step 2: Configure the WeChat Gateway Interactively

Interactive terminal configuration is recommended — it's the simplest:

hermes gateway setup

1. Select Weixin / WeChat
2. Enter Y to confirm
3. Hermes will automatically request the iLink Bot API and generate a WeChat binding QR code

Scan it with the WeChat mobile app to add (instant response).

Step 3: Authorization Settings (DMs & Group Chats)

After configuration, you'll set your authorization policy:

DM Authorization (Recommended) ​

• DM Pairing Approval (strongly recommended): strangers' first DM needs manual approval; already-approved contacts pass through automatically. Safe and practical — ideal for most personal users.
• Open: anyone's DMs are accepted automatically (for fully public scenarios).
• Disable: turns off DMs entirely.

Group Chat Authorization (Recommended) ​

• Keep Disable by default to avoid spam from unrelated group messages.
• You can manually enable specific work/study groups in Hermes later.

Step 4: Restart the Gateway and Bind

After saving your authorization settings, restart the gateway:

hermes gateway restart

Once it restarts successfully:

1. Find Hermes in WeChat and send any message
2. Hermes replies with an authorization code
3. Enter the code in your terminal to complete the binding (or just send /whitelist in WeChat to auto-add yourself to the whitelist)

FAQ

Q: Nothing happens after I scan the QR code?
A: Check that your phone's network is fine, then rerun hermes gateway setup to generate a new QR code.

Q: The QR code expired?
A: The terminal will notify you when it expires. Just rerun hermes gateway setup to refresh it.

Q: The gateway fails to restart?
A: First run hermes gateway status to check. If there's a port conflict, change the port in the config file.

Q: I'm not receiving WeChat messages?
A: Check your authorization settings — whether DMs are set to Disable, or whether that group chat isn't enabled separately.

What You Can Do After Integrating Hermes with WeChat

• Personal DM assistant: ask Hermes anytime to look things up, write summaries, translate, or generate ideas
• Group chat assistant: add it to work/project groups to auto-summarize meeting points and extract action items
• Automated pushes: with scheduled tasks, get daily weather, schedules, RSS digests, stock alerts, and more
• Multimedia processing: send images, voice messages, and files directly to Hermes for analysis and processing

Integrating Hermes with WeChat dramatically lowers the barrier, letting an AI assistant truly fit into everyday communication.

Happy Hacking 🎉

If you run into any other issues during Hermes WeChat integration, feel free to leave a comment — I'll keep this tutorial updated.
Follow along for more practical Hermes tips!