كيفية إبقاء Hermes Agent قيد التشغيل على خادم على مدار الساعة

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

فيما يلي شرح لتثبيت Hermes على خادم Linux عادي، وتحويل البوابة إلى خدمة تعمل باستمرار وتبدأ تلقائيًا بعد إعادة التشغيل، وتقييد الوصول حتى لا يتمكن الغرباء من الدخول إلى الطرفية. يستند هذا الدليل إلى الوثائق الرسمية.

إذا لم تثبّت Hermes بعد، فابدأ بالنظرة العامة المنفصلة حول ماهية هذا الوكيل وكيفية تثبيته. يفترض هذا الدليل أنك تشغّله بالفعل على جهازك، ويتناول نقله إلى خادم فقط.

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

لماذا تنقل Hermes Agent من حاسوب محمول إلى خادم؟#

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

هنا يتضح اختلاف الخادم: فهو لا يدخل في وضع السكون ولا يعتمد على أي شيء آخر. تثبّت عليه Hermes نفسه، فيعمل من دونك: يرد على Telegram في الثالثة صباحًا، ويجمع الأخبار حول الموضوعات التي تهمك كل صباح، ويحافظ على الجلسات بين مرات التشغيل.

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

ما الذي ينبغي تحضيره قبل تثبيت Hermes على VPS؟#

حضّر ثلاثة أمور قبل التثبيت.

الخادم. يكفي VPS عادي يعمل بنظام Linux. يذكر التوثيق أن الدعم من المستوى الأول يشمل Linux وWSL2، وأن الاختبارات تُجرى على أحدث إصدار من Ubuntu. إذا كان النظام يحتوي على glibc وsystemd وبنية أدلة مألوفة، فسيُثبّت Hermes على نحو سليم. وهذا مهم على الخادم لأن جميع خطوات بدء التشغيل التلقائي أدناه تعتمد على systemd، المتوفر افتراضيًا في Ubuntu وDebian.

الوصول عبر SSH. تتصل بالخادم عبر طرفية باستخدام SSH؛ ولن تستخدم هناك فأرة. تُنفّذ جميع الأوامر أدناه في جلسة SSH هذه. إذا كنت تبرمج بأسلوب vibe coding ولم تعتد على الطرفية بعد، فلا تقلق: الأوامر قليلة ويمكنك نسخ كل أمر كاملًا.

نموذج مختار. لا يفكر الوكيل من تلقاء نفسه؛ بل يستدعي نموذجًا. ومن المهم أن الوصول إلى النموذج لا تنتهي صلاحيته على خادم يعمل من دونك. أبسط خيار هو اشتراك Nous Portal عبر hermes setup --portal: يستخدم تسجيل الدخول OAuth، ويتجدد الرمز تلقائيًا. ويمكنك أيضًا استخدام مفاتيح API الخاصة بك، لكن تأكد من وجود رصيد في الحساب؛ فالوكيل الذي يعمل بلا واجهة ولديه رصيد فارغ سيتوقف ببساطة. يجب أن تكون نافذة السياق للنموذج 64,000 رمز على الأقل، وإلا سيرفض Hermes بدء التشغيل به. تستوفي جميع النماذج السحابية في القائمة هذا الشرط.

كيف تثبّت Hermes Agent على خادم بأمر واحد؟#

يكاد التثبيت على خادم يماثل التثبيت على حاسوب محمول، مع اختلاف واحد: لا يحتاج الوكيل عادةً إلى متصفح هناك. كما تتطلب أتمتة المتصفح Chromium، وهو برنامج كبير الحجم. لذلك تستخدم الخيار --skip-browser.

1. اتصل بالخادم عبر SSH

   ssh root@your-server-address
   

   نفّذ جميع الأوامر التالية ضمن هذه الجلسة، على الخادم نفسه.

2. شغّل أداة التثبيت من دون المتصفح

   curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-browser
   

   يحمّل النص البرمجي البيئة المطلوبة ويثبّت الأمر hermes. يتخطى الخيار --skip-browser تثبيت أتمتة المتصفح؛ فهي لن تشغل سوى مساحة على خادم بلا واجهة رسومية. وإذا احتجت إلى متصفح لاحقًا، يمكنك تثبيته على حدة.

3. أعد تشغيل الصدفة واختر نموذجًا

   source ~/.bashrc
   hermes setup --portal
   

   يحمّل السطر الأول قيمة PATH الجديدة لكي يصبح الأمر hermes متاحًا. ويفتح السطر الثاني تسجيل الدخول إلى Nous Portal: أكّد تسجيل الدخول، وسيحصل الوكيل على نموذج وخدمات من دون مفاتيح منفصلة لكل منها.

4. تحقّق من التثبيت

   hermes doctor
   

   يعرض الأمر ما تم تثبيته، وما ينقص، وكيفية إصلاحه. تعني العلامات الخضراء أن كل شيء جاهز.

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

