Files
openclaw-skill/openclaw-knowhow-skill/output/openclaw-docs_data/pages/Logging_macOS_1927d3df5e.json
Selig 4c966a3ad2 Initial commit: OpenClaw Skill Collection
6 custom skills (assign-task, dispatch-webhook, daily-briefing,
task-capture, qmd-brain, tts-voice) with technical documentation.
Compatible with Claude Code, OpenClaw, Codex CLI, and OpenCode.
2026-03-13 10:58:30 +08:00

29 lines
2.5 KiB
JSON
Executable File
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
{
"title": "Logging (macOS)",
"content": "## Rolling diagnostics file log (Debug pane)\n\nOpenClaw routes macOS app logs through swift-log (unified logging by default) and can write a local, rotating file log to disk when you need a durable capture.\n\n* Verbosity: **Debug pane → Logs → App logging → Verbosity**\n* Enable: **Debug pane → Logs → App logging → “Write rolling diagnostics log (JSONL)”**\n* Location: `~/Library/Logs/OpenClaw/diagnostics.jsonl` (rotates automatically; old files are suffixed with `.1`, `.2`, …)\n* Clear: **Debug pane → Logs → App logging → “Clear”**\n\n* This is **off by default**. Enable only while actively debugging.\n* Treat the file as sensitive; dont share it without review.\n\n## Unified logging private data on macOS\n\nUnified logging redacts most payloads unless a subsystem opts into `privacy -off`. Per Peter's write-up on macOS [logging privacy shenanigans](https://steipete.me/posts/2025/logging-privacy-shenanigans) (2025) this is controlled by a plist in `/Library/Preferences/Logging/Subsystems/` keyed by the subsystem name. Only new log entries pick up the flag, so enable it before reproducing an issue.\n\n## Enable for OpenClaw (`bot.molt`)\n\n* Write the plist to a temp file first, then install it atomically as root:\n\n* No reboot is required; logd notices the file quickly, but only new log lines will include private payloads.\n* View the richer output with the existing helper, e.g. `./scripts/clawlog.sh --category WebChat --last 5m`.\n\n## Disable after debugging\n\n* Remove the override: `sudo rm /Library/Preferences/Logging/Subsystems/bot.molt.plist`.\n* Optionally run `sudo log config --reload` to force logd to drop the override immediately.\n* Remember this surface can include phone numbers and message bodies; keep the plist in place only while you actively need the extra detail.",
"code_samples": [],
"headings": [
{
"level": "h2",
"text": "Rolling diagnostics file log (Debug pane)",
"id": "rolling-diagnostics-file-log-(debug-pane)"
},
{
"level": "h2",
"text": "Unified logging private data on macOS",
"id": "unified-logging-private-data-on-macos"
},
{
"level": "h2",
"text": "Enable for OpenClaw (`bot.molt`)",
"id": "enable-for-openclaw-(`bot.molt`)"
},
{
"level": "h2",
"text": "Disable after debugging",
"id": "disable-after-debugging"
}
],
"url": "llms-txt#logging-(macos)",
"links": []
}