استكشاف الأخطاء
حلول للمشاكل الشائعة في 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 والذاكرة