ログ記録（macOS）¶

ローテーションする診断ファイルログ（Debug ペイン）¶

OpenClaw は macOS アプリのログを swift-log（既定では統合ログ）経由で出力し、耐久的な取得が必要な場合には、ローカルでローテーションするファイルログをディスクに書き込めます。

• 冗長度：Debug ペイン → Logs → App logging → Verbosity
• 有効化：Debug ペイン → Logs → App logging → 「Write rolling diagnostics log (JSONL)」
• 保存先：~/Library/Logs/OpenClaw/diagnostics.jsonl（自動でローテーションします。古いファイルには .1、.2、…
• クリア：Debug ペイン → Logs → App logging → 「Clear」

注記：

• これはデフォルトではオフです。 既定では 無効 です。アクティブにデバッグしている間のみ有効にしてください。
• ファイルを機密として扱います。レビューなしで共有しないでください。

macOS における統合ログのプライベートデータ¶

統合ログは、サブシステムが privacy -off を選択しない限り、ほとんどのペイロードを編集します。 PeterのmacOSへの書き込みLogging privacy shenanigans (2025) これはサブシステム名によってキー付けされた/Library/Preferences/Logging/Subsystems/のリストによって制御されます。 新しいログエントリだけがフラグを拾うので、問題を再現する前に有効にします。

OpenClaw 向けに有効化（bot.molt）¶

• まず 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を保ちなさい。