كيفية ربط Hermes Agent بـ Telegram وإدارة المهام من هاتفك

يمكنك مراسلة Hermes Agent أو إملاء المهام عليه عبر Telegram من هاتفك عندما تكون بعيدًا عن الكمبيوتر، واستلام النتيجة في المحادثة نفسها. تصل نتائج المهام المجدولة إلى المحادثة التي تحددها مرة واحدة لتكون محادثتك الرئيسية.

إذا لم يكن Hermes لديك بعد، فابدأ بدليل ما هذا الوكيل وكيفية تثبيته، ثم عُد لربط Telegram.

تتوفر تعليمات إضافية في وثائق Ailoot.

ما الذي تحتاج إليه لربط Hermes Agent بـ Telegram؟#

يتحقق الأمر hermes doctor من تثبيت Hermes واتصاله بالنموذج. سننشئ البوت في تطبيق Telegram، وستحتاج إلى كمبيوتر لتشغيل الأوامر في الطرفية.

كيف تنشئ بوتًا عبر BotFather؟#

لكل بوت على Telegram رمز مميز — وهو مفتاح سري للتحكم بالبوت. يصدره بوت Telegram الرسمي، @BotFather.

1. افتح @BotFather

   ابحث عن @BotFather في Telegram أو افتح t.me/BotFather. يحمل BotFather الحقيقي علامة تحقق زرقاء. ابدأ المحادثة بالنقر على «Start».

2. أرسل الأمر /newbot

   سيطلب BotFather اسمين. الأول هو اسم العرض، ويمكن أن يكون أي شيء، مثل «وكيلي». والثاني هو اسم المستخدم: يجب أن يكون فريدًا وينتهي بـ bot، مثل moy_agent_bot.

3. احصل على الرمز المميز

   سيرسل BotFather رسالة تهنئة وسلسلة طويلة بالشكل 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. هذا هو الرمز المميز للبوت. انسخ السلسلة كاملة.

هناك أيضًا طريقة سريعة لا تتطلب محادثة يدوية مع BotFather. في لوحة تحكم Hermes على الويب (hermes dashboard) وفي تطبيق سطح المكتب، توجد في صفحة “Messaging → Telegram” زر “Create with QR”: امسح الرمز بهاتفك، وسيُنشئ Hermes بوتًا ويتعرّف على معرّفك ويحفظ الرمز المميز في الإعدادات ثم يعيد تشغيل البوابة. تشرح الخطوات أدناه الطريقة اليدوية؛ إذا اخترت رمز QR، فانتقل مباشرة إلى التحقق من الاتصال.

كيف تعثر على معرّف Telegram الخاص بك، ولماذا تحتاج إليه؟#

لحساب Telegram معرّفان: اسم مستخدم عام مسبوق بعلامة @ ومعرّف رقمي داخلي. يستخدم Hermes الرقم.

طريقة «إنشاء باستخدام QR» السريعة المذكورة أعلاه تكتشف معرّفك تلقائيًا. دوّنه بجوار الرمز المميز.

كيف تعطي الرمز المميز إلى Hermes Agent وتبدأ تشغيل البوابة؟#

1. شغّل معالج الإعداد

   hermes gateway setup
   

   شغّل الأمر على الجهاز المثبّت عليه Hermes. سيعرض المعالج قائمة بتطبيقات المراسلة.

2. اختر Telegram وأدخل بياناتك

   سيطلب المعالج الرمز المميز للبوت والمعرّفات المسموح بها (يمكنك إدخال عدة معرّفات مفصولة بفواصل)، ثم يحفظ كل شيء في الإعدادات نفسها.

3. شغّل البوابة

   hermes gateway
   

   ستبدأ البوابة الاتصال بـ Telegram. بعد بضع ثوانٍ، أرسل أي رسالة إلى بوتك من التطبيق: إذا رد Hermes، فهذا يعني أن الاتصال جاهز.

