Skip to main content
تحتاج معظم عمليات الإعداد إلى Gateway واحد، إذ يتولى Gateway واحد عدة اتصالات مراسلة ووكلاء. شغّل Gateways منفصلة بملفات تعريف/منافذ معزولة فقط عندما تحتاج إلى عزل أقوى أو تكرار احتياطي (مثل روبوت إنقاذ).

​
البدء السريع لروبوت الإنقاذ

أبسط إعداد لروبوت الإنقاذ:
  • أبقِ الروبوت الرئيسي على ملف التعريف الافتراضي.
  • شغّل روبوت الإنقاذ على --profile rescue، باستخدام رمز Telegram خاص به.
  • ضع روبوت الإنقاذ على منفذ أساسي مختلف، مثل 19789.
يتيح ذلك لروبوت الإنقاذ تصحيح الأخطاء أو تطبيق تغييرات الإعدادات إذا كان الروبوت الأساسي متوقفًا. اترك 20 منفذًا على الأقل بين المنافذ الأساسية كي لا تتعارض منافذ المتصفح/CDP المشتقة مطلقًا.
إذا كان روبوتك الرئيسي قيد التشغيل بالفعل، فهذا عادةً كل ما تحتاج إليه. إذا كانت عملية الإعداد الأولي قد ثبّتت خدمة الإنقاذ بالفعل، فتخطَّ الأمر الأخير gateway install. أثناء openclaw --profile rescue onboard:
  • استخدم رمز روبوت Telegram منفصلًا ومخصصًا لحساب الإنقاذ (يسهل إبقاؤه مقتصرًا على المشغّل، ومستقلًا عن تثبيت قناة/تطبيق الروبوت الرئيسي، ويوفر مسار استرداد بسيطًا قائمًا على الرسائل المباشرة).
  • احتفظ باسم ملف التعريف rescue.
  • استخدم منفذًا أساسيًا أعلى من منفذ الروبوت الرئيسي بمقدار 20 على الأقل.
  • اقبل مساحة عمل الإنقاذ الافتراضية ما لم تكن تدير واحدة بنفسك بالفعل.

​
ما الذي يغيّره --profile rescue onboard

يشغّل --profile rescue onboard تدفق الإعداد الأولي المعتاد، لكنه يكتب كل شيء في ملف تعريف منفصل، وبذلك يحصل روبوت الإنقاذ على ما يخصه من:
  • ملف التعريف/الإعدادات
  • دليل الحالة
  • مساحة العمل (الافتراضية: ~/.openclaw/workspace-rescue)
  • اسم الخدمة المُدارة
  • المنفذ الأساسي (بالإضافة إلى المنافذ المشتقة)
  • رمز روبوت Telegram
أما المطالبات الأخرى فهي مطابقة للإعداد الأولي المعتاد.

​
الإعداد العام لعدة Gateways

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

​
قائمة التحقق من العزل

أبقِ هذه الإعدادات فريدة لكل مثيل من Gateway: تؤدي مشاركة أي من هذه العناصر إلى تعارضات في الإعدادات أو الحالة أو المنافذ. يفرض بدء تشغيل Gateway ملكية فريدة لدليل الحالة حتى عندما يتجاوز OPENCLAW_ALLOW_MULTI_GATEWAY=1 المثيل المفرد لكل ملف إعدادات.

​
تعيين المنافذ (المشتقة)

المنفذ الأساسي = gateway.port (أو OPENCLAW_GATEWAY_PORT / --port).
  • منفذ خدمة التحكم في المتصفح = المنفذ الأساسي + 2 (واجهة الاسترجاع فقط).
  • يُقدَّم مضيف Canvas على خادم HTTP الخاص بـ Gateway نفسه (المنفذ نفسه المستخدم بواسطة gateway.port).
  • تُخصَّص منافذ CDP لملفات تعريف المتصفح تلقائيًا من browser control port + 9 إلى + 108.
إذا تجاوزت أيًا من هذه القيم في الإعدادات أو متغيرات البيئة، فيجب إبقاؤها فريدة لكل مثيل.

​
ملاحظات المتصفح/CDP (مأزق شائع)

  • لا تثبّت browser.cdpUrl على القيمة نفسها في عدة مثيلات.
  • يحتاج كل مثيل إلى منفذ تحكم في المتصفح ونطاق CDP خاصين به (مشتقين من منفذ Gateway الخاص به).
  • لإعداد منافذ CDP صراحةً، اضبط browser.profiles.<name>.cdpPort لكل مثيل.
  • بالنسبة إلى Chrome البعيد، استخدم browser.profiles.<name>.cdpUrl (لكل ملف تعريف ولكل مثيل).

​
مثال يدوي لمتغيرات البيئة

​
فحوصات سريعة

  • يكتشف gateway status --deep خدمات launchd/systemd/schtasks القديمة المتبقية من عمليات تثبيت سابقة.
  • لا يُتوقع ظهور نص تحذير gateway probe، مثل multiple reachable gateway identities detected، إلا عندما تشغّل عمدًا أكثر من Gateway معزول واحد، أو عندما يتعذر على OpenClaw إثبات أن أهداف الفحص القابلة للوصول هي Gateway نفسه. يُعد نفق SSH أو عنوان URL للوكيل أو عنوان URL بعيدًا مُعدًّا يشير إلى Gateway نفسه Gateway واحدًا له عدة وسائل نقل، حتى عندما تختلف منافذ النقل.

​
ذو صلة