كيف تُبقي Hermes قيد التشغيل على مدار الساعة؟#

البوابة عملية Hermes واحدة تعمل في الخلفية، وتحافظ على الاتصالات بجميع تطبيقات المراسلة، وتدير الجلسات، وتشغّل المهام المجدولة. ويتمحور التشغيل على مدار الساعة حولها. الهدف هو جعل هذه العملية تبدأ تلقائيًا وتظل قيد التشغيل.

أولًا، أعد إعداد البوابة واربط تطبيق مراسلة:

hermes gateway setup

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

بعد ذلك يأتي المأزق الذي ينساه الناس غالبًا. إذا شغّلت hermes gateway ببساطة، فلن تستمر العملية إلا ما دامت جلسة SSH مفتوحة. أغلق الطرفية، فتتوقف البوابة. لإبقائها قيد التشغيل باستمرار، عليك إخضاعها لإدارة النظام. لذلك يوجد أمر واحد:

hermes gateway install

يثبّت البوابة كخدمة: خدمة systemd للمستخدم على Linux، أو عبر launchd على macOS. يراقب النظام العملية ويعيد تشغيلها إذا تعطلت.

على الخادم، ستحتاج غالبًا إلى الخيار الثاني: خدمة نظام تبدأ عند إقلاع الجهاز، قبل أن يسجّل أي مستخدم الدخول:

sudo hermes gateway install --system

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

hermes gateway start     # بدء التشغيل
hermes gateway stop      # الإيقاف
hermes gateway status    # التحقق من الحالة

بالنسبة إلى خدمة النظام، أضف sudo والخيار --system إلى هذه الأوامر. وإلا فستستهدف الأوامر خدمة المستخدم بدلًا من الخدمة التي تبدأ عند الإقلاع:

sudo hermes gateway start --system
sudo hermes gateway stop --system
sudo hermes gateway status --system

لماذا نحتاج إلى linger، وما الذي يتعطل من دونه؟#

هذه أكثر العقبات شيوعًا: ثبّت الخدمة، لكن البوت لا يزال يصمت ليلًا. والسبب هو طريقة عمل خدمات المستخدم في Linux.

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

يمكنك حل ذلك باستخدام وضع linger، الذي يتيح للنظام إبقاء مدير المستخدم قيد التشغيل حتى عندما لا يكون ذلك المستخدم مسجّلًا للدخول:

sudo loginctl enable-linger username

بعد هذا الأمر، تعمل خدمة المستخدم من تلقاء نفسها وتبدأ عند إقلاع الخادم، من دون انتظار تسجيل دخولك. ومن دون linger، يعود السلوك إلى ما كان عليه: تتوقف البوابة عند خروجك من SSH ولا تبدأ عند الإقلاع. ويذكر التوثيق ذلك صراحةً.

كيف تشغّل Hermes على خادم داخل Docker مع إعادة التشغيل التلقائية؟#

Docker طريقة أخرى فعالة لإبقاء الوكيل على خادم، لا سيما إذا كنت معتادًا على الحاويات أو تريد عزل الوكيل عن النظام الرئيسي. أعد الإعداد مرة واحدة باستخدام docker run ... setup، ثم شغّل الحاوية في الخلفية:

docker run -d \
  --name hermes \
  --restart unless-stopped \
  -v ~/.hermes:/opt/data \
  -p 8642:8642 \
  nousresearch/hermes-agent gateway run

إليك ما تفعله الأسطر المسؤولة عن التشغيل على مدار الساعة:

• -d — تعمل الحاوية في الخلفية ولا تُبقي الطرفية مفتوحة.
• --restart unless-stopped — يعيد Docker تشغيل الحاوية بعد إعادة تشغيل الخادم أو تعطلها. ولن يعيد تشغيلها فقط إذا أوقفتها يدويًا.
• -v ~/.hermes:/opt/data — تبقى الإعدادات والمفاتيح والجلسات والذاكرة على الخادم خارج الحاوية، وتظل محفوظة عند إعادة إنشائها.

تضيف الصورة وسيلة حماية أخرى: تعمل عملية البوابة تحت إشراف s6. إذا تعطلت البوابة، يُعاد تشغيلها خلال بضع ثوانٍ من دون فقدان الحاوية نفسها. وهذه حماية مزدوجة: يحافظ Docker على تشغيل الحاوية من الخارج، بينما يراقب s6 العملية من الداخل.

تذكّر فرقًا واحدًا في نهج Docker: لا تُحدّث هذه التثبيتات باستخدام الأمر hermes update. للتحديث في Docker، استبدل الصورة بأخرى جديدة: نزّل أحدث صورة وأعد إنشاء الحاوية.

كيف تتحقق من أن كل شيء يعمل وأنه سيصمد أمام إعادة التشغيل؟#

لخدمة المستخدم، تحقّق من الحالة والسجلات كما يلي:

hermes gateway status
journalctl --user -u hermes-gateway -f

