Hermes Agent Webapp: الإعداد والوصول من الهاتف وتسجيل الدخول

ما هو Webapp

تستطيع البوابة أن تقدّم مساحة عمل Desktop على منفذ استماع خاص بها. بحسب الوثائق، تغطي نسخة المتصفح الجلسات والملفات الشخصية وCapabilities وMessaging وArtifacts والمهام المجدولة وشجرة ملفات المضيف ومراجعة Git والمعاينات وشريط الطرفية. تعمل المحادثات على البوابة، وهي العملية نفسها التي تخدم سطر الأوامر وتطبيق Desktop الأصلي وتطبيقات المراسلة لديك، فترى كل الواجهات محادثة واحدة بطابور واحد.

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

شغّله وافتحه

فعّله مرة واحدة، ثم أعد تشغيل البوابة، ثم افتحه:

hermes config set webapp.enabled true
hermes gateway restart
hermes webapp

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

• --no-open يطبع الرابط بدل فتح المتصفح. تقترحه الوثائق على macOS عندما قد يُفتح المتصفح في مكان لا تراه، مثل الاتصال عبر SSH.
• --status يبيّن هل تقدّم البوابة العاملة Webapp، وعلى أي عنوان.
• --sign-out يسجّل خروج كل المتصفحات دفعة واحدة.
• --build-only و --force-build و --skip-build تتحكم في بناء الحزمة.

لملف شخصي مسمّى، يفتح hermes -p work webapp Webapp على ذلك الملف الشخصي. والملفات الشخصية التي تخدمها البوابة الافتراضية تشارك Webapp الخاص بها.

كيف يعمل تسجيل الدخول

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

الوصول إلى Webapp من جهاز آخر مختلف. فبمجرد أن يكون webapp.host هو 0.0.0.0 أو ::، أو أن يكون webapp.public_url مضبوطًا، تفرض البوابة بوابة تسجيل دخول لوحة التحكم، ولا تنطبق روابط الاستخدام الواحد. تسجّل الدخول بحساب لوحة التحكم: اسم مستخدم وكلمة مرور لشبكة محلية أو VPN موثوقة، أو OAuth/OIDC لأي شيء مواجه للإنترنت. أما Settings → Web Access في التطبيق الأصلي فيسجّل الدخول بحساب Nous الخاص بك.

منفذ استماع البوابة للعملاء الأصليين (سطر الأوامر وواجهة الطرفية وتطبيق Desktop) لا يطلب تسجيل دخول أبدًا، مهما كان الإعداد.

افتحه من هاتف أو حاسوب آخر

أسهل طريق في تطبيق Desktop الأصلي: Settings → Web Access يشغّل Webapp للأجهزة الأخرى، خلف تسجيل الدخول بحساب Nous الخاص بك. يظهر فقط في التطبيق الأصلي على اتصاله المحلي، ولا يغيّره إلا ذلك التطبيق. الضغط على Start يبني Webapp عند الحاجة (قد يستغرق البناء الأول بضع دقائق)، ويحفظ الإعدادات، ويعيد تشغيل البوابة. وإذا كانت محادثة قيد التشغيل ترفض البوابة إعادة التشغيل وتعرض اللوحة «Restart needed».

يتيح Web Access طريقتين للوصول:

• This network. الأجهزة على شبكة Wi-Fi نفسها تفتح http://<this computer’s address>:<port>، حيث المنفذ هو webapp.port (القيمة 9120 ما لم تغيّرها، أو اختار Start منفذًا آخر لملف شخصي مستقل). هذا HTTP عادي، فهو غير مشفّر؛ فاستخدمه على شبكة تثق بها فقط.
• My own URL. عنوان HTTPS تشغّله أصلًا، مثل Tailscale Serve أو نفق أو وكيل عكسي، يوجّه إلى http://127.0.0.1:<port>. يُحفظ باسم webapp.public_url. وتقول الوثائق ألا تمرّر ذلك المنفذ من الراوتر مباشرة أبدًا.

