كيف تربط Hermes Agent بـ Discord

الجواب المختصر. أنشئ تطبيقًا وبوتًا في Discord Developer Portal، وفعّل Message Content Intent وServer Members Intent، وانسخ رمز البوت بـ Reset Token، وادعُ البوت إلى خادمك، ثم أعطِ Hermes Agent الرمز ومعرّف مستخدم Discord الخاص بك. لا يستطيع التحدث معه إلا المعرّفات الموجودة في قائمة السماح. على جهازك هذا يعني DISCORD_BOT_TOKEN وDISCORD_ALLOWED_USERS في ~/.hermes/.env، أو hermes gateway setup. وعلى PlayNHost تلصق الرمز ومعرّفك في صفحة الوكيل ثم تعيد التشغيل.

روجع في 7 نوفمبر 2026، وهو صحيح لإصدار Hermes Agent v0.23.0.

يعتمد هذا الدليل على وثائق Discord والأمان في Hermes Agent وعلى لوحة PlayNHost كما تعمل اليوم. دعم Discord مدمج في بوابة الرسائل في Hermes Agent.

الخطوة 1: أنشئ التطبيق والبوت

1. افتح Discord Developer Portal (بوابة مطوري Discord)، واضغط New Application وسمّه واضغط Create. دوّن Application ID من صفحة General Information.
2. افتح Bot من القائمة اليسرى. تحت Authorization Flow فعّل Public Bot إن أردت رابط الدعوة الخاص بـ Discord (الخطوة 2)، واترك Require OAuth2 Code Grant متوقفًا.
3. تحت Privileged Gateway Intents فعّل Message Content Intent وServer Members Intent، ثم اضغط Save Changes. تضع وثائق Hermes Agent كليهما علامة "مطلوب": فبدون Message Content Intent يرفض Discord اتصال البوت ولا يظهر متصلًا أبدًا. أما Presence Intent فاختياري.
4. تحت Token اضغط Reset Token وانسخ الرمز. يعرضه Discord مرة واحدة فقط. أبقِه سريًا: كل من يملكه يتحكم ببوتك.

الخطوة 2: ادعُ البوت إلى خادمك

إما أن تستخدم Installation (Guild Install وDiscord Provided Link والنطاقان bot وapplications.commands والصلاحيات المذكورة أدناه)، أو تبني الرابط بنفسك باستخدام Application ID من الخطوة 1:

https://discord.com/oauth2/authorize?client_id=YOUR_APP_ID&scope=bot+applications.commands&permissions=309237763136

309237763136 هي مجموعة الصلاحيات التي توصي بها وثائق Hermes Agent: View Channels وSend Messages وEmbed Links وAttach Files وRead Message History وCreate Public Threads وSend Messages in Threads وAdd Reactions. افتح الرابط واختر خادمك واضغط Authorize. تحتاج إلى صلاحية Manage Server في ذلك الخادم.

الخطوة 3: اعثر على معرّف مستخدم Discord

1. في Discord افتح Settings ثم Advanced، وفعّل Developer Mode.
2. انقر بزر الفأرة الأيمن على اسمك واختر Copy User ID. هو رقم طويل، مثل 284102345871466496.

هذا هو معرّف مستخدمك، وليس Application ID الخاص بالبوت ولا معرّف خادم أو قناة.

الخطوة 4 على PlayNHost: الصق الرمز ومعرّفك

1. افتح خادمك على panel.playnhost.com ثم تبويب الوكيل.
2. تحت مزود الذكاء الاصطناعي عيّن مفتاحًا إن لم تفعل بعد (انظر أي مفتاح مزود ذكاء اصطناعي تستخدم).
3. تحت تطبيقات الدردشة اضغط تعيين عند رمز بوت Discord، والصق الرمز واضغط حفظ. يعرض السطر بعدها آخر أربعة أحرف فقط؛ ولا يُعرض الرمز مرة أخرى.
4. تحت من يمكنه مراسلته الصق معرّفك في معرّفات مستخدمي Discord واضغط حفظ. عدة معرّفات تُكتب في سطر واحد تفصل بينها فواصل أو مسافات.
5. اضغط تشغيل، أو إعادة التشغيل الآن إن كان الوكيل يعمل ("تُطبَّق التغييرات عند التشغيل التالي لوكيلك."). وعندما يعمل تؤكد الـ console:

   [PlayNHost] Your agent is running
   [PlayNHost] Discord: only user 284102345871466496 can message your agent.

6. أرسل إلى البوت رسالة مباشرة، أو اذكره بـ @ في قناة يستطيع رؤيتها. يرد وكيلك: في الرسالة المباشرة هناك مباشرة، وفي القناة داخل سلسلة (thread) جديدة تحت رسالتك.

إذا بدأت بحقل معرّفات مستخدمي Discord فارغًا، تقول الـ console "Discord: nobody can message your agent yet" وتطلب منك إرسال رسالة إلى البوت: الرسالة المباشرة من شخص ليس في القائمة تُتجاهل، ثم تطبع الـ console سطرًا فيه معرّف ذلك المرسل لتضيفه. وطريقة Developer Mode أسرع.

يمكن لـ Telegram وDiscord أن يعملا مع الوكيل نفسه في الوقت نفسه: اضبط الرمزين وقائمتي المعرّفات.

كيف يتصرف Hermes Agent في Discord

• الرسائل المباشرة: يرد على كل رسالة دون حاجة إلى ذكر، ومحادثة واحدة لكل رسالة مباشرة.
• قنوات الخادم: يرد فقط حين تذكره بـ @، وافتراضيًا يفتح سلسلة جديدة لكل ذكر ويرد فيها. والأشخاص المختلفون في قناة واحدة يحصلون على محادثات منفصلة.
• الآخرون: على PlayNHost يُرد فقط على معرّفات المستخدمين الموجودة في صفحة الوكيل. صلاحيات الأدوار ومفاتيح السماح للجميع والوصول بين البوتات تُغلق عند كل تشغيل.

الخطوة 4 على جهازك

1. شغّل معالج الإعداد واختر Discord. تقول وثائق Hermes Agent إنه يتحقق من الرمز مع Discord ويفحص الـ intents ويطبع رابط الدعوة ويعرض السماح لك:

   hermes gateway setup

2. أو أضف القيم يدويًا إلى ~/.hermes/.env:

   DISCORD_BOT_TOKEN=your-bot-token
   DISCORD_ALLOWED_USERS=284102345871466496

3. شغّله بـ hermes gateway. ولبوابة تستمر بعد تسجيل خروجك، انظر كيف تشغّل Hermes Agent على مدار الساعة 24/7.

عندما لا يرد

على PlayNHost سجل Hermes Agent نفسه هو .hermes/logs/gateway.log في Files. تريد Telegram أيضًا؟ انظر ربط Hermes Agent بـ Telegram. لم تُعدّ شيئًا بعد؟ أنشئ خادم Hermes Agent.

PlayNHost غير تابعة لـ Nous Research. Hermes Agent برنامج مفتوح المصدر بترخيص MIT.