Ön Koşullar
- Bir QQ hesabı
- QQ Open Platform erişimi (geliştirici hesabı)
- Bir Claw örneği (buradan bir tane oluşturun)
Kurulum Kılavuzu
Bir QQ Bot Uygulaması Oluşturun
- QQ Open Platform adresine gidin
- Giriş yapın ve Bot bölümüne gidin
- Create Bot seçeneğine tıklayın
- Bot bilgilerini doldurun (ad, avatar, açıklama)
- İnceleme için gönderin
Kimlik Bilgilerini Alın
- Onaylandıktan sonra botunuzun Development Settings bölümüne gidin
- AppID değerini kopyalayın
- AppSecret (Client Secret) değerini kopyalayın
Sandbox Yapılandırması (Test İçin)
- Bot ayarlarında Sandbox Configuration bölümüne gidin
- QQ numaranızı sandbox beyaz listesine (whitelist) ekleyin
- Bu, yayına girmeden önce test yapmanıza olanak tanır
LemonClaw WebUI'yi Açın
- Hosted Claw kullanıyorsanız Claw Dashboard sayfanıza gidin ve Open WebUI’ye tıklayın
- LemonClaw’ı self-host ediyorsanız kendi WebUI’nizi (örneğin
http://your-ip:18789) açın ve token ile giriş yapın - WebUI içinde Settings → Channels bölümüne gidin
- QQ bölümünü genişletin
- AppID ve AppSecret değerlerinizi yapıştırın
- Save butonuna tıklayın
Desteklenen Mesaj Türleri
| Tür | Açıklama |
|---|---|
| C2C (Özel) | Bota doğrudan mesajlar |
| Grup @bahsetme | Bir QQ grubunda bottan @bahsetme |
| Kanal | QQ kanallarındaki (频道) mesajlar |
Sorun Giderme
LemonClaw’ın mevcut QQ desteği doğrudan mesajlar ve grup içi @bot olaylarıyla sınırlıdır. @ olmadan gönderilen normal grup mesajları ve QQ kanal konuşmaları henüz desteklenmez.
Bot yanıt vermiyor
Bot yanıt vermiyor
- AppID ve AppSecret değerlerinin doğru olduğunu doğrulayın
- QQ numaranızın sandbox beyaz listesinde (whitelist) olduğunu kontrol edin (test ediyorsanız)
- Bot uygulamasının onaylandığından emin olun
'invalid appid' hatası
'invalid appid' hatası
- AppID’yi tekrar kontrol edin — sayısal bir dize olmalıdır
- Doğru AppSecret’ı kullandığınızdan emin olun (token değil)