OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

macOS companion app

macOS-logboekregistratie

Logboekregistratie (macOS)

Doorlopend diagnostisch bestandslogboek (foutopsporingspaneel)

De macOS-app registreert logboeken via swift-log (standaard uniforme logboekregistratie) en kan ook een roterend lokaal bestandslogboek schrijven voor duurzame vastlegging (DiagnosticsFileLog).

  • Inschakelen: Debug pane -> Logs -> App logging -> "Write rolling diagnostics log (JSONL)" (standaard uitgeschakeld).
  • Uitgebreidheid: keuzelijst Debug pane -> Logs -> App logging -> Verbosity.
  • Locatie: ~/Library/Logs/OpenClaw/diagnostics.jsonl.
  • Rotatie: roteert bij 5 MB; maximaal 5 back-ups met achtervoegsels .1....5 (de oudste wordt verwijderd).
  • Wissen: Debug pane -> Logs -> App logging -> "Clear" verwijdert het actieve bestand en alle back-ups.

Behandel het bestand als gevoelig; deel het niet zonder het eerst te controleren.

Privégegevens in uniforme logboekregistratie op macOS

Uniforme logboekregistratie redigeert de meeste nettoladingen, tenzij een subsysteem zich aanmeldt voor privacy -off. Dit wordt beheerd door een plist in /Library/Preferences/Logging/Subsystems/, geïndexeerd op subsysteemnaam. Alleen nieuwe logboekvermeldingen nemen de vlag over; schakel deze dus in voordat u een probleem reproduceert. Achtergrondinformatie: perikelen rond privacy bij macOS-logboekregistratie.

Inschakelen voor OpenClaw (ai.openclaw)

Schrijf de plist eerst naar een tijdelijk bestand en installeer deze vervolgens atomair als root:

bash
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

Opnieuw opstarten is niet vereist; logd neemt het bestand snel over, maar alleen nieuwe logboekregels bevatten privé-nettoladingen. Bekijk de uitgebreidere uitvoer met ./scripts/clawlog.sh --category WebChat --last 5m (--last/-l stelt het tijdsbereik in, standaard 5m; --category/-c filtert op categorie).

Uitschakelen na foutopsporing

  • Verwijder de overschrijving: sudo rm /Library/Preferences/Logging/Subsystems/ai.openclaw.plist.
  • Voer eventueel sudo log config --reload uit om logd te dwingen de overschrijving onmiddellijk te verwijderen.
  • Dit oppervlak kan telefoonnummers en berichtinhoud bevatten; laat de plist alleen staan wanneer deze actief nodig is.

Gerelateerd

Was this useful?
On this page

On this page