روبوت QQ

​

التثبيت

openclaw plugins install @openclaw/qqbot

​

الإعداد

1. انتقل إلى منصة QQ المفتوحة وامسح رمز QR ضوئيًا باستخدام تطبيق QQ على الهاتف للتسجيل / تسجيل الدخول.
2. انقر على Create Bot لإنشاء بوت QQ جديد.
3. ابحث عن 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", // block streaming: "partial" (default) or "off"
        nativeTransport: true, // use QQ's official C2C stream_messages API for DMs
      },
    },
  },
}

• streaming.mode: "off" يعطّل بث الكتل للحساب.
• streaming.nativeTransport: true يبث ردود C2C (الرسائل الخاصة) عبر واجهة stream_messages الرسمية من QQ؛ ولا تتأثر أهداف المجموعات/القنوات.
• تُنقل القيم المفردة القديمة streaming: true|false والمفتاح streaming.c2cStreamApi إلى هذه البنية عبر openclaw doctor --fix.
• /bot-streaming on|off يبدّل الإعداد نفسه من رسالة خاصة.

​

سياسة الوصول

• allowFrom / groupAllowFrom يحددان من يمكنه التحدث مع البوت في سياقات C2C / المجموعات. تتحكم dmPolicy / groupPolicy ‏(open | allowlist | disabled) في وضع الإنفاذ. تكون القيمة الافتراضية لـ dmPolicy هي allowlist بمجرد احتواء allowFrom على إدخال محدد (ليس حرف بدل)، وإلا فتكون open. وتكون القيمة الافتراضية لـ groupPolicy هي allowlist بمجرد احتواء groupAllowFrom أو allowFrom على إدخال محدد، وإلا فتكون open.
• تتطلب أوامر الشرطة المائلة “المصادقة: قائمة السماح” إدخالًا صريحًا ليس حرف بدل في 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 للرفع دفعة واحدة.
• إذا قاطعت ترقية فورية Gateway قبل أن ينتهي من كتابة openclaw.json، يستعيد Plugin آخر قيم معروفة لـ appId / clientSecret لذلك الحساب من لقطة داخلية عند بدء التشغيل التالي (من دون استبدال أي تغيير مقصود في الإعدادات)، لذا لا يلزم إعادة مسح رمز QR.

​

استكشاف الأخطاء وإصلاحها

• لا يبدأ Gateway / لا توجد رسائل واردة: تحقّق من صحة appId و clientSecret ومن تمكين البوت على QQ Open Platform. يظهر اعتماد مفقود على هيئة “QQBot غير مهيأ (appId أو clientSecret مفقود)”.
• لا يزال الإعداد باستخدام --token-file يظهر أنه غير مهيأ: لا يضبط --token-file سوى AppSecret. ولا بد من ضبط appId في الإعدادات أو QQBOT_APP_ID.
• تتعارض ردود المجموعة المتدفقة على دفعات: تطرد قائمة انتظار الوارد الرسائل التي أنشأها البوت قبل الرسائل البشرية عندما تمتلئ قائمة انتظار أحد النظراء، وتدمج دفعات رسائل المجموعة العادية (غير الأوامر) في دور واحد منسوب إلى أصحابه، بحيث لا ينبغي أن يحرم تدفق محادثات البوت الرسائل البشرية من المعالجة.
• الرسائل الاستباقية لا تصل: قد يحظر QQ الرسائل التي يبدأها البوت إذا لم يتفاعل المستخدم مؤخرًا.
• لم يُنسخ الصوت نصيًا: تأكّد من تهيئة STT وإمكانية الوصول إلى المزوّد.

​

ذات صلة

• الاقتران
• المجموعات
• استكشاف أخطاء القنوات وإصلاحها