استكشاف الأخطاء

حلول للمشاكل الشائعة في Gateway.

نصيحة سريعة:

معظم المشاكل يمكن حلها بإعادة تشغيل Gateway أو فحص السجلات. ابدأ بـ openclaw gateway status و openclaw gateway logs

المشاكل الشائعة

❌ Gateway لا يبدأ

الأسباب المحتملة:

  • المنفذ 3777 مستخدم بالفعل
  • أذونات غير كافية
  • ملف تكوين غير صحيح

الحل:

# تحقق من السجلات
openclaw gateway logs

# تحقق من المنفذ
lsof -i :3777

# أعد تشغيل مع verbose
openclaw gateway start --verbose

🔌 Node لا يتصل

الأسباب:

  • URL خاطئ
  • Token منتهي الصلاحية
  • Firewall يمنع الاتصال

الحل:

# تحقق من حالة Gateway
openclaw gateway status

# أنشئ Token جديد
openclaw gateway token create

# تحقق من الاتصال
curl http://localhost:3777/health

🐳 Docker/Sandboxing لا يعمل

الأسباب:

  • Docker غير مثبت
  • Docker daemon غير مشغل
  • أذونات Docker غير صحيحة

الحل:

# تحقق من Docker
docker ps

# ابدأ Docker Desktop (macOS)
open /Applications/Docker.app

# تحقق من Sandbox status
openclaw gateway status | grep sandbox

📊 استهلاك عالي للموارد

الأسباب:

  • Agent يقوم بمهام كثيرة
  • حاويات Docker لم تُحذف
  • سجلات كبيرة جدًا

الحل:

# نظف حاويات Docker القديمة
docker container prune -f

# امسح سجلات قديمة
rm ~/.config/openclaw/logs/*.log.old

# حدد موارد Agent في config
{
  agents: {
    defaults: {
      limits: { cpu: "0.5", memory: "256m" }
    }
  }
}

🔑 مشكلة في الأذونات

الأسباب:

  • Security mode صارم جدًا
  • IP غير مسموح

الحل:

# تعطيل مؤقتًا (للتجربة فقط!)
{
  gateway: {
    security: { mode: "full" }
  }
}

# ثم أضف IPs محددة
{
  gateway: {
    security: {
      mode: "allowlist",
      allowedIPs: ["192.168.1.0/24"]
    }
  }
}

أدوات التشخيص

حالة Gateway

openclaw gateway status

السجلات الكاملة

openclaw gateway logs --tail=100

تشخيص الشبكة

openclaw gateway diagnose

عرض الـ Nodes المتصلة

openclaw nodes status

اختبار Sandbox

openclaw exec "echo 'test'" --sandbox

إعادة التعيين الكاملة

⚠️ تحذير:

سيحذف هذا جميع التكوينات والـ Tokens! استخدم فقط كحل أخير.

# أوقف Gateway
openclaw gateway stop

# امسح التكوين
rm -rf ~/.config/openclaw/

# أعد التثبيت
openclaw onboard

مشاكل شائعة إضافية

السجلات ممتلئة

# امسح السجلات القديمة
find ~/.config/openclaw/logs -name "*.log" -mtime +7 -delete

# أو قم بتفعيل Log rotation في التكوين
{
  logging: {
    rotation: {
      maxSize: "10m",
      maxFiles: 5
    }
  }
}

Gateway بطيء

# تحقق من استخدام الموارد
top -pid $(pgrep openclaw)

# حدد عدد Workers
{
  gateway: {
    workers: 2  // قلل إذا كان الجهاز ضعيف
  }
}

💬 تحتاج مساعدة؟

إذا لم تحل المشكلة:

نصائح الوقاية

  • حدّث بانتظام: احرص على تحديث OpenClaw بآخر الإصدارات
  • نسخ احتياطية: احفظ نسخة من ~/.config/openclaw/ بانتظام
  • راقب السجلات: راجع السجلات دوريًا للكشف المبكر عن المشاكل
  • حدود الموارد: ضع حدودًا مناسبة للـ CPU والذاكرة