بدون التطبيق الأصلي يمكنك ضبط المفاتيح نفسها يدويًا: webapp.host على 0.0.0.0 للأجهزة الأخرى، أو أبقِ المضيف على عنوان الحلقة المحلية واضبط webapp.public_url لوكيل أو نفق على الجهاز نفسه. كلاهما يحتاج إلى مزوّد تسجيل دخول للوحة التحكم؛ وبدونه تخدم البوابة العملاء الأصليين فقط ويبيّن hermes webapp --status السبب. أعد تشغيل البوابة بعد تغيير أي من هذه المفاتيح.

لطريق خاص يتجنب فتح المنافذ، راجع صفحتنا Hermes Agent مع Tailscale. وللهاتف عمومًا، بما في ذلك ما يستطيع Termux وiPhone فعله وما لا يستطيعانه، راجع Hermes Agent على هاتفك.

HTTPS، وما لا يعمل في المتصفح

يوصى بشدة باستخدام HTTPS للاستخدام عن بُعد. تعطّل المتصفحات الميزات التي تحتاج سياقًا آمنًا على عنوان HTTP عادي غير الحلقة المحلية (http://localhost و http://127.0.0.1 تُعدّ آمنة). وعلى عنوان شبكة محلية عبر HTTP عادي تفقد:

• عارض شاشة البوت؛
• الميكروفون، وهذا يشمل الإملاء والصوت المباشر وكلمة التنبيه عن بُعد؛
• قراءة الحافظة، وهذا يؤثر في اللصق في الطرفية ولصق الصور؛
• إشعارات النظام.

الأمران hermes webapp و hermes webapp --status يطبعان ملاحظة عندما يكون العنوان الذي يفتحه المتصفح HTTP عاديًا على مضيف آخر. وللإبقاء على هذه الميزات استخدم HTTPS عبر webapp.public_url أو نفق SSH إلى 127.0.0.1.

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

• الملفات التي تختارها أو تلصقها محدودة ب- 16 MiB لكل ملف.
• تُفتح روابط المواقع في تبويب منفصل. أما معاينات العناوين الصريحة فتستخدم إطارًا معزولًا، فالمواقع التي ترفض التضمين تحتاج إلى Open in browser.
• المحادثات المكتوبة قبل أن تملك البوابة الجلسات تحتاج إلى تبنٍّ قبل أن تتابعها في المتصفح. شغّل hermes sessions adopt مرة واحدة على المضيف، أو افتحها مرة في Desktop الأصلي أو TUI أو CLI. ولملف شخصي آخر استخدم hermes -p <profile> sessions adopt. أما الصفوف التي كتبتها عملية WebUI منفصلة بوكيل خاص بها، وتشغيلات cron أو الوكلاء الفرعيين القديمة، فتبقى للقراءة فقط.
• شريط الطرفية يفتح صدفة المضيف. التحديث أو انقطاع الاتصال يفصلها دون إنهاء الصدفة؛ وتُحفظ الصدفات المفصولة 15 دقيقة ما دامت البوابة تعمل، بحد 16 طرفية للمضيف بما فيها المفصولة، وإعادة تشغيل البوابة أو تحديثها تنهيها.

الأمان: تعامل معه كأنه وصول إلى المضيف

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

تفصيلان آخران يستحقان المعرفة. كل من يستطيع تسجيل الدخول إلى Webapp يستطيع استخدام كل بوابة محفوظة على ذلك الجهاز ضمن Settings → Gateways، بصفة صاحب بيانات الاعتماد المحفوظة، فاحفظ فقط البوابات التي تقبل أن يصلوا إليها. والأمر hermes webapp --sign-out ينهي تسجيل دخول كل تبويب؛ وخلف بوابة تسجيل الدخول يُخرج أيضًا كل متصفح استخدم حساب لوحة التحكم. أما التطبيق الأصلي الذي سجّل دخوله بنفسه فيبقى مسجّلًا.

Webapp وWeb Dashboard وhermes-webui

هذه ثلاثة أشياء مختلفة يسهل الخلط بينها:

يمكن تشغيل Webapp ولوحة التحكم معًا، لكل منهما منفذه وعنوانه العام. ويتشاركان مزوّدي تسجيل الدخول، فيعمل اسم المستخدم وكلمة المرور في كليهما. وعندما يستخدمان عميل تسجيل دخول Nous نفسه، لا يعمل تسجيل الدخول عبر Nous إلا على اسم المضيف المسجّل لذلك العميل؛ فاستخدم اسم مستخدم وكلمة مرور على الآخر. يستطيع Settings → Web Access في Desktop الأصلي تسجيل عميل Webapp منفصل ويترك عميل لوحة التحكم دون تغيير، لكن وثائق Docker تقول إن الحاوية بلا واجهة لا تملك أمرًا لذلك حتى الآن.

استكشاف الأخطاء بالأمر hermes webapp --status

ابدأ ب- hermes webapp --status. عندما لا تستطيع البوابة تقديم Webapp فإنها تخدم العملاء الأصليين، ويبيّن الأمر السبب. الأسباب الموثقة:

• المنفذ مشغول (غيّر webapp.port أو حرّره)؛
• تسجيل الدخول مطلوب (المضيف 0.0.0.0 أو ::، أو ضُبط public_url) ولم يُضبط أي مزوّد تسجيل دخول؛
• ملف تسجيل دخول المتصفح webapp/session-token في مجلد Hermes الرئيسي لا يمكن قراءته أو كتابته.

بعد معالجة السبب، شغّل hermes gateway restart، لأن الإعدادات تُقرأ عند البدء. وإذا كان المنفذ مشغولًا فإن البوابة تستبدل أيضًا تسجيل دخول Webapp، فتحتاج التبويبات المفتوحة إلى hermes webapp من جديد. وإذا لم تُبنَ الحزمة بعد يقول الأمر ذلك ويبنيها hermes webapp؛ وتقدّمها البوابة العاملة دون إعادة تشغيل. أما فشل البناء بعد hermes update فيُظهر Webapp غير متاح حتى يعيد hermes webapp بناءه.

في Docker أبقِ webapp.host على 0.0.0.0: فعنوان الحلقة المحلية الافتراضي يخص الحاوية نفسها ولا يستطيع منفذ منشور الوصول إليه. وداخل الحاوية يستمر --status في الإبلاغ عن التقديم على http://127.0.0.1:9120، وهذا متوقع. تأتي الصورة بWebapp مبنيًا مسبقًا. راجع صفحة Docker لأساسيات الحاوية.

Webapp وReadyHermes

تشغّل مساعدات ReadyHermes اليوم إصدارًا من Hermes Agent أقدم من 0.23 (تم التحقق في 12 نوفمبر 2026)، لذلك لا يمكن تشغيل Webapp في مساعد ReadyHermes بعد. ولا نعطي موعدًا.

ما زال بإمكانك الوصول إلى مساعدك من متصفح. مساحة عمل ReadyHermes موقع يعمل في متصفح الحاسوب أو الهاتف وفيه لوحة دردشة، ومساعدك يعمل دائمًا ومتصل بتطبيقات المراسلة التي تختارها، مثل Telegram وWhatsApp وDiscord وWeChat وLark. وإن كنت تفضّل تطبيق Hermes Desktop، فافتح القنوات ثم Hermes Desktop في مساحة العمل وانسخ عنوان URL البعيد وبيانات الدخول إلى إعدادات Remote gateway في التطبيق؛ والخطوات في صفحتنا Hermes Desktop. تبدأ الخطط من US$3.99 شهريًا مع US$1 من الذكاء الاصطناعي مشمولًا كل شهر على Lite (وUS$3 على Pro)، وتوجد تجربة مجانية لمدة ساعة.