Bot QQ — IA dans QQ

Imaginez que votre groupe de discussion préféré accueille soudainement un ami super intelligent, capable de répondre aux questions, de résumer des messages vocaux et même d’envoyer des réponses formatées — c’est exactement ce que Hermes Agent apporte à QQ.

Qu’est-ce que c’est ?

Hermes Agent est un framework open-source qui permet de connecter des assistants IA à des plateformes de messagerie. L’adaptateur QQ Bot est le pont entre Hermes et l’API officielle des bots QQ. Il écoute les messages (conversations privées, mentions @ en groupe, canaux de guilde) et répond automatiquement — aucune compétence en programmation requise au-delà de la configuration.

Comment ça marche (en termes simples)

Pensez-y comme à la configuration d’un nouveau téléphone :

1. Obtenez une identité de bot – Vous enregistrez votre bot sur q.qq.com et recevez un App ID et un App Secret (comme un nom d’utilisateur et un mot de passe pour votre bot).
2. Branchez les câbles – Hermes ouvre une connexion WebSocket persistante vers la passerelle QQ, afin d’entendre les messages instantanément.
3. Apprenez-lui à écouter – Vous décidez à quelles conversations il peut participer : messages privés, mentions en groupe ou canaux de guilde.
4. Laissez-le répondre – Lorsque quelqu’un envoie un message, Hermes le traite et répond avec du texte ou du markdown enrichi.

Configuration étape par étape

1. Installez les dépendances

pip install aiohttp httpx

2. Configurez votre bot (le plus simple)

hermes gateway setup

Sélectionnez QQ Bot et suivez les instructions. On vous demandera votre App ID et votre Secret.

3. Configuration manuelle (si vous préférez)

Créez ou modifiez ~/.hermes/.env :

QQ_APP_ID=your-app-id
QQ_CLIENT_SECRET=your-app-secret

C’est le minimum requis. Pour plus de contrôle, modifiez ~/.hermes/config.yaml :

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

Fonctionnalité sympa : les messages vocaux

QQ vous offre une transcription gratuite (ASR de Tencent) pour chaque message vocal. Si cela échoue, Hermes peut basculer vers un fournisseur STT personnalisé comme GLM-ASR ou OpenAI Whisper. Cela signifie que votre bot peut « entendre » les notes vocales et répondre avec des résumés textuels.

Paramètres de sécurité à connaître

• QQ_ALLOWED_USERS – restreint les messages privés à des OpenID spécifiques (par défaut : tout le monde)
• QQ_GROUP_ALLOWED_USERS – restreint l’accès aux groupes à des OpenID de groupe spécifiques
• dm_policy / group_policy – définissez sur "allowlist" pour un contrôle strict, ou "disabled" pour désactiver complètement ce canal

Résumé et conseil pratique

Connecter Hermes à QQ, c’est comme offrir un assistant personnel à votre groupe de discussion — la configuration prend environ 10 minutes, puis vous pouvez tout personnaliser, de qui peut lui parler à la prise en charge du markdown ou de la transcription vocale.

Mon conseil pour les débutants : Commencez en mode sandbox (définissez QQ_PORTAL_HOST=sandbox.q.qq.com). Testez d’abord avec votre propre compte, puis ouvrez progressivement à vos amis. Et définissez toujours QQ_ALLOWED_USERS sur votre propre OpenID avant de passer en public — vous ne voulez pas que des inconnus discutent avec votre bot dès le premier jour.

Une fois en ligne, essayez de demander à votre bot de résumer un long message vocal ou de formater une annonce rapide — c’est là que la magie opère vraiment.