macOSコンパニオンアプリ
macOSロギング
ローリング診断ファイルログ (デバッグペイン)
OpenClawはmacOSアプリのログをswift-log（デフォルトでは統一ロギング）経由でルーティングし、耐久性のあるキャプチャが必要な場合にローカルのローテーションするファイルログをディスクに書き込むことができます。
- 詳細度: デバッグペイン → ログ → アプリロギング → 詳細度
- 有効化: デバッグペイン → ログ → アプリロギング → 「ローリング診断ログを書き込む (JSONL)」
- 保存場所:
~/Library/Logs/OpenClaw/diagnostics.jsonl(自動的にローテーション; 古いファイルは.1,.2, … というサフィックスが付きます) - クリア: デバッグペイン → ログ → アプリロギング → 「クリア」
注意:
- これはデフォルトではオフです。アクティブにデバッグしている間のみ有効にしてください。
- ファイルは機密として扱い、レビューなしで共有しないでください。
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を配置したままにしてください。