البيئة والتصحيح
أعلام التشخيص
تتيح لك أعلام التشخيص تمكين سجلات التصحيح المستهدفة دون تشغيل التسجيل المطول في كل مكان. الأعلام اختيارية ولا يكون لها أي تأثير إلا إذا قام نظام فرعي بالتحقق منها.
كيفية عملها
- الأعلام هي سلاسل نصية (غير حساسة لحالة الأحرف).
- يمكنك تمكين الأعلام في التكوين أو عبر تجاوز متغير البيئة.
- الرموز البديلة مدعومة:
telegram.*تطابقtelegram.http*تمكن جميع الأعلام
التمكين عبر التكوين
{
"diagnostics": {
"flags": ["telegram.http"]
}
}
أعلام متعددة:
{
"diagnostics": {
"flags": ["telegram.http", "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
تصفية سجلات تشخيص بروتوكول HTTP لتيليجرام:
rg "telegram http error" /tmp/openclaw/openclaw-*.log
أو تتبع السجلات أثناء إعادة إنتاج المشكلة:
tail -f /tmp/openclaw/openclaw-$(date +%F).log | rg "telegram http error"
للبوابات البعيدة، يمكنك أيضًا استخدام openclaw logs --follow (انظر /cli/logs).
ملاحظات
- إذا تم تعيين
logging.levelأعلى منwarn، فقد يتم قمع هذه السجلات. المستوى الافتراضيinfoمناسب. - من الآمن ترك الأعلام ممكّنة؛ فهي تؤثر فقط على حجم السجلات للنظام الفرعي المحدد.
- استخدم /logging لتغيير وجهات السجلات ومستوياتها والتعتيم.