openclaw logs

عرض وإدارة سجلات OpenClaw Gateway في الوقت الفعلي.

الاستخدام الأساسي

openclaw logs [options]

الأمثلة

عرض السجلات الأخيرة

# عرض آخر 50 سطر من السجلات
openclaw logs

# عرض آخر 100 سطر
openclaw logs --lines 100

المتابعة المباشرة (Follow)

# متابعة السجلات في الوقت الفعلي (مثل tail -f)
openclaw logs --follow

# اختصار
openclaw logs -f

تصفية حسب المستوى

# عرض الأخطاء فقط
openclaw logs --level error

# عرض التحذيرات والأخطاء
openclaw logs --level warn

# عرض كل شيء (debug)
openclaw logs --level debug

تصفية حسب المصدر

# عرض سجلات قناة معينة
openclaw logs --source telegram

# عرض سجلات الوكيل (agent)
openclaw logs --source agent

# عرض سجلات Gateway فقط
openclaw logs --source gateway

تنسيق JSON

# إخراج السجلات بتنسيق JSON للمعالجة الآلية
openclaw logs --json

# مثال مع jq للتصفية
openclaw logs --json | jq '.[] | select(.level == "error")'

حذف السجلات القديمة

# حذف السجلات الأقدم من 7 أيام
openclaw logs --clean --days 7

# حذف جميع السجلات (تحذير!)
openclaw logs --clean --all

الخيارات

الخيارالوصف
-f, --followمتابعة السجلات في الوقت الفعلي
-n, --lines <number>عدد الأسطر المراد عرضها (افتراضي: 50)
--level <level>تصفية حسب مستوى السجل (debug, info, warn, error)
--source <source>تصفية حسب مصدر السجل (gateway, agent, channel name)
--jsonإخراج السجلات بتنسيق JSON
--cleanحذف السجلات القديمة
--days <number>عدد الأيام للاحتفاظ بالسجلات (مع --clean)
--allحذف جميع السجلات (مع --clean)
--no-colorتعطيل الألوان في المخرجات

مستويات السجلات

error

أخطاء تحتاج إلى تدخل فوري. تشير إلى مشاكل خطيرة.

warn

تحذيرات حول مشاكل محتملة. النظام يعمل لكن قد تحتاج للمراجعة.

info

معلومات عامة حول عمليات النظام. المستوى الافتراضي للسجلات.

debug

معلومات تفصيلية للتشخيص. مفيدة للمطورين وتحليل المشاكل.

أمثلة متقدمة

مراقبة الأخطاء في الوقت الفعلي

# متابعة الأخطاء فقط
openclaw logs --follow --level error

# متابعة أخطاء قناة معينة
openclaw logs -f --level error --source telegram

تحليل السجلات باستخدام jq

# عد الأخطاء حسب المصدر
openclaw logs --json | jq 'group_by(.source) | map({source: .[0].source, count: length})'

# استخراج رسائل الخطأ فقط
openclaw logs --json | jq '.[] | select(.level == "error") | .message'

# البحث عن نمط معين
openclaw logs --json | jq '.[] | select(.message | contains("timeout"))'

حفظ السجلات لملف

# حفظ آخر 1000 سطر
openclaw logs --lines 1000 > logs-backup.txt

# حفظ كـ JSON
openclaw logs --json > logs-backup.json

# حفظ السجلات المباشرة لمدة محددة
timeout 60 openclaw logs --follow > realtime-logs.txt

💡 نصائح

  • استخدم --follow لمراقبة السجلات أثناء تشخيص المشاكل
  • قم بتنظيف السجلات القديمة بانتظام لتوفير المساحة
  • استخدم --json مع أدوات مثل jq للتحليل المتقدم
  • راقب مستوى error للمشاكل الحرجة

موقع السجلات

يتم تخزين السجلات في:

# macOS/Linux
~/.openclaw/logs/

# Windows
%USERPROFILE%\.openclaw\logs\

# ملفات السجلات
gateway.log          # سجل Gateway الرئيسي
agent.log            # سجلات الوكيل
channels/*.log       # سجلات القنوات الفردية

⚠️ تحذير

عند استخدام --clean --all، سيتم حذف جميع السجلات نهائياً. لا يمكن التراجع عن هذا الإجراء.

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

Gateway غير مستجيب

# تحقق من آخر الأخطاء
openclaw logs --level error --lines 100

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

مشاكل القنوات

# راقب سجلات قناة معينة
openclaw logs --follow --source telegram

# تحقق من أخطاء جميع القنوات
openclaw logs --level error --source channels

الأوامر ذات الصلة

  • openclaw gateway status - التحقق من حالة Gateway
  • openclaw doctor - تشخيص شامل للنظام
  • openclaw channels status - حالة القنوات