Bot QQ — AI di QQ

Bayangkan grup obrolan favoritmu tiba-tiba punya teman super pintar yang bisa menjawab pertanyaan, merangkum pesan suara, bahkan mengirim balasan dengan format rapi — itulah yang Hermes Agent bawa ke QQ.

Apa Ini?

Hermes Agent adalah kerangka kerja sumber terbuka yang memungkinkan kamu menghubungkan asisten AI ke platform perpesanan. Adaptor QQ Bot adalah jembatan antara Hermes dan API bot resmi QQ. Adaptor ini mendengarkan pesan (obrolan pribadi, sebutan @ di grup, kanal guild) dan merespons secara otomatis — tanpa perlu coding selain pengaturan awal.

Cara Kerjanya (dengan Bahasa Sederhana)

Anggap saja seperti menyiapkan ponsel baru:

1. Dapatkan identitas bot – Kamu mendaftarkan bot di q.qq.com dan menerima App ID serta App Secret (seperti nama pengguna dan kata sandi untuk bot-mu).
2. Sambungkan kabelnya – Hermes membuka koneksi WebSocket yang persisten ke gateway QQ, sehingga pesan langsung terdengar.
3. Ajari dia mendengarkan – Kamu menentukan percakapan mana yang bisa diikutinya: DM pribadi, sebutan di grup, atau kanal guild.
4. Biarkan dia membalas – Saat seseorang mengirim pesan, Hermes memprosesnya dan membalas dengan teks atau markdown kaya.

Pengaturan Langkah demi Langkah

1. Instal dependensi

pip install aiohttp httpx

2. Konfigurasi bot-mu (cara termudah)

hermes gateway setup

Pilih QQ Bot dan ikuti petunjuknya. Kamu akan diminta memasukkan App ID dan Secret.

3. Konfigurasi manual (jika kamu lebih suka)

Buat atau edit ~/.hermes/.env:

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

Itu sudah cukup minimal. Untuk kontrol lebih lanjut, edit ~/.hermes/config.yaml:

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

Fitur Keren: Pesan Suara

QQ memberikan transkripsi gratis (ASR dari Tencent) untuk setiap pesan suara. Jika gagal, Hermes bisa beralih ke penyedia STT kustom seperti GLM-ASR atau OpenAI Whisper. Artinya, bot-mu bisa “mendengar” catatan suara dan membalas dengan ringkasan teks.

Pengaturan Keamanan yang Perlu Kamu Tahu

• QQ_ALLOWED_USERS – batasi DM ke OpenID tertentu (default: semua orang)
• QQ_GROUP_ALLOWED_USERS – batasi akses grup ke OpenID grup tertentu
• dm_policy / group_policy – atur ke "allowlist" untuk kontrol ketat, atau "disabled" untuk mematikan kanal tersebut sepenuhnya

Ringkasan & Tips Praktis

Menghubungkan Hermes ke QQ itu seperti memberi grup obrolanmu asisten pribadi — butuh sekitar 10 menit pengaturan, lalu kamu bisa menyesuaikan semuanya mulai dari siapa yang boleh mengobrol dengannya, hingga apakah dia mendukung markdown atau transkripsi suara.

Tips untuk pemula: Mulailah dengan mode sandbox (atur QQ_PORTAL_HOST=sandbox.q.qq.com). Uji dengan akunmu sendiri dulu, lalu buka secara bertahap untuk teman-teman. Dan selalu atur QQ_ALLOWED_USERS ke OpenID-mu sendiri sebelum go public — kamu tidak ingin orang asing mengobrol dengan bot-mu di hari pertama.

Setelah aktif, coba minta bot-mu merangkum pesan suara yang panjang atau memformat pengumuman singkat — di situlah keajaiban sebenarnya terlihat.