البوابة هي قلب Open Claw — خدمة واحدة طويلة الأمد تدير جميع جلسات الوكلاء وقنوات الرسائل وتنفيذ الأدوات واتصالات الأجهزة. يمر كل شيء عبر البوابة.
إنها خادم WebSocket يستمع للاتصالات من العملاء (تطبيق سطح المكتب والتطبيقات المحمولة ولوحة تحكم الويب) ويدير دورة حياة المساعد الذكي بالكامل.
| الوضع | الوصف | |------|-------------| | Loopback | الافتراضي. لا يمكن الوصول إليه إلا من localhost (127.0.0.1) | | LAN | يمكن الوصول إليه على شبكتك المحلية. قابل للاكتشاف تلقائياً عبر Bonjour/mDNS | | Tailnet | يمكن الوصول إليه عبر Tailscale VPN مع MagicDNS | | مخصص | الارتباط بعنوان محدد |
| الطريقة | الوصف | |--------|-------------| | الرمز | رمز حامل WebSocket (UUID أو سلسلة مخصصة) | | كلمة المرور | مصادقة مبنية على كلمة المرور (مشفرة بـ bcrypt) | | الوكيل الموثوق | للوكلاء العكسيين مع رؤوس المصادقة المسبقة | | الثقة المحلية | اتصالات Loopback تتم الموافقة عليها تلقائياً |
تُكوَّن البوابة عبر openclaw.json (تنسيق JSON5). الأقسام الرئيسية:
| القسم | التحكم |
|---------|----------|
| agents | قائمة الوكلاء والافتراضيات ومساحات العمل |
| gateway | المنفذ ووضع الارتباط والمصادقة وسلوك إعادة التحميل |
| channels | إعداد ولكل قناة وبيانات الاعتماد |
| tools | أذونات الأدوات والملفات التعريفية والأمان |
| plugins | تحميل الإضافات وتفعيلها وإعداد كل إضافة |
| models | مصادقة الموفر والاحتياطيات وإعدادات الموفر |
| skills | أدلة المهارات وإعداد كل مهارة |
| browser | ملفات تعريف المتصفح والمنافذ والوضع بدون رأس |
| cron | إعداد المجدول |
| session | قواعد إعادة الضبط وعتبات الضغط |
| messages | إعدادات TTS وسياسات الوسائط |
| memory | إعداد فهرسة الذاكرة |
| security | التحديد ببيئة معزولة والوضع المرتفع والموافقات |
يمكن تطبيق تغييرات الإعداد دون إعادة التشغيل:
| الوضع | السلوك | |------|----------| | هجين (الافتراضي) | تطبيق التغييرات الآمنة ساخناً، إعادة التشغيل للأخرى | | ساخن | تطبيق التغييرات الآمنة للساخن فقط، تجاهل الأخرى | | إعادة تشغيل | إعادة التشغيل عند أي تغيير يتطلب إعادة التحميل | | إيقاف | بدون إعادة تحميل تلقائية |
يوفر Tailscale وصولاً آمناً عن بُعد بدون تكوين:
إعادة توجيه منفذ البوابة عبر SSH:
نقطة نهاية HTTP /health تُرجع:
عند الارتباط بـ LAN، تعلن البوابة عن نفسها عبر DNS متعدد البث:
_openclaw-gw._tcpاكتشاف البوابات عبر شبكتك مع مهلات قابلة للتكوين. يدعم كل من Bonjour المحلي واكتشاف Tailscale DNS.
يمكنك تشغيل مثيلات بوابة متعددة على نفس الآلة باستخدام الملفات التعريفية:
تتحقق أداة التشخيص المدمجة من:
يمكنها إصلاح العديد من المشكلات تلقائياً عند منحها الإذن.
تُكتب سجلات البوابة في ملفات JSONL يومية: