hermes-weixin-setup

Install and configure the iLink Bot API adapter for WeChat integration.

40|7|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/RongleCat/hermes-wechat --skill hermes-weixin-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hermes-weixin-setup
Source: https://github.com/RongleCat/hermes-wechat/tree/main
Command: npx skills add https://github.com/RongleCat/hermes-wechat --skill hermes-weixin-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill solves the problem of getting an AI agent (Hermes Agent) working with WeChat by installing and wiring a WeChat (iLink Bot API) platform adapter so you can receive and respond to messages.

Core Features & Use Cases

  • End-to-end WeChat adapter installation: guides environment checks, dependency installation, adapter deployment, and Hermes core patching for platform registration.
  • Interactive QR login and configuration: runs QR login, captures account credentials, and writes the needed Hermes config (platforms.weixin, platform_toolsets, home_channel, and .env access policy).
  • Operate-ready connectivity verification: validates the adapter connection by checking gateway logs and confirming inbound/outbound message flow.

Use case: you want Hermes to automatically reply to your WeChat personal account conversations, including handling typical message types and forwarding them into Hermes Gateway once the adapter is connected.

Quick Start

Tell your Hermes Agent: connect and install the WeChat (iLink Bot API) platform adapter, then complete QR login and write the required config so the gateway can restart and verify the connection.

Frequently Asked Questions about hermes-weixin-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect a Hermes Agent to my personal WeChat account?

You connect Hermes to WeChat by installing the iLink Bot API adapter, patching Hermes config routing for WEIXIN, completing interactive QR login, and restarting the gateway to validate inbound and outbound messages.

How does QR login work for WeChat messaging automation?

QR login works by running the iLink Bot API adapter interactively to display a QR code, capturing your account credentials upon scanning, then writing platforms.weixin and home_channel configurations into config.yaml.

Do I need Python to configure the WeChat iLink Bot API adapter?

Yes, you need Python installed because the WeChat iLink Bot API adapter requires dependency installation and copying the adapter implementation into the Hermes runtime environment.

What is the best way to verify WeChat gateway connectivity after setup?

The best way to verify WeChat gateway connectivity is to restart the Hermes gateway, check the gateway logs for errors, and confirm inbound and outbound messages flow correctly through the iLink Bot API adapter.

Can I use this WeChat adapter for personal account message automation?

Yes, the iLink Bot API adapter is suitable for personal WeChat account messaging automation, enabling your Hermes Agent to automatically receive and respond to typical message types.

Why is my Hermes WeChat integration not receiving messages after restart?

Your Hermes WeChat integration may fail to receive messages if platforms.weixin or home_channel is missing in config.yaml, or if the interactive QR login was not completed successfully before restarting the gateway.