shynloc

shynloc / Hermes-Agent-QQ-Plugin

Public

基于OpenClaw的QQ官方插件改装的适配Hermes Agent的QQ聊天插件，可以用QQ和Hermes Agent沟通了哦。

11
0
100% credibility
Found Apr 12, 2026 at 11 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

A plugin for Hermes Agent that enables AI interactions on the QQ messaging platform via official bot APIs, supporting text, voice, images, and files.

How It Works

1
🔍 Find the QQ Add-on

You discover this simple plugin that lets your Hermes AI assistant chat right inside QQ, the popular messaging app.

2
📱 Create QQ Bot Account

Head to QQ's website to make a free bot account, just like setting up a profile for your AI friend.

3
🔧 Ready Your Computer

Add a free sound tool to your computer so voices play nicely in QQ chats.

4
📥 Add the Plugin

Download one easy file and drop it into your assistant's special folder to unlock QQ powers.

5
🔑 Link Your QQ Bot

Enter your bot's private login details in a settings spot to securely connect everything.

6
⚙️ Turn On QQ

Check a box in your assistant's menu to activate chatting on QQ.

7
🔄 Restart Assistant

Give your AI a quick refresh, and it's ready to go live on QQ.

💬 Chat with AI on QQ!

Now enjoy seamless talks with your smart assistant in QQ private messages, groups, or channels using words, voices, pictures, or files.

Sign up to see the full architecture

6 more

Sign Up Free

Star Growth

See how this repo grew from 11 to 11 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is Hermes-Agent-QQ-Plugin?

This Python plugin bridges Hermes Agent to QQ using the official Bot Open Platform API, letting you chat with your AI agent in QQ DMs, groups (via @mentions), and guilds. It handles text, auto-converted voice messages (OGG/MP3/WAV to SILK), images from URLs or local paths, and arbitrary files, with long messages auto-split. No need for unofficial proxies like NapCat—setup involves a QQ bot account, env vars, and a one-shot install script.

Why is it gaining traction?

It delivers stable, compliant QQ integration without third-party hacks, supporting rich media out of the box via chunked uploads and ffmpeg conversion. The idempotent installer reapplies patches after Hermes updates, and bilingual READMEs cover troubleshooting like quotas and latency. Developers dig the zero-config media handling and cross-platform cron job forwarding to QQ.

Who should use this?

Hermes Agent users in China building AI bots for QQ groups or personal DMs, like team collaborators automating workflows or indie devs prototyping agent-driven support. Python scripters extending Hermes to QQ for voice/image replies in community channels.

Verdict

Grab it if QQ is your frontline—features and docs feel mature despite 11 stars and 1.0% credibility score. Still early; run in a sandbox first, as Hermes patches could break on upstream changes.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.