メインコンテンツへスキップ

​
ログ記録（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 を選択しない限り、ほとんどのペイロードを編集します。 統合ログは、サブシステムが 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を保ちなさい。