Kanal QQ
Ringkasan
QQ mendukung otorisasi QR dan pengikatan manual App ID / Secret. Pilih Bot tujuan lalu buka kartu kanal QQ. Ikuti dialog QR untuk otorisasi; hanya pengikatan manual yang memerlukan pembuatan bot di QQ Open Platform dan kredensialnya. Setelah terhubung, uji pesan. QQ berbagi persona dan memori jangka panjang dengan kanal lain pada Bot yang sama.
Yang dibahas di halaman ini
-
Mendaftar dan membuat bot di QQ Open Platform
-
Mendapatkan AppID dan AppSecret
-
Memasukkan kredensial tersebut ke LightVela untuk menyelesaikan integrasi
-
Mengobrol dengan Hermes Agent di QQ
Langkah-langkah
1. Masuk ke konsol
Masuk ke LightVela, pilih Bot yang dituju, lalu buka Sehari-hari â Kanal di konsol.
2. Pilih kanal QQ
Pilih + Hubungkan pada kartu QQ. Pilih koneksi QR dan Berikutnya, lalu izinkan melalui QQ ponsel. Jika memilih pengikatan App ID / Secret, lanjutkan langkah platform dan kredensial di bawah. Setelah otorisasi QR berhasil, langsung ke verifikasi pesan.

3. Daftar di QQ Open Platform
Kunjungi QQ Open Platform lalu pindai kode QR di halaman tersebut memakai aplikasi QQ di ponsel untuk mendaftar / masuk. Pada kunjungan pertama, pemindaian akan otomatis mendaftarkan dan mengikat akun QQ saat ini ke akun Open Platform.
Setelah memindai di aplikasi QQ ponsel dan memilih Agree, pendaftaran selesai dan Anda akan masuk ke halaman konfigurasi bot QQ.
4. Buat bot QQ
Di halaman daftar bot pada QQ Open Platform, klik "Create Bot" untuk membuat bot QQ baru.

5. Dapatkan AppID dan AppSecret
Setelah bot dibuat, temukan AppID dan AppSecret di halaman tersebut. Klik tombol "Copy" di sebelah masing-masing lalu simpan ke file catatan lokal.

Setelah dibuat, QQ otomatis menambahkan bot tersebut ke daftar pesan Anda dan mengirim pesan sambutan. Pada tahap ini, bot belum terikat ke LightVela; mengirim pesan akan menghasilkan balasan "This bot has gone to Mars, try again later" â ini normal, lanjutkan ke langkah berikutnya.
6. Masukkan kredensial di LightVela
Masukkan App ID dan App Secret Anda dalam formulir pengikatan manual pada dialog Hubungkan QQ.
-
AppID: tempel AppID yang sudah disalin
-
AppSecret: tempel AppSecret yang sudah disalin

7. Ikat Bot QQ
Tunggu hasil koneksi dan pastikan kartu QQ menunjukkan Terhubung sebelum menguji pesan. Jika gagal, periksa kredensial dan pesan kesalahan. Pengiriman formulir yang berhasil tidak membuktikan pengiriman pesan.
8. Temukan Hermes Agent di QQ
Buka QQ, temukan bot yang baru Anda buat, lalu kirim pesan uji:
HelloAnda akan menerima balasan Hermes Agent dalam beberapa detik.

â Mention di grup QQ didukung
Setelah pengikatan QQ berhasil, LightVela mengaktifkan kebijakan chat grup QQ milik Hermes secara default. Tambahkan bot tersebut ke grup QQ, lalu sebut bot itu dengan mention untuk memulai percakapan. Kebijakan defaultnya adalah
open, yang berarti anggota grup QQ yang memuat bot tersebut dapat menyebutnya dengan mention untuk mengobrol. Pesan grup biasa tanpa mention tidak memicu percakapan.
Kondisi berhasil
-
Bot sudah dibuat di QQ Open Platform
-
Pastikan kartu QQ menampilkan Terhubung, lalu kirim pesan uji dari platform tersebut.
-
Bot di QQ membalas dengan benar memakai AI
-
Bot membalas di grup QQ ketika disebut dengan mention
Jenis pesan yang didukung
Setelah integrasi, bot QQ mendukung lebih dari teks dasar. Daftar lengkapnya:
| Bot QQ â jenis pesan dan fitur yang didukung | Didukung |
|---|---|
| Menerima pesan teks | â Ya |
| Menerima gambar | â Ya |
| Menerima file | â Ya |
| Menerima pesan suara | â Ya |
| Membalas dengan pesan teks | â Ya |
| Membalas dengan gambar | â Ya |
| Membalas dengan file | â Ya |
| Isi balasan mendukung Markdown | â Ya |
| Mengirim pesan secara proaktif (misalnya pengingat terjadwal) | â Ya |
| Mengutip pesan lama | â Belum |
FAQ
| Gejala | Kemungkinan penyebab | Penyelesaian |
|---|---|---|
| Bot membalas "My 'soul' is offline, please check your host service deployment" | AppID / AppSecret belum dikonfigurasi di LightVela, atau kredensialnya salah | Salin ulang parameter dari QQ Open Platform, pastikan tidak ada spasi di awal / akhir, lalu masukkan kembali di LightVela |
| Bot membalas "This bot has gone to Mars, try again later" | Bot QQ sudah dibuat tetapi belum terikat ke LightVela | Ikuti halaman ini untuk memasukkan AppID / AppSecret |
| Bot masih tidak membalas setelah semua konfigurasi | Model belum dikonfigurasi atau kredit uji coba habis | Pilih Bot tujuan, periksa model utama dan kuota pada halaman Model, lalu pastikan kartu QQ terhubung dan uji pesan. |
| AppSecret tidak dapat ditemukan | AppSecret hanya terlihat saat pembuatan | Klik "Reset Secret" di QQ Open Platform untuk membuat nilai baru, lalu masukkan kembali di LightVela |
| AppSecret bocor | â | Buka "Reset Secret" di QQ Open Platform, lalu masukkan AppSecret baru tersebut di LightVela |
| Kode QR kedaluwarsa | Tidak dipindai dalam masa berlakunya | Tutup dialog tersebut lalu klik "Hubungkan" lagi |
Catatan kanal
-
Jenis pesan: Teks, gambar, file, suara, dan lainnya â lihat "Jenis pesan yang didukung" di atas
-
Dukungan chat grup: Mention di grup aktif secara default setelah pengikatan. Konsol menerapkan kebijakan
open, yang mengizinkan anggota grup QQ yang memuat bot tersebut menyebutnya dengan mention untuk mengobrol. Untuk membatasi akses ke grup tertentu saja, ubah konfigurasi instans Hermes keallowlistlalu kelola daftar izinnya di sana; kartu kanal belum menyediakan pengalih ini -
Pengelolaan kredensial: AppSecret hanya terlihat dalam bentuk plaintext saat pembuatan; jika hilang atau bocor, kredensial tersebut harus direset
Langkah berikutnya
-
Kanal WeCom â Kolaborasi internal perusahaan dan skenario perkantoran
-
Kanal Lark â Skenario perkantoran dengan rich text dan chat grup
-
Konfigurasi Skill â Perluas kemampuan Hermes Agent
Terakhir diperbarui 2026-10-19