QQ Bot — IA no QQ

Imagine seu grupo de bate-papo favorito de repente ganhar um amigo superinteligente que consegue responder perguntas, resumir mensagens de voz e até enviar respostas formatadas — é exatamente isso que o Hermes Agent traz para o QQ.

O Que É Isso?

O Hermes Agent é um framework de código aberto que permite conectar assistentes de IA a plataformas de mensagens. O adaptador QQ Bot é a ponte entre o Hermes e a API oficial de bots do QQ. Ele escuta mensagens (conversas privadas, menções com @ em grupos, canais de guildas) e responde automaticamente — sem necessidade de programação além da configuração inicial.

Como Funciona (em Termos Simples)

Pense nisso como configurar um novo telefone:

1. Obtenha uma identidade de bot – Você registra seu bot em q.qq.com e recebe um App ID e um App Secret (como um nome de usuário e senha para o seu bot).
2. Conecte os fios – O Hermes abre uma conexão WebSocket persistente com o gateway do QQ, então ele ouve as mensagens instantaneamente.
3. Ensine-o a ouvir – Você decide em quais conversas ele pode participar: mensagens diretas privadas, menções em grupos ou canais de guildas.
4. Deixe-o responder – Quando alguém envia uma mensagem, o Hermes a processa e responde com texto ou markdown rico.

Configuração Passo a Passo

1. Instale as dependências

pip install aiohttp httpx

2. Configure seu bot (do jeito mais fácil)

hermes gateway setup

Selecione QQ Bot e siga as instruções. Ele vai pedir seu App ID e Secret.

3. Configuração manual (se preferir)

Crie ou edite o arquivo ~/.hermes/.env:

QQ_APP_ID=seu-app-id
QQ_CLIENT_SECRET=seu-app-secret

Isso é o mínimo. Para mais controle, edite ~/.hermes/config.yaml:

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

Recurso Legal: Mensagens de Voz

O QQ oferece transcrição gratuita (ASR da Tencent) para cada mensagem de voz. Se isso falhar, o Hermes pode recorrer a um provedor de STT personalizado, como GLM-ASR ou OpenAI Whisper. Isso significa que seu bot pode “ouvir” notas de voz e responder com resumos em texto.

Configurações de Segurança Que Você Deve Conhecer

• QQ_ALLOWED_USERS – restringe mensagens diretas a OpenIDs específicos (padrão: todos)
• QQ_GROUP_ALLOWED_USERS – restringe o acesso a grupos para OpenIDs de grupo específicos
• dm_policy / group_policy – defina como "allowlist" para controle rigoroso, ou "disabled" para desligar esse canal completamente

Resumo e Dica Prática

Conectar o Hermes ao QQ é como dar um assistente pessoal ao seu grupo de bate-papo — leva cerca de 10 minutos para configurar, e depois você pode personalizar tudo, desde quem pode falar com ele até se ele suporta markdown ou transcrição de voz.

Minha dica para iniciantes: Comece no modo sandbox (defina QQ_PORTAL_HOST=sandbox.q.qq.com). Teste primeiro com sua própria conta e, gradualmente, abra para os amigos. E sempre defina QQ_ALLOWED_USERS com seu próprio OpenID antes de tornar público — você não quer estranhos conversando com seu bot logo no primeiro dia.

Depois que estiver no ar, tente pedir ao seu bot para resumir uma mensagem de voz longa ou formatar um anúncio rápido — é aí que a mágica realmente aparece.

---