macOS companion app
ثبت رویدادهای macOS
گزارشگیری (macOS)
گزارش فایل تشخیصی چرخشی (پنل اشکالزدایی)
برنامه macOS از طریق swift-log گزارش ثبت میکند (بهطور پیشفرض با گزارشگیری یکپارچه) و همچنین میتواند برای ثبت پایدار، گزارش فایل محلی چرخشی بنویسد (DiagnosticsFileLog).
- فعالسازی: Debug pane -> Logs -> App logging -> "Write rolling diagnostics log (JSONL)" (بهطور پیشفرض غیرفعال است).
- میزان جزئیات: انتخابگر Debug pane -> Logs -> App logging -> Verbosity.
- مکان:
~/Library/Logs/OpenClaw/diagnostics.jsonl. - چرخش: در 5 MB میچرخد؛ حداکثر 5 نسخه پشتیبان با پسوندهای
.1....5نگهداری میشود (قدیمیترین حذف میشود). - پاکسازی: گزینه Debug pane -> Logs -> App logging -> "Clear" فایل فعال و همه نسخههای پشتیبان را حذف میکند.
این فایل را حساس تلقی کنید؛ بدون بازبینی آن را به اشتراک نگذارید.
دادههای خصوصی گزارشگیری یکپارچه در macOS
گزارشگیری یکپارچه بیشتر محتوای بارها را پنهان میکند، مگر اینکه یک زیرسیستم privacy -off را فعال کند. این رفتار با یک plist در /Library/Preferences/Logging/Subsystems/ که بر اساس نام زیرسیستم کلیدگذاری شده است کنترل میشود. فقط ورودیهای گزارش جدید این پرچم را اعمال میکنند، بنابراین پیش از بازتولید مشکل آن را فعال کنید. پیشزمینه: ترفندهای حریم خصوصی گزارشگیری macOS.
فعالسازی برای OpenClaw (ai.openclaw)
ابتدا plist را در یک فایل موقت بنویسید، سپس آن را بهصورت اتمی و با کاربر root نصب کنید:
cat <<'EOF' >/tmp/ai.openclaw.plist<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><plist version="1.0"><dict> <key>DEFAULT-OPTIONS</key> <dict> <key>Enable-Private-Data</key> <true/> </dict></dict></plist>EOFsudo install -m 644 -o root -g wheel /tmp/ai.openclaw.plist /Library/Preferences/Logging/Subsystems/ai.openclaw.plistنیازی به راهاندازی مجدد نیست؛ logd فایل را سریع شناسایی میکند، اما فقط خطوط گزارش جدید شامل محتوای خصوصی خواهند بود. خروجی غنیتر را با ./scripts/clawlog.sh --category WebChat --last 5m مشاهده کنید (--last/-l بازه زمانی را تعیین میکند؛ مقدار پیشفرض 5m است؛ --category/-c بر اساس دسته فیلتر میکند).
غیرفعالسازی پس از اشکالزدایی
- بازنویسی را حذف کنید:
sudo rm /Library/Preferences/Logging/Subsystems/ai.openclaw.plist. - در صورت تمایل،
sudo log config --reloadرا اجرا کنید تا logd فوراً بازنویسی را کنار بگذارد. - این سطح ممکن است شامل شماره تلفنها و متن پیامها باشد؛ plist را فقط تا زمانی نگه دارید که فعالانه به آن نیاز دارید.
