الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
أفضل إعداد موصى به

لمعظم المستخدمين، أبسط إعداد لبوت الإنقاذ هو:
  • إبقاء البوت الرئيسي على ملف التعريف الافتراضي
  • تشغيل بوت الإنقاذ على --profile rescue
  • استخدام بوت Telegram منفصل تماما لحساب الإنقاذ
  • إبقاء بوت الإنقاذ على منفذ أساس مختلف مثل 19789
يبقي هذا بوت الإنقاذ معزولا عن البوت الرئيسي لكي يتمكن من تصحيح الأخطاء أو تطبيق تغييرات التكوين إذا كان البوت الأساسي متوقفا. اترك 20 منفذا على الأقل بين منافذ الأساس حتى لا تتعارض منافذ المتصفح/canvas/CDP المشتقة أبدا.

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

استخدم هذا كمسار افتراضي ما لم يكن لديك سبب قوي لفعل شيء آخر: 
# Rescue bot (separate Telegram bot, separate profile, port 19789)
openclaw --profile rescue onboard
openclaw --profile rescue gateway install --port 19789
إذا كان البوت الرئيسي يعمل بالفعل، فهذا عادة كل ما تحتاج إليه. أثناء openclaw --profile rescue onboard:
  • استخدم رمز بوت Telegram المنفصل
  • احتفظ بملف التعريف rescue
  • استخدم منفذ أساس أعلى من البوت الرئيسي بما لا يقل عن 20
  • اقبل مساحة عمل الإنقاذ الافتراضية ما لم تكن تدير واحدة بنفسك بالفعل
إذا كان الإعداد الأولي قد ثبت خدمة الإنقاذ لك بالفعل، فلن تكون خطوة gateway install الأخيرة مطلوبة.

​
لماذا يعمل هذا

يبقى بوت الإنقاذ مستقلا لأن لديه ما يخصه من:
  • ملف تعريف/تكوين
  • دليل حالة
  • مساحة عمل
  • منفذ أساس (إضافة إلى المنافذ المشتقة)
  • رمز بوت Telegram
لمعظم الإعدادات، استخدم بوت Telegram منفصلا تماما لملف تعريف الإنقاذ:
  • يسهل إبقاؤه للمشغلين فقط
  • رمز بوت وهوية منفصلان
  • مستقل عن تثبيت قناة/تطبيق البوت الرئيسي
  • مسار استرداد بسيط قائم على الرسائل المباشرة عندما يكون البوت الرئيسي معطلا

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

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

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

تخطيط بوت الإنقاذ أعلاه هو أسهل خيار افتراضي، لكن نمط العزل نفسه ينجح مع أي زوج أو مجموعة من Gateways على مضيف واحد. لإعداد أكثر عمومية، أعط كل Gateway إضافي ملف تعريف مسمى خاصا به ومنفذ أساس خاصا به: 
# main (default profile)
openclaw setup
openclaw gateway --port 18789

# extra gateway
openclaw --profile ops setup
openclaw --profile ops gateway --port 19789
إذا كنت تريد أن يستخدم كلا Gatewayين ملفات تعريف مسماة، فهذا يعمل أيضا: 
openclaw --profile main setup
openclaw --profile main gateway --port 18789

openclaw --profile ops setup
openclaw --profile ops gateway --port 19789
تتبع الخدمات النمط نفسه: 
openclaw gateway install
openclaw --profile ops gateway install --port 19789
استخدم البدء السريع لبوت الإنقاذ عندما تريد مسارا احتياطيا للمشغل. استخدم نمط ملفات التعريف العام عندما تريد عدة Gateways طويلة العمر من أجل قنوات أو مستأجرين أو مساحات عمل أو أدوار تشغيلية مختلفة.

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

حافظ على تفرد هذه العناصر لكل نسخة Gateway:
  • OPENCLAW_CONFIG_PATH — ملف تكوين لكل نسخة
  • OPENCLAW_STATE_DIR — جلسات وبيانات اعتماد وذاكرات تخزين مؤقت لكل نسخة
  • agents.defaults.workspace — جذر مساحة عمل لكل نسخة
  • gateway.port (أو --port) — فريد لكل نسخة
  • منافذ المتصفح/canvas/CDP المشتقة
إذا كانت هذه العناصر مشتركة، فستواجه سباقات تكوين وتعارضات منافذ.

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

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

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

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

​
مثال يدوي للبيئة

OPENCLAW_CONFIG_PATH=~/.openclaw/main.json \
OPENCLAW_STATE_DIR=~/.openclaw \
openclaw gateway --port 18789

OPENCLAW_CONFIG_PATH=~/.openclaw/rescue.json \
OPENCLAW_STATE_DIR=~/.openclaw-rescue \
openclaw gateway --port 19789

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

openclaw gateway status --deep
openclaw --profile rescue gateway status --deep
openclaw --profile rescue gateway probe
openclaw status
openclaw --profile rescue status
openclaw --profile rescue browser status
التفسير:
  • يساعد gateway status --deep في اكتشاف خدمات launchd/systemd/schtasks القديمة من التثبيتات السابقة.
  • نص تحذير gateway probe مثل multiple reachable gateways detected متوقع فقط عندما تشغل عمدا أكثر من gateway معزول واحد.

​
ذات صلة