> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# macOS のログ記録

# ログ記録（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](https://steipete.me/posts/2025/logging-privacy-shenanigans) (2025) これはサブシステム名によってキー付けされた`/Library/Preferences/Logging/Subsystems/`のリストによって制御されます。 新しいログエントリだけがフラグを拾うので、問題を再現する前に有効にします。 新しいログエントリだけがフラグを拾うので、問題を再現する前に有効にします。

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

* まず plist を一時ファイルとして書き込み、その後 root としてアトミックにインストールします：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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を保ちなさい。