ログ(macOS)

ローリング診断ファイルログ(デバッグパネル)

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

  • 詳細レベル:デバッグパネル → Logs → App logging → Verbosity
  • 有効化:デバッグパネル → Logs → App logging → 「Write rolling diagnostics log (JSONL)」
  • 保存場所:~/Library/Logs/OpenClaw/diagnostics.jsonl(自動ローテーション。古いファイルには.1.2、…のサフィックスが付く)
  • クリア:デバッグパネル → Logs → App logging → 「Clear」

注意:

  • デフォルトではオフです。アクティブなデバッグ中のみ有効にしてください。
  • ファイルにはセンシティブな情報が含まれる可能性があるため、共有前に内容を確認してください。

macOSでの統合ログのプライベートデータ

統合ログは、サブシステムがprivacy -offをオプトインしない限り、ほとんどのペイロードをリダクトします。PeterのmacOSログプライバシーの詳細(2025年)によると、これは/Library/Preferences/Logging/Subsystems/にあるサブシステム名をキーとするplistで制御されます。新しいログエントリのみがフラグを反映するため、問題を再現する前に有効化してください。

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>
EOF
sudo 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

デバッグ後の無効化

  • オーバーライドを削除:sudo rm /Library/Preferences/Logging/Subsystems/ai.openclaw.plist
  • 必要に応じてsudo log config --reloadでlogdにオーバーライドを即座にドロップさせます。
  • このサーフェスには電話番号やメッセージ本文が含まれる可能性があります。追加の詳細が必要な場合のみplistを配置してください。