لخدمة النظام الموصى بها على VPS، استخدم نطاق النظام بدلًا من ذلك:

sudo hermes gateway status --system
sudo journalctl -u hermes-gateway -f

يفحص الأول الخدمة المختارة ويتابع الثاني سجل نطاقها. تنطبق أسماء الوحدات على تثبيت ~/.hermes الافتراضي. قد تحمل مواضع Hermes الأخرى لاحقة في اسم الوحدة؛ افحص الحالة واستخدم الاسم الدقيق. لا تراقب وحدة مستخدم عند اختبار تثبيت نظام. توجد سجلات Hermes في ~/.hermes/logs/، وتُحجب الأسرار منها تلقائيًا، لذا يمكنك إرسالها إلى الدعم بأمان.

والآن أعد تشغيل الخادم وتأكد من أن الوكيل يعود للعمل تلقائيًا. هذا هو الاختبار الأهم للخادم، وغالبًا ما ينساه الناس:

sudo reboot

بعد عودة الوصول إلى الخادم، أعد الاتصال عبر SSH. لتثبيت النظام، افحص sudo hermes gateway status --system وسجل النظام؛ ولتثبيت المستخدم مع linger، افحص hermes gateway status وسجل المستخدم. ثم أرسل رسالة للبوت على Telegram. إذا رد من دون تدخلك، فالإعداد التلقائي لبدء التشغيل صحيح. وهذا هو الغرض من كل ما سبق.

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

كيف تؤمّن وكيلًا لديه وصول إلى الطرفية على خادم؟#

الوكيل على الخادم برنامج لديه وصول إلى الطرفية ويعمل من دون إشرافك. تحقّق أولًا من هذه الإعدادات الثلاثة.

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

TELEGRAM_ALLOWED_USERS=123456789,987654321

تأكيد الأوامر الخطرة. يطلب الوكيل إذنك قبل تنفيذ أي عمل تدميري. يوجد وضع YOLO يعطّل التأكيدات؛ ومن الأفضل عدم تفعيله على خادم يعمل من دونك. فالتأكيدات موجودة تحديدًا لمنع حدوث أي أمر لا رجعة فيه من دون علمك.

بيئة معزولة للعزل الكامل. إذا أردت منع الوكيل ماديًا من رؤية النظام الرئيسي للخادم، شغّل أوامره داخل حاوية Docker:

hermes config set terminal.backend docker

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

ماذا تفعل إذا لم يرد البوت أو تعطلت البوابة؟#

عندما يتوقف البوت عن الرد، اتبع هذا الترتيب. افحص أولًا النطاق الذي ثبته: sudo hermes gateway status --system وسجل النظام لخدمة النظام، أو hermes gateway status وسجل المستخدم لخدمة المستخدم. إذا كانت البوابة تعمل لكن الرسائل لا تصل، فالمشكلة في الغالب إعدادات المنصة: رمز البوت غير صحيح أو الشخص غير مدرج في قائمة الوصول. شغّل hermes gateway setup مجددًا في موضع Hermes نفسه، ثم افحص الخدمة المختارة عبر hermes gateway status --system للنظام أو hermes gateway status للمستخدم. نجاح الإعداد لا يثبت تشغيل البوابة الصحيحة.

إذا أعاد النموذج ردودًا فارغة أو غريبة، فتحقّق منه باستخدام hermes model وتأكد من المزوّد وتسجيل الدخول. تسلسل الاستعادة العام للانتقال من حالة «كل شيء معطّل» إلى العمل من جديد هو: hermes doctor، ثم hermes model، ثم hermes setup، ثم hermes gateway status --system لتثبيت النظام أو hermes gateway status لتثبيت المستخدم.

هناك أمر آخر للحالة النادرة والمزعجة التي تتجمد فيها العملية كلها من دون أن تتعطل فعليًا. تتضمن خدمة systemd مؤقت watchdog: أضف هذا السطر إلى ~/.hermes/config.yaml وأعد تثبيت الخدمة.

gateway:
  systemd_watchdog_seconds: 120

# خدمة نظام VPS، في موضع Hermes نفسه الذي استُخدم أصلًا:
sudo hermes gateway install --system --force
sudo hermes gateway status --system

ولخدمة مستخدم بدلًا منها، أعد إنشاء ذلك النطاق فقط عبر hermes gateway install --force وافحص hermes gateway status. اختر نطاقًا واحدًا؛ ولا تثبت الاثنين لإصلاح بوابة واحدة.

بعد ذلك، ترسل البوابة إشارة منتظمة إلى النظام تقول فيها: «أنا أعمل». وإذا توقفت الإشارات، يعيد systemd تشغيل العملية تلقائيًا. يعمل هذا على Linux مع systemd فقط، ويقتصر على تجمد العملية. ولا يؤثر مؤقت watchdog في انقطاع الشبكة العادي بين الخادم وتطبيق المراسلة.

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

تعرّف على Ailoot.