تعمل الطريقة اليدوية بدلًا من استخدام المعالج على النحو التالي: افتح ملف ~/.hermes/.env وأضف سطرين، مع استبدال الرمز المميز الذي حصلت عليه من BotFather ومعرّفك الرقمي:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

يجيز السطر الثاني لهؤلاء الأشخاص الاستخدام في المحادثات الخاصة والمجموعات؛ وقد يمنح تفويض المحادثة الجماعية المستقل الوصول أيضًا. افصل بين الأشخاص بفواصل. بعد حفظ الملف، شغّل البوابة باستخدام الأمر نفسه hermes gateway.

إذا ظل البوت صامتًا حتى في محادثة خاصة، فتحقق من سجلات البوابة في الطرفية نفسها، وتأكد أولًا من صحة الرمز المميز ومعرّفك في قائمة الوصول؛ وتتناول نهاية المقالة الأخطاء الأخرى في جدول.

ما الذي يستطيع بوت Telegram فعله على هاتفك؟#

هناك خمس إمكانات ستحتاج إليها غالبًا على هاتفك.

الرسائل النصية والصوتية. اكتب مهمة بالكلمات أو أمْلِ رسالة صوتية — إذا كان التعرّف على الكلام مُعدًّا، فسيفرّغ Hermes الرسالة ويفهمها. مع مزوّد محلي، لا حاجة إلى مفاتيح؛ إذ تتم المعالجة كلها على الجهاز الذي يعمل عليه الوكيل.

الملفات والصور. يمكنك إعادة توجيه مستند أو جدول بيانات أو لقطة شاشة إلى البوت، وسيتلقاه الوكيل كمرفق. ويمكنه أيضًا إرسال الملفات التي ينشئها إليك: اطلب تقريرًا، وسيرسله كملف في المحادثة.

تأكيد الإجراءات الخطرة. عندما يوشك الوكيل على تنفيذ شيء محفوف بالمخاطر، مثل حذف ملفات، سيسألك أولًا في المحادثة: أجب بـ “yes” أو “y” لينفّذه؛ أو أجب بـ “no” أو “n” ليلغيه.

الأزرار بدلًا من الكتابة ردًا. عندما يحتاج الوكيل إلى توضيح، يرسل سؤالًا بأزرار خيارات مضمّنة — انقر على خيار، وسيواصل الوكيل العمل. يعرض الأمر /model من دون وسيطات قائمة لاختيار النموذج باستخدام الأزرار نفسها.

إشعارات هادئة. افتراضيًا، يرن هاتفك للردود النهائية وطلبات التأكيد وتأكيدات الأوامر فقط. تصل إشعارات الخدمة، مثل «جارٍ استدعاء أداة» و«جارٍ ضغط السياق»، بصمت، فلا يرن هاتفك عند كل خطوة. إذا أردت إشعارات صوتية في كل خطوة، فغيّر الوضع في الإعدادات.

كيف تحصل على نتائج المهام التي تعمل في الخلفية في المحادثة؟#

المحادثة الرئيسية للمهام المجدولة. يدعم Hermes المهام المجدولة، مثل: «أعدّ لي ملخصًا كل صباح عند 7:43». يرسل النتائج إلى المحادثة الرئيسية، التي تحددها مرة واحدة بإرسال الأمر /sethome مباشرة في المحادثة مع البوت. ما دامت البوابة قيد التشغيل، ستصل الملخصات تلقائيًا.

المهام التي تعمل في الخلفية. يمكنك إرسال مهمة طويلة لتعمل في الخلفية ومتابعة يومك؛ سيراسلك البوت عندما تصبح جاهزة. تعود إجابة المهمة التي بدأت من موضوع إلى الموضوع نفسه، حتى لا يضيع شيء.

قيد مهم: لا يرد البوت إلا عندما تكون البوابة قيد التشغيل. إذا أوقفت تشغيل الكمبيوتر الذي يعمل عليه Hermes أو وضعته في وضع السكون، فلن يرد البوت حتى يعود الجهاز إلى العمل. لإبقاء البوت متصلًا دائمًا، انقل الوكيل إلى خادم: لدينا دليل منفصل عن كيفية إبقاء Hermes Agent قيد التشغيل على مدار الساعة. افتراضيًا، تستطلع البوابة Telegram بحثًا عن الرسائل الجديدة؛ ولمنصات السحابة التي تدخل في وضع السكون عند غياب حركة المرور، توفر الوثائق وضع webhook، الذي يعكس اتجاه الاتصال بحيث يرسل Telegram نفسه الطلبات إلى البوت.

كيف تمنع الغرباء من استخدام البوت؟#

يمكن العثور على بوتك في بحث Telegram باستخدام اسم المستخدم الخاص به، لذا تعتمد الحماية على أمرين: قائمة الوصول والحفاظ على سرية الرمز المميز.

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

ثانيًا، هناك الرمز المميز. يجب ألا يظهر في لقطات الشاشة أو الرسائل المعاد توجيهها أو المستودعات. إذا تسرّب الرمز، فأبطله باستخدام الأمر /revoke في BotFather. ثم أدخل الرمز الجديد في الإعدادات وأعد تشغيل البوابة.

ملاحظة منفصلة عن المجموعات: تفويض المرسل وتفويض المحادثة أمران مختلفان. يستطيع عضو مجموعة مسموحة عبر TELEGRAM_GROUP_ALLOWED_CHATS استخدام البوت حتى إن غاب معرّفه عن TELEGRAM_ALLOWED_USERS. إذا وجب حصر الوصول بالأفراد، فلا تمنح المجموعة كلها وصولًا؛ اضبط قيود المرسلين وتحقق منها لإصدارك المثبت. إذا أردت أن يرد البوت في المجموعة عند مناداته فقط، فهناك الإعداد telegram.require_mention — عندئذٍ يرد عند الإشارة إليه بعلامة @، أو الرد على رسالته، أو إرسال أمر مثل /command@yourbot، أو مطابقة الأنماط التي تحددها في telegram.mention_patterns، مع تجاهل رسائل المجموعة العادية.

لماذا يصمت البوت في مجموعة، وكيف تصلح ذلك؟#

تكون ميزة وضع الخصوصية مفعّلة افتراضيًا في بوتات Telegram الجديدة؛ وتصفها وثائق Hermes بأنها أكثر أسباب الالتباس شيوعًا بشأن البوتات في المجموعات. في هذا الوضع، لا يتلقى البوت إلا الرسائل التي تبدأ بأمر /، والردود على رسائله، وإشعارات الخدمة. فهو لا يتلقى رسائل المجموعة العادية ببساطة — لا يرسلها Telegram إليه، ولن يعالج ذلك أي إعداد للوكيل.

طريقة الإصلاح:

1. افتح @BotFather وأرسل /mybots.
2. اختر بوتك.
3. افتح “Bot Settings” → “Group Privacy” → “Turn off”.
4. أزل البوت من المجموعة ثم أضفه مجددًا.

من السهل إغفال الخطوة الرابعة، وعندها «يظل البوت صامتًا». يتذكر Telegram إعداد الخصوصية الذي كان ساريًا عند انضمام البوت إلى المجموعة، ولا يحدّثه حتى يُزال البوت من المجموعة ثم يُضاف مجددًا.

إذا لم ترغب في تعطيل الخصوصية على نحو عام، فهناك خيار ثانٍ: اجعل البوت مسؤولًا في المجموعة. تستقبل بوتات المسؤولين جميع الرسائل في أي وضع للخصوصية.

أخطاء الاتصال الشائعة وما ينبغي فعله#

ما الأسئلة الأخرى التي يطرحها الناس عن Hermes Agent في Telegram؟#

عندما تكون مستعدًا، تعرّف على Ailoot.