QQ Бот — ИИ в QQ

Представьте, что в вашем любимом групповом чате внезапно появился суперумный друг, который может отвечать на вопросы, кратко пересказывать голосовые сообщения и даже отправлять красиво оформленные ответы — именно это Hermes Agent привносит в QQ.

Что это такое?

Hermes Agent — это фреймворк с открытым исходным кодом, который позволяет подключать AI-ассистентов к мессенджерам. Адаптер QQ Bot — это мост между Hermes и официальным API ботов QQ. Он слушает сообщения (личные чаты, упоминания через @ в группах, каналы гильдий) и отвечает автоматически — никакого кодинга, кроме настройки, не требуется.

Как это работает (простыми словами)

Представьте, что вы настраиваете новый телефон:

1. Получите личность бота – Регистрируете своего бота на q.qq.com и получаете App ID и App Secret (что-то вроде логина и пароля для вашего бота).
2. Подключите провода – Hermes открывает постоянное WebSocket-соединение со шлюзом QQ, поэтому слышит сообщения мгновенно.
3. Научите его слушать – Вы решаете, в каких беседах он может участвовать: личные сообщения, упоминания в группах или каналы гильдий.
4. Позвольте ему отвечать – Когда кто-то отправляет сообщение, Hermes обрабатывает его и отвечает текстом или расширенным markdown.

Пошаговая настройка

1. Установите зависимости

pip install aiohttp httpx

2. Настройте бота (самый простой способ)

hermes gateway setup

Выберите QQ Bot и следуйте подсказкам. Он запросит ваш App ID и Secret.

3. Ручная настройка (если предпочитаете)

Создайте или отредактируйте ~/.hermes/.env:

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

Это минимум. Для большего контроля отредактируйте ~/.hermes/config.yaml:

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

Классная фича: голосовые сообщения

QQ предоставляет бесплатную транскрипцию (ASR от Tencent) для каждого голосового сообщения. Если она не сработает, Hermes может переключиться на сторонний STT-провайдер, например GLM-ASR или OpenAI Whisper. Это значит, что ваш бот сможет «слышать» голосовые заметки и отвечать текстовыми сводками.

Настройки безопасности, которые стоит знать

• QQ_ALLOWED_USERS – ограничивает личные сообщения конкретными OpenID (по умолчанию: все)
• QQ_GROUP_ALLOWED_USERS – ограничивает доступ в группах конкретными OpenID групп
• dm_policy / group_policy – установите "allowlist" для строгого контроля или "disabled", чтобы полностью отключить этот канал

Итоги и практический совет

Подключение Hermes к QQ — это как подарить вашему групповому чату личного ассистента: настройка занимает около 10 минут, а затем вы можете настроить всё — от того, кто может с ним общаться, до поддержки markdown или транскрипции голоса.

Мой совет новичкам: Начните в песочнице (установите QQ_PORTAL_HOST=sandbox.q.qq.com). Сначала протестируйте на своём аккаунте, а затем постепенно открывайте доступ друзьям. И всегда устанавливайте QQ_ALLOWED_USERS на свой собственный OpenID перед публичным запуском — вам не нужны незнакомцы, общающиеся с вашим ботом в первый же день.

Как только он заработает, попробуйте попросить бота кратко пересказать длинное голосовое сообщение или оформить быстрое объявление — вот где проявляется настоящая магия.