بوت QQ — الذكاء الاصطناعي في QQ
بوت QQ — الذكاء الاصطناعي في QQ — دليل سهل الفهم مستند إلى الوثائق الرسمية
تخيّل أن مجموعة الدردشة المفضّلة لديك أصبح فيها فجأة صديق خارق الذكاء يقدر يجاوب على الأسئلة، يلخّص الرسائل الصوتية، وحتى يرسل ردود منسّقة بشكل جميل — هذا بالضبط اللي يقدّمه Hermes Agent لتطبيق QQ.
وش هالشي؟
Hermes Agent هو إطار عمل مفتوح المصدر يخلّيك توصّل مساعدين الذكاء الاصطناعي بمنصّات المراسلة. محوّل QQ Bot هو الجسر اللي يربط Hermes بواجهة QQ الرسمية للبوتات. يسمع الرسائل (محادثات خاصة، منشنات المجموعات، قنوات السيرفرات) ويرد تلقائيًا — بدون ما تحتاج تكتب كود زيادة عن الإعدادات الأساسية.
كيف يشتغل (بأسلوب بسيط)
فكّر فيها مثل ما تركّب جوال جديد:
- تحصل على هوية للبوت – تسجّل بوتك في q.qq.com وتستلم App ID و App Secret (مثل اسم المستخدم وكلمة المرور لبوتك).
- توصّل الأسلاك – Hermes يفتح اتصال WebSocket دائم مع بوابة QQ، فبالتالي يسمع الرسائل فورًا.
- تعلّمه يسمع – أنت تحدد أي المحادثات يقدر يدخلها: رسائل خاصة، منشنات المجموعات، أو قنوات السيرفرات.
- تخليه يرد – لما أحد يرسل رسالة، Hermes يعالجها ويرد بنص أو Markdown غني.
خطوات الإعداد بالتفصيل
1. ثبّت المتطلبات
pip install aiohttp httpx
2. إعداد البوت (أسهل طريقة)
hermes gateway setup
اختر QQ Bot واتبع التعليمات. بيطلب منك App ID و Secret.
3. الإعداد اليدوي (إذا تفضّل)
أنشئ أو عدّل على ~/.hermes/.env:
QQ_APP_ID=your-app-id
QQ_CLIENT_SECRET=your-app-secret
هذا الحد الأدنى. إذا تبغى تحكم أكثر، عدّل على ~/.hermes/config.yaml:
platforms:
qqbot:
enabled: true
extra:
markdown_support: true
dm_policy: "open" # open | allowlist | disabled
group_policy: "open"
ميزة رهيبة: الرسائل الصوتية
QQ يعطيك تحويل نصي مجاني (تقنية Tencent للتعرف على الكلام) لكل رسالة صوتية. إذا فشل التحويل، Hermes يقدر يتحول لمزوّد تحويل صوتي مخصص مثل GLM-ASR أو OpenAI Whisper. هذا يعني إن بوتك يقدر “يسمع” الملاحظات الصوتية ويرد بملخصات نصية.
إعدادات أمان لازم تعرفها
QQ_ALLOWED_USERS– يقيّد الرسائل الخاصة على OpenIDs محددة (الافتراضي: الكل)QQ_GROUP_ALLOWED_USERS– يقيّد وصول المجموعات على OpenIDs محددةdm_policy/group_policy– اضبطها على"allowlist"للتحكم الصارم، أو"disabled"لإيقاف القناة تمامًا
الخلاصة ونصيحة عملية
ربط Hermes مع QQ مثل ما تعطي مجموعة الدردشة مساعد شخصي — ياخذ منك حوالي 10 دقائق إعداد، وبعدها تقدر تخصّص كل شيء من مين يقدر يتكلم معه، إلى إذا كان يدعم Markdown أو تحويل الصوت لنص.
نصيحتي للمبتدئين: ابدأ في وضع التجربة (اضبط QQ_PORTAL_HOST=sandbox.q.qq.com). جرّب بحسابك أولًا، وبعدها وسّع تدريجيًا لأصدقائك. ودائمًا اضبط QQ_ALLOWED_USERS على OpenID حقك قبل ما تخليه عام — ما تبغى غرباء يتكلمون مع بوتك من أول يوم.
بمجرد ما يشتغل، جرّب تطلب من بوتك يلخّص رسالة صوتية طويلة أو ينسّق إعلان سريع — هنا يظهر السحر الحقيقي.
📖 التوثيق الرسمي
この記事は Hermes Agent のالتوثيق الرسميに基づいています:التوثيق الرسمي › user-guide/messaging/qqbot