QQ-Bot – KI in QQ

Stell dir vor, dein Lieblingsgruppenchat bekommt plötzlich einen superklugen Freund, der Fragen beantworten, Sprachnachrichten zusammenfassen und sogar formatierte Antworten senden kann – genau das bringt Hermes Agent in QQ.

Was ist das?

Hermes Agent ist ein Open-Source-Framework, mit dem du KI-Assistenten an Messaging-Plattformen anbinden kannst. Der QQ-Bot-Adapter ist die Brücke zwischen Hermes und der offiziellen Bot-API von QQ. Er lauscht auf Nachrichten (private Chats, Gruppen-@-Erwähnungen, Server-Kanäle) und antwortet automatisch – außer der Einrichtung ist kein Programmieren nötig.

Wie es funktioniert (einfach erklärt)

Stell es dir vor wie das Einrichten eines neuen Telefons:

1. Bot-Identität besorgen – Du registrierst deinen Bot unter q.qq.com und erhältst eine App-ID und ein App-Secret (wie Benutzername und Passwort für deinen Bot).
2. Die Verbindung herstellen – Hermes öffnet eine dauerhafte WebSocket-Verbindung zum QQ-Gateway, damit es Nachrichten sofort hört.
3. Ihm das Zuhören beibringen – Du entscheidest, an welchen Gesprächen er teilnehmen darf: private DMs, Gruppen-Erwähnungen oder Server-Kanäle.
4. Ihn antworten lassen – Wenn jemand eine Nachricht sendet, verarbeitet Hermes sie und antwortet mit Text oder umfangreichem Markdown.

Schritt-für-Schritt-Einrichtung

1. Abhängigkeiten installieren

pip install aiohttp httpx

2. Bot konfigurieren (einfachster Weg)

hermes gateway setup

Wähle QQ Bot aus und folge den Anweisungen. Du wirst nach deiner App-ID und deinem Secret gefragt.

3. Manuelle Konfiguration (wenn du es lieber selbst machst)

Erstelle oder bearbeite ~/.hermes/.env:

QQ_APP_ID=deine-app-id
QQ_CLIENT_SECRET=dein-app-secret

Das ist das Minimum. Für mehr Kontrolle bearbeite ~/.hermes/config.yaml:

platforms:
  qqbot:
    enabled: true
    extra:
      markdown_support: true
      dm_policy: "open"   # open | allowlist | disabled
      group_policy: "open"

Coole Funktion: Sprachnachrichten

QQ bietet dir für jede Sprachnachricht eine kostenlose Transkription (Tencent-ASR). Falls das fehlschlägt, kann Hermes auf einen eigenen STT-Anbieter wie GLM-ASR oder OpenAI Whisper zurückgreifen. Das bedeutet, dein Bot kann Sprachnachrichten „hören“ und mit Textzusammenfassungen antworten.

Sicherheitseinstellungen, die du kennen solltest

• QQ_ALLOWED_USERS – schränkt DMs auf bestimmte OpenIDs ein (Standard: alle)
• QQ_GROUP_ALLOWED_USERS – schränkt den Gruppen-Zugriff auf bestimmte Gruppen-OpenIDs ein
• dm_policy / group_policy – setze auf "allowlist" für strikte Kontrolle oder "disabled", um den Kanal komplett zu deaktivieren

Zusammenfassung & praktischer Tipp

Hermes mit QQ zu verbinden ist, als würdest du deinem Gruppenchat einen persönlichen Assistenten geben – die Einrichtung dauert etwa 10 Minuten, und danach kannst du alles anpassen, von der Frage, wer mit ihm sprechen darf, bis hin zu Markdown-Unterstützung oder Sprachtranskription.

Mein Tipp für Anfänger: Starte im Sandbox-Modus (setze QQ_PORTAL_HOST=sandbox.q.qq.com). Teste zuerst mit deinem eigenen Account und öffne es dann nach und nach für Freunde. Und setze QQ_ALLOWED_USERS immer auf deine eigene OpenID, bevor du live gehst – du willst nicht, dass Fremde am ersten Tag mit deinem Bot chatten.

Sobald es läuft, versuch doch mal, deinen Bot eine lange Sprachnachricht zusammenfassen oder eine schnelle Ankündigung formatieren zu lassen – da zeigt sich die Magie wirklich.

---