QQ botu

​

Kurulum

openclaw plugins install @openclaw/qqbot

​

Ayarlama

1. QQ Open Platform adresine gidin ve kaydolmak / oturum açmak için QR kodunu telefonunuzdaki QQ ile tarayın.
2. Yeni bir QQ botu oluşturmak için Create Bot seçeneğine tıklayın.
3. Botun ayarlar sayfasında AppID ve AppSecret değerlerini bulup kopyalayın.

4. Kanalı ekleyin:

openclaw channels add --channel qqbot --token "AppID:AppSecret"

5. Gateway’i yeniden başlatın.

​

Gelen olayların dayanıklılığı

openclaw channels add

​

Yapılandırma

{
  channels: {
    qqbot: {
      enabled: true,
      appId: "YOUR_APP_ID",
      clientSecret: "YOUR_APP_SECRET",
    },
  },
}

• QQBOT_APP_ID
• QQBOT_CLIENT_SECRET

{
  channels: {
    qqbot: {
      enabled: true,
      appId: "YOUR_APP_ID",
      clientSecretFile: "/path/to/qqbot-secret.txt",
    },
  },
}

{
  channels: {
    qqbot: {
      enabled: true,
      appId: "YOUR_APP_ID",
      clientSecret: { source: "env", provider: "default", id: "QQBOT_CLIENT_SECRET" },
    },
  },
}

• openclaw channels add --channel qqbot --token-file ... yalnızca AppSecret değerini ayarlar; appId yapılandırmada veya QQBOT_APP_ID içinde önceden ayarlanmış olmalıdır.
• clientSecret düz metin dizesini, dosya yolunu (clientSecretFile) veya yapılandırılmış bir SecretRef nesnesini kabul eder.
• Eski secretref:... / secretref-env:... işaretleyici dizeleri clientSecret için reddedilir; bunun yerine yapılandırılmış bir SecretRef nesnesi kullanın.

​

Akış

{
  channels: {
    qqbot: {
      streaming: {
        mode: "partial", // blok akışı: "partial" (varsayılan) veya "off"
        nativeTransport: true, // DM'ler için QQ'nun resmi C2C stream_messages API'sini kullan
      },
    },
  },
}

• streaming.mode: "off" hesap için blok akışını devre dışı bırakır.
• streaming.nativeTransport: true, C2C (DM) yanıtlarını QQ’nun resmi stream_messages API’si üzerinden akıtır; grup/kanal hedefleri bundan etkilenmez.
• Eski streaming: true|false skalerleri ve streaming.c2cStreamApi anahtarı openclaw doctor --fix aracılığıyla bu biçime geçirilir.
• /bot-streaming on|off, bir DM’den aynı yapılandırmayı değiştirir.

​

Erişim politikası

• allowFrom / groupAllowFrom, C2C / grup bağlamlarında botla kimlerin sohbet edebileceğini sınırlar. dmPolicy / groupPolicy (open | allowlist | disabled) uygulama modunu denetler. allowFrom somut (joker olmayan) bir girdi içerdiğinde dmPolicy varsayılan olarak allowlist olur; aksi takdirde open olur. groupAllowFrom veya allowFrom somut bir girdi içerdiğinde groupPolicy varsayılan olarak allowlist olur; aksi takdirde open olur.
• “Auth: allowlist” eğik çizgi komutları, dmPolicy / groupPolicy değerlerinden bağımsız olarak allowFrom içinde (veya grup çağrıları için groupAllowFrom içinde) açıkça belirtilmiş joker olmayan bir girdi gerektirir — bkz. Eğik çizgi komutları.

​

Çok hesaplı ayarlama

{
  channels: {
    qqbot: {
      enabled: true,
      appId: "111111111",
      clientSecret: "secret-of-bot-1",
      accounts: {
        bot2: {
          enabled: true,
          appId: "222222222",
          clientSecret: "secret-of-bot-2",
        },
      },
    },
  },
}

openclaw channels add --channel qqbot --account bot2 --token "222222222:secret-of-bot-2"

​

Grup sohbetleri

{
  channels: {
    qqbot: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["member_openid"],
      groups: {
        "*": {
          requireMention: true,
          commandLevel: "all",
          historyLimit: 50,
          tools: { deny: ["exec", "read", "write"] },
        },
        GROUP_OPENID: {
          name: "Release room",
          requireMention: false,
          ignoreOtherMentions: true,
          commandLevel: "safety",
          historyLimit: 20,
          prompt: "Keep replies short and operational.",
        },
      },
    },
  },
}

​

Ses (STT / TTS)

{
  channels: {
    qqbot: {
      stt: {
        provider: "your-provider",
        model: "your-stt-model",
      },
      tts: {
        provider: "your-provider",
        model: "your-tts-model",
        voice: "your-voice",
      },
      accounts: {
        "qq-main": {
          tts: {
            providers: {
              openai: { voice: "shimmer" },
            },
          },
        },
      },
    },
  },
}

• sttDirectFormats
• uploadDirectFormats
• transcodeEnabled

​

Hedef biçimleri

​

Eğik çizgi komutları

​

Medya ve depolama

• Gelen, giden ve gateway köprüsü medyası, ~/.openclaw/media/qqbot altında tek bir yük kökünü paylaşır (OPENCLAW_HOME ayarlandığında buna uyulur); böylece yüklemeler, indirmeler ve kod dönüştürme önbellekleri korumalı tek bir dizin altında kalır.
• C2C ve grup hedeflerine zengin medya teslimatı tek bir sendMedia yolu üzerinden gerçekleştirilir. 5 MiB veya daha büyük yerel dosyalar ve bellek içi arabellekler QQ’nun parçalı yükleme uç noktalarını; daha küçük yükler ve uzak URL/Base64 kaynakları ise tek seferlik yükleme API’sini kullanır.
• Bir çalışırken yükseltme, openclaw.json yazımı tamamlanmadan Gateway’i kesintiye uğratırsa Plugin, sonraki başlatmada söz konusu hesap için bilinen son appId / clientSecret değerlerini dahili bir anlık görüntüden geri yükler (kasıtlı bir yapılandırma değişikliğinin üzerine asla yazmaz); böylece QR kodunun yeniden taranması gerekmez.

​

Sorun giderme

• Gateway başlamıyor / gelen ileti yok: appId ve clientSecret değerlerinin doğru olduğunu ve botun QQ Open Platform’da etkinleştirildiğini doğrulayın. Eksik bir kimlik bilgisi “QQBot not configured (missing appId or clientSecret)” olarak gösterilir.
• --token-file ile kurulum hâlâ yapılandırılmamış görünüyor: --token-file yalnızca AppSecret değerini ayarlar. appId yine de yapılandırmada veya QQBOT_APP_ID içinde ayarlanmalıdır.
• Ani grup yanıtları çakışıyor: bir eşin kuyruğu dolduğunda gelen ileti kuyruğu, bot tarafından yazılmış iletileri insan iletilerinden önce çıkarır ve normal (komut olmayan) grup iletilerinin ani yığınlarını ilişkilendirilmiş tek bir etkileşimde birleştirir; böylece yoğun bot konuşmaları insan iletilerinin işlenmesini engellememelidir.
• Proaktif iletiler ulaşmıyor: kullanıcı yakın zamanda etkileşimde bulunmadıysa QQ, bot tarafından başlatılan iletileri engelleyebilir.
• Ses metne dönüştürülmüyor: STT’nin yapılandırıldığından ve sağlayıcıya erişilebildiğinden emin olun.

​

İlgili

• Eşleştirme
• Gruplar
• Kanal sorunlarını giderme