skills.rest
chujianyun
chujianyunCOMMUNITY
Explore all skills by this author →
GitHub

hermes-qq

Patches Hermes Agent main branch to add QQ Bot platform support with file sending.

733|99|Updated Dec 19, 2025
Search Tags:#websocket#code patching#qq bot#file sending#platform adapter#Hermes agent#tencent qq
One-click install
npx skills add https://github.com/chujianyun/skills --skill hermes-qq
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hermes-qq
Source: https://github.com/chujianyun/skills/tree/main/skills/operations/hermes-qq
Command: npx skills add https://github.com/chujianyun/skills --skill hermes-qq

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires aiohttp, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

The official Hermes Agent main branch does not ship with QQ platform support, so users who want their agent to receive and reply to QQ messages must manually wire in an adapter, config entries, toolsets, and media delivery logic. This Skill automates that entire patching process against a hermes-agent repository.

Core Features & Use Cases

  • Automated Code Patching: Runs scripts/install_hermes_qq.py to inject the QQ platform enum, environment variable config (QQ_APP_ID, QQ_APP_SECRET, allowlists), adapter registration, and the hermes-qq toolset into the target repository.
  • Full QQ Adapter: Copies a complete QQ Bot adapter (assets/qq.py) implementing Tencent QQ Open Platform WebSocket gateway, access token refresh, C2C and group message handling, and chunked media upload for images, audio, video, and documents.
  • Extended File Delivery: Extends MEDIA tag parsing and local file extraction to support document extensions like .pdf, .docx, .xlsx, .csv, and .zip, with failure notifications when sends fail.
  • Use Case: You have a hermes-agent deployment on the main branch and want it to answer QQ private and group messages and send files back. Run the installer script, then execute the verification steps in references/verification.md to confirm the patch.

Quick Start

Ask the agent to install QQ platform support into the current hermes-agent repository by running the hermes-qq installer script and then executing the targeted pytest verification suite.

Frequently Asked Questions about hermes-qq

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

FAQPage Schema
How do I add QQ Bot support to Hermes Agent?▼

Run the install_hermes_qq.py script against your hermes-agent repository root. It copies the QQ adapter into gateway/platforms/qq.py and patches config.py, run.py, tools_config.py, and toolsets.py to register the QQ platform and hermes-qq toolset.

What credentials does the QQ Bot adapter need?▼

The adapter requires a QQ app_id and app_secret from the Tencent QQ Open Platform, supplied via the QQ_APP_ID and QQ_APP_SECRET environment variables. Optional variables include QQ_ALLOWED_USERS, QQ_ALLOWED_GROUPS, QQ_AT_REQUIRED, and QQ_MARKDOWN_SUPPORT.

Does the QQ adapter support sending files and images?▼

Yes, the adapter implements chunked media upload for images, video, voice, and general files using the QQ media API. The patch also extends MEDIA tag parsing to recognize document extensions like .pdf, .docx, .xlsx, .csv, and .zip.

What happens if the installer script cannot find a patch anchor?▼

The script raises an error indicating the target repository has diverged from the official main branch. In that case you should read references/verification.md and manually review the differences before applying changes, rather than forcing the patch.

How do I verify the QQ platform installation worked?▼

Run python -m py_compile on the patched files, then execute the targeted pytest suite covering platform base, local file extraction, image sending, scheduler, and background command tests. A smoke test importing QQAdapter and Platform.QQ is also provided in references/verification.md.

Related Skills

Explore More Software Engineering Skills→
NebulaMaoNebulaMao
13

add-qq

Integrate QQ bot communication into NanoClaw via the QQ Open Platform WebSocket.

Community
Intermediate
wuv-dreamguidewuv-dreamguide

qqbot-channel

Automate QQ channel administration via qqbot_channel_api proxy with token authentication.

Official
Intermediate
rafael-faerafael-fae
5

hermes-whatsapp-native

Configure a native WhatsApp bridge for Hermes Agent with pairing and routing.

Community
Advanced
CAPHTECHCAPHTECH
1

eld-model-link-map

Manage Law-to-Term cross-reference links and detect orphaned artifacts.

Official
Advanced