QQ Bot — IA en QQ

Imagina que tu grupo de chat favorito de repente tiene un amigo superinteligente que puede responder preguntas, resumir mensajes de voz e incluso enviar respuestas con formato elegante — eso es exactamente lo que Hermes Agent trae a QQ.

¿Qué es esto?

Hermes Agent es un framework de código abierto que te permite conectar asistentes de IA a plataformas de mensajería. El adaptador de QQ Bot es el puente entre Hermes y la API oficial de bots de QQ. Escucha mensajes (chats privados, menciones con @ en grupos, canales de servidores) y responde automáticamente — sin necesidad de programar más allá de la configuración inicial.

Cómo funciona (en términos sencillos)

Piénsalo como configurar un teléfono nuevo:

1. Obtén una identidad de bot – Registras tu bot en q.qq.com y recibes un App ID y un App Secret (como un nombre de usuario y contraseña para tu bot).
2. Conecta los cables – Hermes abre una conexión WebSocket persistente con la pasarela de QQ, así que escucha los mensajes al instante.
3. Enséñale a escuchar – Tú decides en qué conversaciones puede participar: mensajes directos privados, menciones en grupos o canales de servidores.
4. Déjalo responder – Cuando alguien envía un mensaje, Hermes lo procesa y responde con texto o markdown enriquecido.

Configuración paso a paso

1. Instala las dependencias

pip install aiohttp httpx

2. Configura tu bot (la forma más fácil)

hermes gateway setup

Selecciona QQ Bot y sigue las instrucciones. Te pedirá tu App ID y tu Secret.

3. Configuración manual (si lo prefieres)

Crea o edita ~/.hermes/.env:

QQ_APP_ID=tu-app-id
QQ_CLIENT_SECRET=tu-app-secret

Eso es lo mínimo. Para tener más control, edita ~/.hermes/config.yaml:

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

Función genial: Mensajes de voz

QQ te ofrece transcripción gratuita (ASR de Tencent) para cada mensaje de voz. Si eso falla, Hermes puede recurrir a un proveedor de STT personalizado como GLM-ASR o OpenAI Whisper. Esto significa que tu bot puede “escuchar” notas de voz y responder con resúmenes de texto.

Ajustes de seguridad que deberías conocer

• QQ_ALLOWED_USERS – restringe los mensajes directos a OpenIDs específicos (por defecto: todos)
• QQ_GROUP_ALLOWED_USERS – restringe el acceso a grupos a OpenIDs de grupo específicos
• dm_policy / group_policy – configúralos como "allowlist" para un control estricto, o "disabled" para desactivar ese canal por completo

Resumen y consejo práctico

Conectar Hermes a QQ es como darle a tu grupo de chat un asistente personal — te toma unos 10 minutos de configuración, y luego puedes personalizar todo, desde quién puede hablar con él hasta si soporta markdown o transcripción de voz.

Mi consejo para principiantes: Empieza en modo sandbox (configura QQ_PORTAL_HOST=sandbox.q.qq.com). Prueba primero con tu propia cuenta y luego ábrelo gradualmente a tus amigos. Y siempre configura QQ_ALLOWED_USERS con tu propio OpenID antes de hacerlo público — no querrás que extraños hablen con tu bot desde el primer día.

Una vez que esté en vivo, prueba a pedirle a tu bot que resuma un mensaje de voz largo o que formatee un anuncio rápido — ahí es donde la magia realmente se nota.

---