docs/docs/ar/diagnostics/flags.md

read_when	summary	title	x-i18n
تحتاج إلى سجلات تصحيح أخطاء مستهدفة دون رفع مستويات التسجيل العامة تحتاج إلى التقاط سجلات خاصة بنظام فرعي محدد لأغراض الدعم	علامات التشخيص لسجلات تصحيح الأخطاء المستهدفة	علامات التشخيص	generated_at model provider source_hash source_path workflow 2026-04-24T07:39:51Z gpt-5.4 openai b7e5ec9c5e28ef51f1e617baf62412897df8096f227a74d86a0824e269aafd9d diagnostics/flags.md 15

تتيح لك علامات التشخيص تفعيل سجلات تصحيح أخطاء مستهدفة من دون تشغيل التسجيل التفصيلي في كل مكان. وتكون العلامات اختيارية ولا تؤثر إلا إذا كان نظام فرعي ما يتحقق منها.

كيف يعمل ذلك

• العلامات عبارة عن سلاسل نصية (غير حساسة لحالة الأحرف).
• يمكنك تفعيل العلامات في التهيئة أو عبر تجاوز باستخدام متغير بيئة.
• تُدعَم الرموز الشاملة:
  • telegram.* يطابق telegram.http
  • * يفعّل جميع العلامات

التفعيل عبر التهيئة

{
  "diagnostics": {
    "flags": ["telegram.http"]
  }
}

علامات متعددة:

{
  "diagnostics": {
    "flags": ["telegram.http", "gateway.*"]
  }
}

أعد تشغيل Gateway بعد تغيير العلامات.

تجاوز عبر متغير البيئة (لمرة واحدة)

OPENCLAW_DIAGNOSTICS=telegram.http,telegram.payload

تعطيل جميع العلامات:

OPENCLAW_DIAGNOSTICS=0

أين تذهب السجلات

تُصدِر العلامات السجلات إلى ملف سجلات التشخيص القياسي. افتراضيًا:

/tmp/openclaw/openclaw-YYYY-MM-DD.log

إذا قمت بضبط logging.file، فاستخدم ذلك المسار بدلًا من ذلك. تكون السجلات بصيغة JSONL ‏(كائن JSON واحد في كل سطر). وما زال إخفاء البيانات الحساسة مطبقًا وفق logging.redactSensitive.

استخراج السجلات

اختر أحدث ملف سجل:

ls -t /tmp/openclaw/openclaw-*.log | head -n 1

صفِّ السجلات الخاصة بتشخيصات Telegram HTTP:

rg "telegram http error" /tmp/openclaw/openclaw-*.log

أو راقبها أثناء إعادة إنتاج المشكلة:

tail -f /tmp/openclaw/openclaw-$(date +%F).log | rg "telegram http error"

وبالنسبة إلى Gateways البعيدة، يمكنك أيضًا استخدام openclaw logs --follow ‏(راجع /cli/logs).

ملاحظات

• إذا كانت قيمة logging.level أعلى من warn، فقد يتم كبت هذه السجلات. والقيمة الافتراضية info مناسبة.
• من الآمن إبقاء العلامات مفعّلة؛ فهي تؤثر فقط في حجم السجلات الخاصة بالنظام الفرعي المحدد.
• استخدم /logging لتغيير وجهات السجلات، والمستويات، وإخفاء البيانات الحساسة.

ذو صلة

• تشخيصات Gateway
• استكشاف أخطاء Gateway وإصلاحها