الجواب المختصر. أنشئ بوتًا عبر @BotFather في Telegram (/newbot) وانسخ رمزه. أعطِ Hermes Agent الرمز ومعرّف مستخدم Telegram الرقمي الخاص بك: لا يستطيع التحدث معه إلا المعرّفات الموجودة في قائمة السماح أو من توافق عليهم برمز إقران؛ وبلا قائمة سماح لا يحصل الغريب إلا على رمز إقران عليك أن توافق عليه. على جهازك هذا يعني TELEGRAM_BOT_TOKEN وTELEGRAM_ALLOWED_USERS في ~/.hermes/.env، أو hermes gateway setup. وعلى PlayNHost تلصق الرمز ومعرّفك في صفحة الوكيل ثم تعيد التشغيل.
روجع في 7 نوفمبر 2026، وهو صحيح لإصدار Hermes Agent v0.23.0.
يعتمد هذا الدليل على وثائق Telegram والأمان في Hermes Agent وعلى لوحة PlayNHost كما تعمل اليوم. دعم Telegram مدمج في بوابة الرسائل في Hermes Agent: لا شيء إضافي لتثبيته.
الخطوة 1: أنشئ البوت وانسخ رمزه
في Telegram افتح محادثة مع @BotFather (أو t.me/BotFather). تأكد أن الاسم هو بالضبط @BotFather.
أرسل /newbot، واختر اسم عرض، ثم اسم مستخدم ينتهي بـ bot.
يرد BotFather بالرمز، وشكله مثل 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. أبقِه سريًا: كل من يملكه يستطيع التحكم ببوتك. وإذا تسرّب فألغِه بـ /revoke في BotFather.
برنامج واحد لكل بوت. تقول الأسئلة الشائعة في Hermes Agent إن كل منصة دردشة تحتاج إلى استخدام حصري لرمز البوت. إذا كانت نسخة أقدم من Hermes Agent أو أي برنامج آخر ما زال يستخدم الرمز نفسه، فأوقفه أولًا أو أنشئ بوتًا جديدًا.
الخطوة 2: اعثر على معرّف مستخدم Telegram
تأخذ قائمة السماح في Hermes Agent معرّف المستخدم الرقمي، أي رقمًا مثل 123456789، لا @اسم_المستخدم. طرق الحصول عليه:
على PlayNHost، من الـ console. راسل بوتك قبل أن تضبط أي معرّف: تطبع الـ console معرّفك. التفاصيل في الخطوة 3 أدناه.
من سجل Hermes Agent. حين يرسل شخص غير موجود في قائمته رسالة مباشرة، يظهر في سجله (~/.hermes/logs/gateway.log) تحذير يبدأ بـ "Unauthorized user" مع المعرّف الرقمي للمرسل (بين قوسين بعد اسمه حين يُضبط تجاهل الغرباء، كما في PlayNHost).
بوت من طرف ثالث. تقترح وثائق Hermes Agent @userinfobot أو @get_id_bot، وكلاهما يرد عليك بمعرّفك.
الخطوة 3 على PlayNHost: الصق الرمز ومعرّفك
تحتاج إلى مفتاح مزود ذكاء اصطناعي في الصفحة نفسها. وبدونه يتوقف التشغيل مع الرسالة "Your agent is not set up yet: it needs an API key from one AI provider and a Telegram or Discord bot token."
تحت تطبيقات الدردشة اضغط تعيين عند رمز بوت Telegram، والصق الرمز من BotFather واضغط حفظ. تفحص اللوحة شكل الرمز؛ واللصق الخاطئ يعطي "That is not a valid telegram bot token." وبعد الحفظ يعرض السطر آخر أربعة أحرف فقط، ولا يُعرض الرمز مرة أخرى.
لا تعرف معرّفك بعد؟ اترك معرّفات مستخدمي Telegram فارغة واضغط تشغيل. أول تشغيل يثبّت Hermes Agent، وقد استغرق نحو 2.5 إلى 4 دقائق في اختباراتنا. وعندما يعمل الوكيل تطبع الـ console:
[PlayNHost] Your agent is running
[PlayNHost] Telegram: nobody can message your agent yet. Send your bot any message: your Telegram user ID appears here in the console. Put it on the Agent page, then restart.
أرسل رسالة إلى بوتك في Telegram. لن يرد، ولا حتى برمز إقران: على PlayNHost يتجاهل Hermes Agent كل من ليس في القائمة. وخلال نحو 20 ثانية (تفحص الـ console سجل Hermes Agent كل 20 ثانية) تعرض معرّفك:
[PlayNHost] Telegram user 123456789 messaged your agent and was ignored. If that is you, add 123456789 to the Telegram user IDs on the Agent page, then restart.
تحت من يمكنه مراسلته اكتب الرقم في معرّفات مستخدمي Telegram واضغط حفظ. عدة معرّفات تُكتب في سطر واحد تفصل بينها فواصل أو مسافات.
تعرض الصفحة: "تُطبَّق التغييرات عند التشغيل التالي لوكيلك." اضغط إعادة التشغيل الآن. ثم تؤكد الـ console:
[PlayNHost] Telegram: only user 123456789 can message your agent.
راسل بوتك. يرد وكيلك. الرسائل من أي حساب Telegram آخر تُتجاهل، ويظهر كل مرسل جديد يراسل البوت مباشرة في الـ console مرة واحدة في كل تشغيل، فيمكنك إضافة صديق بالطريقة نفسها.
ما تضبطه PlayNHost لك
تصل المعرّفات الموجودة في صفحة الوكيل إلى Hermes Agent باسم TELEGRAM_ALLOWED_USERS. أما كل طريقة أخرى لإدخال الناس (مفاتيح السماح للجميع وقوائم سماح أخرى وصلاحيات المجموعات وموافقات الإقران) فتُغلق عند كل تشغيل، ويُوقف الوكيل إذا ظهرت إحداها أثناء عمله.
يُتجاهل الغرباء (unauthorized_dm_behavior: ignore) بدل أن يحصلوا على رمز الإقران الافتراضي في Hermes Agent، لأن خادم PlayNHost ليس فيه سطر أوامر للموافقة على رمز.
يصل الرمز إلى Hermes Agent باسم TELEGRAM_BOT_TOKEN. وأي نسخة منه مكتوبة داخل .hermes/.env تُزال عند التشغيل التالي، فيكون المستخدَم هو الرمز المحفوظ في صفحة الوكيل.
Telegram وDiscord فقط مفعّلان. WhatsApp مرفوض: تقول وثائق Hermes Agent نفسها إن جسر WhatsApp فيه يحاكي جلسة WhatsApp Web ويحمل خطر الحظر.
الخطوة 3 على جهازك
شغّل معالج الإعداد واختر Telegram. يسأل عن الرمز ومعرّفات المستخدمين المسموح لهم ويكتبها لك:
بلا أي قائمة سماح يرفض Hermes Agent الجميع. والافتراضي مع الغرباء رمز إقران توافق عليه بـ hermes pairing approve telegram <code>؛ وتنتهي صلاحية الرموز بعد ساعة. وتقدّم وثائق Hermes Agent أيضًا GATEWAY_ALLOW_ALL_USERS=true، وتحذّر منه لبوت يستطيع تنفيذ الأوامر.
عندما لا يرد
ما تراه
السبب والحل
الـ console: "Telegram: nobody can message your agent yet"
لا معرّف في صفحة الوكيل. راسل البوت، وانسخ معرّفك من سطر الـ console الذي يلي، وأضفه وأعد التشغيل.
الـ console: "Telegram user ... messaged your agent and was ignored"
هذا الحساب ليس في القائمة. إن كان حسابك فأضف الرقم وأعد التشغيل.
الـ console: "... entry in the Telegram user IDs is not a Telegram user ID and was left out"
رقم في القائمة أقصر من 5 أرقام أو أطول من 25 رقمًا، فلا يمكن أن يكون معرّف مستخدم. قارنه بسطر الـ console الذي فيه معرّفك.
الـ console: "Telegram refused the bot token. Check it on the Agent page, then restart."
أُلغي الرمز أو كُتب خطأً. في @BotFather أرسل /mybots واختر بوتك ثم API Token وانسخه من جديد، ثم اضغط استبدال في صفحة الوكيل.
لا شيء في الـ console بعد رسالتك، ولا رد
برنامج آخر يستخدم الرمز نفسه، أو راسلت بوتًا آخر. أوقف النسخة الأخرى أو أنشئ بوتًا جديدًا ثم أعد التشغيل.
لا شيء في مجموعة
تحدّث مع الوكيل في رسالة مباشرة. في المجموعات يسمح وضع الخصوصية في Telegram للبوت برؤية الأوامر والردود عليه فقط ما لم تغيّره في BotFather، وعلى PlayNHost لا يُرد إلا على معرّفات المستخدمين الموجودة في قائمتك.
نستخدم ملفات تعريف الارتباط لإبقاء الموقع يعمل، ولفهم كيف يُستخدم، ولقياس حملاتنا التسويقية. يمكنك قبول الكل أو قبول ملفات تعريف الارتباط الأساسية فقط أو الاختيار لكل فئة.نستخدم ملفات تعريف الارتباط لإبقاء الموقع يعمل، ولفهم كيف يُستخدم، ولقياس حملاتنا التسويقية. وهي مفعّلة هنا افتراضيًا. يمكنك إيقاف أي منها لا تريده.اقرأ سياسة الخصوصية
