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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
ログ記録 (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 を置いたままにしてください。

​
関連