Bot di QQ — AI in QQ

Immagina che il tuo gruppo preferito abbia improvvisamente un amico super intelligente in grado di rispondere alle domande, riassumere i messaggi vocali e persino inviare risposte formattate — è esattamente ciò che Hermes Agent porta su QQ.

Di Cosa Si Tratta?

Hermes Agent è un framework open-source che ti permette di collegare assistenti AI a piattaforme di messaggistica. L’adattatore QQ Bot è il ponte tra Hermes e l’API ufficiale dei bot di QQ. Ascolta i messaggi (chat private, menzioni @ nei gruppi, canali delle community) e risponde automaticamente — nessuna competenza di programmazione richiesta oltre alla configurazione iniziale.

Come Funziona (in Parole Semplici)

Pensalo come configurare un nuovo telefono:

1. Ottieni un’identità per il bot – Registri il tuo bot su q.qq.com e ricevi un App ID e un App Secret (come un nome utente e una password per il tuo bot).
2. Collega i fili – Hermes apre una connessione WebSocket persistente al gateway di QQ, così sente i messaggi all’istante.
3. Insegnagli ad ascoltare – Decidi a quali conversazioni può partecipare: messaggi privati, menzioni nei gruppi o canali delle community.
4. Lascialo rispondere – Quando qualcuno invia un messaggio, Hermes lo elabora e risponde con testo o markdown ricco.

Configurazione Passo Dopo Passo

1. Installa le dipendenze

pip install aiohttp httpx

2. Configura il tuo bot (il modo più semplice)

hermes gateway setup

Seleziona QQ Bot e segui le istruzioni. Ti chiederà il tuo App ID e Secret.

3. Configurazione manuale (se preferisci)

Crea o modifica ~/.hermes/.env:

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

Questo è il minimo indispensabile. Per un controllo maggiore, modifica ~/.hermes/config.yaml:

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

Funzionalità Interessante: Messaggi Vocali

QQ ti offre la trascrizione gratuita (ASR di Tencent) per ogni messaggio vocale. Se questa fallisce, Hermes può ripiegare su un provider STT personalizzato come GLM-ASR o OpenAI Whisper. Questo significa che il tuo bot può “sentire” le note vocali e rispondere con riassunti testuali.

Impostazioni di Sicurezza Che Dovresti Conoscere

• QQ_ALLOWED_USERS – limita i messaggi privati a specifici OpenID (predefinito: tutti)
• QQ_GROUP_ALLOWED_USERS – limita l’accesso ai gruppi a specifici OpenID di gruppo
• dm_policy / group_policy – imposta su "allowlist" per un controllo rigoroso, o su "disabled" per disattivare completamente quel canale

Riepilogo e Consiglio Pratico

Collegare Hermes a QQ è come dare al tuo gruppo chat un assistente personale — bastano circa 10 minuti di configurazione, e poi puoi personalizzare tutto, da chi può parlargli, al supporto per markdown o trascrizione vocale.

Il mio consiglio per i principianti: Inizia in modalità sandbox (imposta QQ_PORTAL_HOST=sandbox.q.qq.com). Testa prima con il tuo account, poi apri gradualmente agli amici. E imposta sempre QQ_ALLOWED_USERS con il tuo OpenID prima di andare in produzione — non vuoi che sconosciuti chattino con il tuo bot dal primo giorno.

Una volta attivo, prova a chiedere al tuo bot di riassumere un lungo messaggio vocale o di formattare un annuncio rapido — è lì che la magia si vede davvero.