Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
التسجيل (macOS)
سجل ملف تشخيصات متناوب (لوحة التصحيح)
يوجّه OpenClaw سجلات تطبيق macOS عبر swift-log (التسجيل الموحّد افتراضيًا) ويمكنه كتابة سجل ملف محلي متناوب إلى القرص عندما تحتاج إلى التقاط دائم.- مستوى التفصيل: لوحة التصحيح → السجلات → تسجيل التطبيق → مستوى التفصيل
- التفعيل: لوحة التصحيح → السجلات → تسجيل التطبيق → “كتابة سجل تشخيصات متناوب (JSONL)”
- الموقع:
~/Library/Logs/OpenClaw/diagnostics.jsonl(يتناوب تلقائيًا؛ تُضاف إلى الملفات القديمة لواحق مثل.1و.2و…) - المسح: لوحة التصحيح → السجلات → تسجيل التطبيق → “مسح”
- هذا معطّل افتراضيًا. فعّله فقط أثناء التصحيح النشط.
- تعامل مع الملف على أنه حساس؛ لا تشاركه دون مراجعته.
البيانات الخاصة في التسجيل الموحّد على macOS
يحجب التسجيل الموحّد معظم الحمولات ما لم يختر نظام فرعي استخدامprivacy -off. وفقًا لمقالة Peter عن حيل خصوصية التسجيل في macOS (2025)، يتم التحكم في ذلك بواسطة plist في /Library/Preferences/Logging/Subsystems/ keyed by the subsystem name. تلتقط إدخالات السجل الجديدة فقط العلامة، لذا فعّلها قبل إعادة إنتاج مشكلة.
التفعيل لـ OpenClaw (ai.openclaw)
- اكتب plist إلى ملف مؤقت أولًا، ثم ثبّته ذريًا كجذر:
- لا يلزم إعادة التشغيل؛ يلاحظ logd الملف بسرعة، لكن أسطر السجل الجديدة فقط ستتضمن الحمولات الخاصة.
- اعرض المخرجات الأغنى باستخدام المساعد الموجود، مثل
./scripts/clawlog.sh --category WebChat --last 5m.
التعطيل بعد التصحيح
- أزل التجاوز:
sudo rm /Library/Preferences/Logging/Subsystems/ai.openclaw.plist. - اختياريًا، شغّل
sudo log config --reloadلإجبار logd على إسقاط التجاوز فورًا. - تذكّر أن هذا السطح يمكن أن يتضمن أرقام هواتف ومحتويات رسائل؛ أبقِ plist في مكانه فقط أثناء حاجتك النشطة إلى التفاصيل الإضافية.