macOS Logging

OpenClaw は swift-log（デフォルトで統合ログ）経由で macOS アプリログをルーティングし、持続可能なキャプチャが必要な場合にローカルのローテーティングファイルログをディスクに書き込むことができます。

- 冗長度：デバッグペイン → ログ → アプリログ → 冗長度

- 有効化：デバッグペイン → ログ → アプリログ → "ローリング診断ログを書き込む（JSONL）"

- 場所：''~/Library/Logs/OpenClaw/diagnostics.jsonl''（自動的にローテーション；古いファイルは ''.1''、''.2''、… が接尾されます）

- クリア：デバッグペイン → ログ → アプリログ → "クリア"

Notes:

- これはデフォルトでオフです。アクティブにデバッグしている場合のみ有効にします。

- ファイルを機密として扱います。レビューなしで共有しないでください。

統合ログは、サブシステムが ''privacy -off'' にオプトインしない限り、ほとんどのペイロードを編集します。Peter の macOS での ''ログプライバシーの悪戯''（2025）の書き込みによると、これは ''/Library/Preferences/Logging/Subsystems/'' 内のサブシステム名でキーされた plist によって制御されます。新しいログエントリのみがフラグを取得するため、問題を再現する前に有効にしてください。

- まず plist を一時ファイルに書き込み、次に root としてアトミックにインストールします：

cat '<<''EOF'' >'/tmp/bot.molt.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>'
EOF
sudo install -m 644 -o root -g wheel /tmp/bot.molt.plist /Library/Preferences/Logging/Subsystems/bot.molt.plist

- 再起動は必要ありません。logd はファイルをすばやく通知しますが、新しいログ行のみがプライベートペイロードを含みます。

- 既存のヘルパーを使用してより豊かな出力を表示します。例：''./scripts/clawlog.sh --category WebChat --last 5m''。

- オーバーライドを削除：''sudo rm /Library/Preferences/Logging/Subsystems/bot.molt.plist''。

- オプションで ''sudo log config --reload'' を実行して、logd にオーバーライドをすばやくドロップさせます。

- このサーフェスは電話番号とメッセージ本文を含む可能性があることに注意してください。追加の詳細が必要な場合にのみ plist を配置してください。