LightVela

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.

Pilih kanal QQ

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.

  1. AppID: tempel AppID yang sudah disalin

  2. AppSecret: tempel AppSecret yang sudah disalin

Masukkan kredensial di LightVela

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:

Hello

Anda 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 didukungDidukung
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

GejalaKemungkinan penyebabPenyelesaian
Bot membalas "My 'soul' is offline, please check your host service deployment"AppID / AppSecret belum dikonfigurasi di LightVela, atau kredensialnya salahSalin 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 LightVelaIkuti halaman ini untuk memasukkan AppID / AppSecret
Bot masih tidak membalas setelah semua konfigurasiModel belum dikonfigurasi atau kredit uji coba habisPilih Bot tujuan, periksa model utama dan kuota pada halaman Model, lalu pastikan kartu QQ terhubung dan uji pesan.
AppSecret tidak dapat ditemukanAppSecret hanya terlihat saat pembuatanKlik "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 kedaluwarsaTidak dipindai dalam masa berlakunyaTutup 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 ke allowlist lalu 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