تكوين Gateway

إعدادات متقدمة للخادم الأساسي لـ OpenClaw. هنا يمكنك ضبط المنفذ، الأمان، والأداء.

ملف التكوين:

Gateway هو الخادم الأساسي الذي يدير جميع الاتصالات والجلسات في OpenClaw. التكوين يكون في ~/.config/openclaw/config.json5

⚙️ الإعدادات الأساسية

المنفذ (Port)

المنفذ الذي يستمع عليه Gateway. الافتراضي: 18789

{
  gateway: {
    port: 18789
  }
}

عنوان الاستماع (Host)

  • 127.0.0.1: محلي فقط (آمن)
  • 0.0.0.0: يستمع على جميع الواجهات (احذر!)
{
  gateway: {
    host: "127.0.0.1"
  }
}

Control UI

تفعيل/تعطيل واجهة الويب للتحكم

{
  gateway: {
    enableWebUI: true
  }
}

🔒 إعدادات الأمان

⚠️ مهم جداً:

لا تعرّض Gateway للإنترنت بدون تأمينه!

  • استخدم 127.0.0.1 للوصول المحلي فقط
  • فعّل المصادقة (authentication) إذا كنت تريد الوصول عن بُعد
  • استخدم VPN أو SSH tunnel للوصول الآمن

تفعيل المصادقة

{
  security: {
    requireAuth: true,
    allowedUsers: ["user@example.com"]
  }
}

⚡ إعدادات الأداء

حد الذاكرة (Memory Limit)

الحد الأقصى للذاكرة التي يمكن أن يستخدمها Gateway (بالميجابايت)

{
  performance: {
    memoryLimit: 2048
  }
}

عدد الجلسات المتزامنة

الحد الأقصى لعدد الجلسات النشطة في نفس الوقت

{
  performance: {
    maxConcurrentSessions: 10
  }
}

🔄 إعادة التشغيل

بعد تعديل التكوين، يجب إعادة تشغيل Gateway لتطبيق التغييرات:

openclaw gateway restart

📝 مثال: ملف تكوين كامل

{
  gateway: {
    port: 18789,
    host: "127.0.0.1",
    enableWebUI: true
  },
  security: {
    requireAuth: false,
    allowedUsers: []
  },
  performance: {
    memoryLimit: 2048,
    maxConcurrentSessions: 10
  },
  logging: {
    level: "info",
    file: "~/.openclaw/logs/gateway.log"
  }
}

🛠️ الأوامر المفيدة

التحقق من حالة الخدمة

openclaw gateway status

عرض السجلات

openclaw gateway logs

إعادة التشغيل

openclaw gateway restart

💡 نصيحة:

ابدأ بالإعدادات الافتراضية وعدّلها فقط عند الحاجة. معظم المستخدمين لا يحتاجون لتعديل أي شيء!