ربط Hermes Agent بتيليجرام: وكيلك الذكي بجيبك
توكن بوت، رقم مستخدم، خمس دقائق — والوكيل الكامل يجاوبك من الجوال: ملفات وأدوات وجدولة. الإعداد الكامل مع إعدادات الأمان اللي أغلب الشروح تتجاهلها.
مبتدئ10 دقيقة قراءة
وش راح تقدر تسوي بعد هذا الشرح
- تنشئ بوت تيليجرام خاص فيك من BotFather وتحمي التوكن ماله
- تربط Hermes بتيليجرام عبر معالج البوابة التفاعلي
- ترسل أوامر من جوالك وتستلم شغل وكيل حقيقي
- تقفل البوت بحيث ما أحد غيرك يقدر يتكلم معه
- تحل مشاكل الاتصال الأربع اللي تواجه المبتدئين فعلاً
قبل ما تبدأ
- Hermes مثبّت ويشتغل محليًا (شوف دليل إعداد Hermes Desktop عندنا)
- تيليجرام مثبّت عندك على الجوال أو الكمبيوتر
هنا اللحظة اللي يتحول فيها الوكيل من برنامج تفتحه إلى شي يعيش معك: ترسله رسالة من جوالك — «اجلب أرقام المبيعات من تقرير الأمس وجهز مسودة الإيميل» — وقبل تخلص قهوتك، المسودّة جاهزة بنفس المحادثة.
هذا Hermes على تيليجرام. نفس الوكيل، نفس الأدوات، نفس الذاكرة اللي بطرفيتك — متاح من أي مكان. الإعداد ياخذ دقائق، وهذا الدليل يتضمن خطوات الأمان اللي تخليه آمنًا وهو شغال.
ليش تيليجرام تحديدًا؟
لأنه يحول الوكيل من مكان تروح له إلى شي يتكلم معك. ثلاث مكاسب عملية:
- متاح من كل مكان — وصول كامل للأدوات من جوالك أو تابتك أو أي كمبيوتر فيه تيليجرام.
- صوتي بالطبيعة — أرسل رسالة صوتية؛ توصلك محولة نصًا. واطلب ردود منطوقة وتوصلك فقاعات صوت قابلة للتشغيل.
- قناة إشعارات طبيعية — المهام المجدولة تسلم نتايجها داخل المحادثة، فموجز الصبح يوصلك بالمكان اللي تطلع عليه أصلًا.
ديسكورد وسلاك وواتساب وغيرها تشتغل بنفس البوابة؛ الخطوات تتشابه والنموذج واحد. تيليجرام بس هو الأسرع ضبطًا.
إنشاء البوت: دقيقتين مع BotFather
كل بوت تيليجرام يبدأ بنفس الطريقة — عبر @BotFather:
- افتح تيليجرام ورسل @BotFather.
- أرسل
/newbot. - اختر اسم عرض — أي شي («Hermes حق عمر»).
- اختر اسم مستخدم — فريد عالميًا ولازم ينتهي بـ
bot. - انسخ API Token من الرد. بيكون بشكل
123456789:ABCdefGHI....
هذا التوكن الحين أخطر سلسلة بالإعداد كله: اللي يمسكه هو بوتك. مكانه مخزن أسرار Hermes وبس — لا بلقطات شاشة، لا مستودعات، لا محادثات. انسرب؟ /revoke في BotFather يبطله فورًا وتوكن جديد ياخذ مكانه.
وبينك هناك، تحسينات اختيارية: /setdescription و/setabouttext يعطون بوتك ملف تعريف ودود، و/setcommands تبني القائمة اللي تظهر لمن يضغط زر /.
الربط: طريق المعالج
على الجهاز اللي فيه Hermes:
hermes gateway setupاختر Telegram. الصق التوكن لما يُطلب. ولما يسألك مين مسموح له بالدخول، أعطه رقمك التعريفي — الرقم من @userinfobot، مو اسم المستخدم @. المعالج يكتب كل شي صح وخلاص.
البديل اليدوي إذا تحب: أضف هالسطور إلى ~/.hermes/.env —
TELEGRAM_BOT_TOKEN=123456789:ABCdef...
TELEGRAM_ALLOWED_USERS=123456789بعدها شغّل البوابة:
hermes gatewayخلال ثوانٍ البوت يظهر متصل بقائمة جهاتك. قل هلا. أعطه مهمة حقيقية — «اعرض ملفات PDF بمجلد مستنداتي» — وراقبه يشتغل وأنت بالغرفة الثانية.
وش تقدر تسوي من المحادثة؟
الجواب القصير: كل شي. والنسخة الطويلة المفيدة:
- شغل وكيل حقيقي: ملفات جهازك، بحث بالإنترنت، تحليل مستندات، إصلاح كود — نفس مجموعة أدوات الطرفية.
- أوامر السلاش:
/helpو/new(محادثة جديدة) و/modelو/topicلمحادثات متوازية منفصلة. - الموافقات داخل الشات: الأوامر الخطيرة تطلع سؤال نعم/لا بنفس المحادثة — ما يصير شي مدمر من جيبك بدون موافقة.
- تسليم الملفات: المستندات والجداول والصور والأرشيفات توصلك مرفقات تيليجرام أصلية.
- التسليمات المجدولة: اربطها مع الكرون (المقال الأخير بالسلسلة) وموجزاتك اليومية توصل هنا تلقائيًا.
الأمان والخصوصية، بجدية
الوكيل المتصل بمنصة مراسلة يستاهل حذر أكثر من جلسة طرفية، لأن أي أحد يوصله يرث قدراته. الأساسيات:
السماح بالأرقام فقط. TELEGRAM_ALLOWED_USERS هو البوابة. بدون يرفض الجميع افتراضيًا — زين — لكن اضبطه برقمك صراحة وعامل أي إضافة كقرار مقصود.
احمِ التوكن. مكانه .env على الجهاز اللي يشغل Hermes. أبداً في git، أبداً بلقطة شاشة. انكشف؟ /revoke وإعادة الإصدار بدقائق.
افترض إن البوت = الجهاز. كل الملفات والصلاحيات الموجودة على الجهاز المضيف ضمن متناول الوكيل، فشغّله بمكان مناسب. تنبيهات الموافقة للعمليات الخطورة طبقتك الثانية — لا تدرب نفسك على الرد «نعم» تلقائيًا.
المجموعات تزيد الانكشاف. استخدام المجموعات يتطلب تعطيل وضع الخصوصية أو منح صلاحية أدمن، وذا يخلّي البوت يشوف الرسائل العادية. سوها بوعي، وفضّل إعداد «يراقب بدون ما يرد»، وخلي قائمة السماح ضيقة بأي حال.
حل المشاكل: المشاكل الأربع الحقيقية
| العرض | السبب والحل |
|---|---|
| البوت صامت، ما فيه رد | البوابة مو شغالة أو التوكن غلط — راجع مخرجات hermes gateway |
| يرد «Unauthorized» | رقمك ناقص أو غلط بـ TELEGRAM_ALLOWED_USERS — تحقق عبر @userinfobot |
| يتجاهل رسائل المجموعة | وضع الخصوصية — عطّله من BotFather أو رقّه أدمن، وبعدها احذفه وأعد إضافته |
| الصوتيات ما تنحول | اضبط تحويل الصوت لنص (faster-whisper محلي أو مفتاح مزود) |
ونمطة أخيرة تستاهل الحفظ: بعد أي تغيير بوضع الخصوصية، احذف البوت من المجموعة وأعده. تيليجرام يخزن الحالة القديمة — ها الفخ يوقع بأي أحد مرة وحدة.
الخطوة الجاية
وكيلك الحين يمشي معك بكل مكان. المقال الأخير بالسلسلة يخليه مبادر: مهارات Hermes والنماذج والأتمتة يغطي المهارات القابلة لإعادة الاستخدام، واختيار النموذج بوعي، وجدولة مهام تسلم نتايجها مباشرة لهذي المحادثة.
فاتك الأساسيات؟ إعداد Hermes Desktop يجهز الجانب المحلي، وما هو Hermes Agent؟ يشرح ليش هذا كله ممكن.
الخطوات
الخطوة 1: أنشئ البوت من BotFather
بتيليجرام، افتح محادثة مع @BotFather (البوت الرسمي لإدارة البوتات) وأرسل /newbot. اختر اسم عرض (أي شي)، بعدها اسم مستخدم لازم يكون فريد وينتهي بكلمة bot مثل omar_hermes_bot. يرد عليك BotFather بـ API Token يشبه 123456789:ABCdef... — هذا هوية البوت وكلمة سره بسطر واحد.
ملاحظة: عامل التوكن معاملة كلمة السر. أي أحد يمسكه يتحكم بالبوت. إذا انسرب يوم، اسحبه فورًا بأمر /revoke في BotFather.
الخطوة 2: أوجد رقم المستخدم مالك
Hermes يديح الدخول حسب الرقم التعريفي للمستخدم — مو حسب اسم المستخدم @. أرسل رسالة لـ @userinfobot (أو @get_id_bot) ويرد عليك فورًا برقم مثل 123456789. احفظه؛ الخطوة الجاية تطلب منه.
ملاحظة: هذا الرقم هو كيف تعرف البوابة أنه مين المسموح له. كل مستخدم جديد بالمستقبل بيحتاج رقمه هو.
الخطوة 3: شغّل معالج البوابة
على الجهاز اللي فيه Hermes، نفّذ `hermes gateway setup`، اختر Telegram، والصق التوكن ورقمك لما يسألك. المعالج يكتب الإعدادات عنك — بدون تعديل يدوي للملفات. تحب يدوي؟ أضف TELEGRAM_BOT_TOKEN وTELEGRAM_ALLOWED_USERS إلى ~/.hermes/.env بدالها.
ملاحظة: المفاتيح بمكانها .env والإعدادات بمكانها config.yaml — إذا ضبطت يدوي، حافظ على الفصل.
الخطوة 4: شغّل البوابة وقل هلا
نفّذ `hermes gateway`. البوت يطلع متصل خلال ثوانٍ. أرسل له رسالة من جوالك — «وش الموجود بمجلد المنزل عندي؟» — وشوفه يجاوب بعد ما يفحص فعلاً، مو بعد ما يخمّن. والرسائل الصوتية تشتغل أيضًا: توصلك محوّلة لنص تلقائيًا.
ملاحظة: البوابة لازم تبقى شغالة عشان البوت يظل متصل. على جهازك الخاص، يعني طرفية مفتوحة أو خدمة بالخلفية.
أخطاء شائعة — وكيف تتجنبها
الخطأأنشأنا البوت ولصقنا التوكن وما فيه أي رد.
الصحتأكد إنه `hermes gateway` شغّال فعلاً، واقرأ مخرجاته لوج للأخطاء — توكن غلط يظهر هناك فورًا.
الخطأالبوت يرد عليك «unauthorized» أنت تحديدًا.
الصحرقمك الرقمي مو موجود بـ TELEGRAM_ALLOWED_USERS. تحقق منه مرة ثانية عبر @userinfobot — أسماء المستخدمين ما تنحسب.
الخطأيشتغل بالمحادثة الخاصة ويتجاهل المجموعة.
الصحهذا وضع الخصوصية. عطّله من BotFather (Bot Settings ← Group Privacy) أو رقّ البوت أدمن — بعدها احذف البوت من المجموعة وأعده، عشان تيليجرام يطبق التغيير.
الخطأالرسائل الصوتية ترجع ملفات صامتة بدال الفقاعات.
الصحثبّت ffmpeg — يحول صوت النص-إلى-كلام لفقاعات رسائل صوتية سليمة بتيليجرام.
الخطأتشارك البوت مع أصحابك بإضافة أسمائهم.
الصحالدخول حسب الأرقام فقط. خذ رقم كل شخص من @userinfobot وأضف الأرقام مفصولة بفواصل.
❓ أسئلة شائعة
البوت يوصل لكل كمبيوتري؟
له نفس صلاحيات تنصيب Hermes المحلي — نفس الأدوات والأذونات مثل جلسات الطرفية عندك. وعشان كذا قائمة المستخدمين المسموحين وتنبيهات الموافقة مهمة: هي اللي تحدد مين يوصل لهالأدوات عن بعد.
البوت مجاني؟
بوتات تيليجرام مجانية تمامًا. تدفع فقط مقابل استخدام النموذج خلف الوكيل، تمامًا مثل تشغيل Hermes محليًا.
أحد ثاني يقدر يستخدم بوتي؟
فقط الأرقام الموجودة في TELEGRAM_ALLOWED_USERS تقدر تتفاعل؛ الباقي يُرفض تلقائيًا. للاستخدام المشترك، أضف رقم كل شخص بقرار واعي — والأفضل تراجع توثيق الأمان قبل ما تفتحه لأحد.
وش يصير لما يكون اللابتوب مقفل؟
البوت يطلع غير متصل أيضًا — البوابة تشتغل بنفس مكان Hermes. المهام المجدولة تنتظر رجوعه. الوكيل الدائم يحتاج جهاز دائم التشغيل (جهاز قديم، سيرفر منزلي، أو سحابة).
الرسائل الصوتية تشتغل فعلاً؟
نعم — رسائل الصوت الواردة تنحوّل نصًا تلقائيًا، والوكيل يقدر يرد بصوت. تحويل الصوت لنص يستخدم نموذجًا محليًا أو مفتاح مزود مضبوط، والردود الصوتية الصادرة تحتاج ffmpeg مثبت.