ログ(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を配置してください。