QQ बॉट

​

इंस्टॉल करें

openclaw plugins install @openclaw/qqbot

​

सेटअप

1. QQ Open Platform पर जाएँ और पंजीकरण / लॉग इन करने के लिए अपने फ़ोन के QQ से QR कोड स्कैन करें।
2. नया QQ bot बनाने के लिए Create Bot पर क्लिक करें।
3. bot के सेटिंग पेज पर AppID और AppSecret ढूँढें और उन्हें कॉपी करें।

4. चैनल जोड़ें:

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

5. Gateway को पुनः आरंभ करें।

​

इनबाउंड स्थायित्व

openclaw channels add

​

कॉन्फ़िगर करें

{
  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 ... केवल AppSecret सेट करता है; appId पहले से कॉन्फ़िगरेशन या QQBOT_APP_ID में सेट होना चाहिए।
• clientSecret सादे टेक्स्ट की स्ट्रिंग, फ़ाइल पथ (clientSecretFile), या संरचित SecretRef ऑब्जेक्ट स्वीकार करता है।
• लेगेसी secretref:... / secretref-env:... मार्कर स्ट्रिंग clientSecret के लिए अस्वीकार की जाती हैं; इसके बजाय संरचित SecretRef ऑब्जेक्ट का उपयोग करें।

​

स्ट्रीमिंग

{
  channels: {
    qqbot: {
      streaming: {
        mode: "partial", // ब्लॉक स्ट्रीमिंग: "partial" (डिफ़ॉल्ट) या "off"
        nativeTransport: true, // DM के लिए QQ की आधिकारिक C2C stream_messages API का उपयोग करें
      },
    },
  },
}

• streaming.mode: "off" खाते के लिए ब्लॉक स्ट्रीमिंग अक्षम करता है।
• streaming.nativeTransport: true QQ की आधिकारिक stream_messages API के माध्यम से C2C (DM) उत्तर स्ट्रीम करता है; समूह/चैनल लक्ष्य अप्रभावित रहते हैं।
• लेगेसी streaming: true|false स्केलर और streaming.c2cStreamApi कुंजी openclaw doctor --fix के माध्यम से इस संरचना में माइग्रेट होते हैं।
• /bot-streaming on|off DM से इसी कॉन्फ़िगरेशन को टॉगल करता है।

​

पहुँच नीति

• allowFrom / groupAllowFrom नियंत्रित करते हैं कि C2C / समूह संदर्भों में bot से कौन चैट कर सकता है। dmPolicy / groupPolicy (open | allowlist | disabled) प्रवर्तन मोड नियंत्रित करते हैं। allowFrom में कोई ठोस (गैर-वाइल्डकार्ड) प्रविष्टि होने पर dmPolicy का डिफ़ॉल्ट allowlist होता है, अन्यथा open। groupAllowFrom या allowFrom में से किसी में ठोस प्रविष्टि होने पर groupPolicy का डिफ़ॉल्ट allowlist होता है, अन्यथा open।
• “Auth: allowlist” स्लैश कमांड के लिए allowFrom में (या समूह आमंत्रणों के लिए groupAllowFrom में) स्पष्ट गैर-वाइल्डकार्ड प्रविष्टि आवश्यक है, चाहे dmPolicy / groupPolicy कुछ भी हो — स्लैश कमांड देखें।

​

एकाधिक-खाता सेटअप

{
  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"

​

समूह चैट

{
  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.",
        },
      },
    },
  },
}

​

वॉइस (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

​

लक्ष्य प्रारूप

​

स्लैश कमांड

​

मीडिया और स्टोरेज

• इनबाउंड, आउटबाउंड और Gateway-ब्रिज मीडिया ~/.openclaw/media/qqbot के अंतर्गत एक ही पेलोड रूट साझा करते हैं (सेट होने पर OPENCLAW_HOME का पालन करते हुए), ताकि अपलोड, डाउनलोड और ट्रांसकोड कैश एक ही सुरक्षित डायरेक्टरी के अंतर्गत रहें।
• C2C और समूह लक्ष्यों के लिए रिच मीडिया डिलीवरी एक ही sendMedia पथ से होती है। 5 MiB या उससे बड़ी स्थानीय फ़ाइलें और इन-मेमोरी बफ़र QQ के खंडित अपलोड एंडपॉइंट का उपयोग करते हैं; छोटे पेलोड और रिमोट-URL/Base64 स्रोत एकल-प्रयास अपलोड API का उपयोग करते हैं।
• यदि कोई हॉट अपग्रेड openclaw.json का लेखन पूरा होने से पहले Gateway को बाधित करता है, तो Plugin अगली शुरुआत पर आंतरिक स्नैपशॉट से उस खाते के अंतिम ज्ञात appId / clientSecret को पुनर्स्थापित करता है (किसी जानबूझकर किए गए कॉन्फ़िगरेशन परिवर्तन को कभी अधिलेखित नहीं करता), इसलिए QR कोड को फिर से स्कैन करना आवश्यक नहीं है।

​

समस्या निवारण

• Gateway शुरू नहीं होता / कोई इनबाउंड संदेश नहीं: सत्यापित करें कि appId और clientSecret सही हैं और QQ Open Platform पर बॉट सक्षम है। क्रेडेंशियल अनुपलब्ध होने पर “QQBot कॉन्फ़िगर नहीं है (appId या clientSecret अनुपलब्ध है)” दिखाई देता है।
• --token-file के साथ सेटअप अब भी कॉन्फ़िगर नहीं दिखाता: --token-file केवल AppSecret सेट करता है। appId को अभी भी कॉन्फ़िगरेशन या QQBOT_APP_ID में सेट करना आवश्यक है।
• अचानक बड़ी संख्या में आए समूह उत्तर टकराते हैं: किसी पीयर की कतार भरने पर इनबाउंड कतार मनुष्यों द्वारा लिखे संदेशों से पहले बॉट द्वारा लिखे संदेशों को हटाती है और सामान्य (गैर-कमांड) समूह संदेशों के समूह को एक श्रेयांकित टर्न में मिला देती है, ताकि बॉट संदेशों की बाढ़ से मानव संदेशों को संसाधन मिलना बंद न हो।
• सक्रिय रूप से भेजे गए संदेश नहीं पहुँच रहे: यदि उपयोगकर्ता ने हाल में इंटरैक्ट नहीं किया है, तो QQ बॉट द्वारा आरंभ किए गए संदेशों को अवरुद्ध कर सकता है।
• आवाज़ का लिप्यंतरण नहीं हुआ: सुनिश्चित करें कि STT कॉन्फ़िगर किया गया है और प्रदाता तक पहुँचा जा सकता है।

​

संबंधित

• पेयरिंग
• समूह
• चैनल समस्या निवारण