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でローテーションし、.1.5の接尾辞が付いたバックアップを最大5件保持します(最も古いものは削除されます)。
  • 消去: Debug pane -> Logs -> App logging -> "Clear" を実行すると、使用中のファイルとすべてのバックアップが削除されます。

このファイルは機密情報として扱い、内容を確認せずに共有しないでください。

macOSの統合ログにおける非公開データ

統合ログでは、サブシステムがprivacy -offを有効にしない限り、ほとんどのペイロードが秘匿化されます。これは、/Library/Preferences/Logging/Subsystems/内にある、サブシステム名をキーとしたplistによって制御されます。このフラグが適用されるのは新しいログエントリのみであるため、問題を再現する前に有効にしてください。背景情報: macOSのログプライバシーに関する特殊な挙動

OpenClaw(ai.openclaw)で有効化する

まず一時ファイルにplistを書き込み、その後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

再起動は不要です。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は実際に必要な間だけ保持してください。

関連項目

Was this useful?
On this page

On this page