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

# 監査履歴

# 監査履歴

Gateway は、共有 OpenClaw 状態データベースに、メタデータのみを格納する件数制限付きの監査台帳を保持します。この台帳は、「どのエージェントがいつ実行され、どのように終了したか」、「実行中にどのツールアクションが行われたか」、さらにメッセージ監査が有効な場合は、「受理された受信メッセージがディスパッチに到達したか」や「送信メッセージが最終的な配信状態に到達したか」といった運用上の問いに答えます。

台帳には、識別情報、順序、来歴、アクション、ステータス、および正規化された結果コードが保存されます。プロンプト、メッセージ本文、ツール引数、ツール結果、添付ファイル、ファイル名、URL、コマンド出力、生のエラーテキストは一切保存されません。

## レコード種別

監査が有効な場合（デフォルト）、実行イベントとツールイベントは常に記録されます。メッセージのライフサイクルイベントはオプトインであり、デフォルトでは無効です。

| 種別       | アクション                                                    | デフォルト |
| -------- | -------------------------------------------------------- | ----- |
| エージェント実行 | `agent.run.started`, `agent.run.finished`                | オン    |
| ツールアクション | `tool.action.started`, `tool.action.finished`            | オン    |
| メッセージ    | `message.inbound.processed`, `message.outbound.finished` | オフ    |

すべてのレコードには、安定したイベント ID、単調増加する台帳シーケンス、ライフサイクルのタイムスタンプ、アクター、アクション、ステータス、`schemaVersion: 1`、および `redaction: "metadata_only"` が含まれます。フィールドの完全なリファレンスとクエリフィルターについては、[監査レコード](/ja-JP/cli/audit)を参照してください。

## メッセージのライフサイクルイベント

記録対象を選択するには、[`audit.messages`](/ja-JP/gateway/configuration-reference#audit) を設定してから Gateway を再起動します。

* `off`（デフォルト）：メッセージレコードを記録しません。
* `direct`：ダイレクト会話内のメッセージのみを記録します。
* `all`：ダイレクト、グループ、およびチャンネルのメッセージを記録します。

メッセージレコードは、信頼できる次の 2 つの境界で生成されます。

* **受信**行は、重複や最終的な処理結果を含め、受理されたメッセージがコアのディスパッチに到達した時点で書き込まれます。
* **送信**行は、共有の永続配信が、送信済み、抑止、失敗、またはクラッシュにより送信成否が曖昧な場合の明示的な `unknown` のいずれかの最終結果に到達した時点で書き込まれます。キューの復旧およびデッドレターの結果も含まれます。元の論理返信ペイロードごとに最終行が 1 つ生成され、チャンク分割とアダプターのファンアウトは `resultCount` に集約されます。

### 会話種別の分類

`direct` モードはプライバシー境界であるため、送信先の事実によって証明できる場合にのみ、メッセージはダイレクト会話として分類されます。具体的には、送信経路で送信先の会話種別が宣言されている場合、または配信セッションのルートが配信先のチャンネルと相手を正確に指定している場合です。ポリシー状態や送信元の会話など、より弱いシグナルによってメッセージを `group` と分類し（`direct` の収集対象から除外し）得る一方で、`direct` と判定することはできません。ダイレクトであることを証明できないメッセージは `unknown` に分類され、`direct` モードでは記録されません。そのため、チャット種別を宣言しないチャンネルでは、`all` モードよりも `direct` モードで記録される行が少なくなる場合があります。

## プライバシーモデル

メッセージ行には、生のプラットフォーム識別子は一切保存されません。相関付けが可能な場合、アカウント、会話、メッセージ、および送信先の識別子は、インストール環境内に限定された鍵付き仮名
（`hmac-sha256:v1:<keyId>:<digest>`）としてのみエクスポートされます。

* HMAC 鍵は初回使用時に生成され、識別子の種別ごとにドメイン分離され、台帳と同じ状態データベースに保存されます。
* 仮名は 1 つのインストール環境内で安定しているため、プラットフォーム識別子を明かすことなく、同じ会話に関する行を相関付けできます。
* これは**相関付けであり、匿名化ではありません**。状態データベースへの読み取りアクセス権を持つ者は鍵にもアクセスできるため、生の識別子候補を仮名と照合できます。RPC および CLI のエクスポートに鍵が含まれることはありません。
* メッセージ行が保持されている状態で鍵素材が欠落または破損した場合、Gateway はフェイルクローズし、新しい鍵へ暗黙にローテーションして相関関係を分断するのではなく、新しいメッセージレコードを破棄します。

実行レコードとツールレコードは、相関付けのために `sessionKey` と `sessionId` を保持します。正規のセッションキー自体に、プラットフォームのアカウント ID や相手 ID が含まれる場合があります。メッセージレコードでは、意図的にその両方を省略しています。

監査エクスポートは、内容を含まなくても機密性の高い運用メタデータです。時刻、チャンネル、結果、および安定した仮名によって、アクティビティを相関付けできるためです。エクスポートは、他の運用担当者向けレコードと同等のアクセス制御および保持方法で保護してください。

## 対象範囲と証明の限界

台帳はベストエフォートであり、意図的に件数が制限されています。実際に発生した事象の証明ではなく、記録された内容の証拠として扱ってください。

* **行が存在しないことは、何も証明しません。** 受理前に破棄された受信メッセージ、Gateway レコーダーが稼働していない CLI プロセスからの送信、および共有の永続配信を迂回する Plugin ローカルまたは直接送信の経路は記録されません。
* 書き込みは、件数制限付きのバックグラウンドワーカーを介して行われます。ワーカーの障害またはキューの飽和が発生するとレコードは破棄され、運用上の警告が 1 件ログに記録されます。
* クラッシュによって送信成否が曖昧な送信は、架空の結果ではなく `unknown` として記録されます。

この台帳は、デバッグおよび運用レビューを支援します。損失のないコンプライアンスアーカイブではありません。そのようなアーカイブが必要な場合は、[OpenTelemetry](/ja-JP/gateway/opentelemetry) またはチャンネルレベルのツールからデータを供給する外部システムを使用してください。

## ストレージ、保持、および移行

レコードは共有状態データベース（`state/openclaw.sqlite`）に保存され、配信のホットパス外で書き込まれます。クエリが 30 日より古いレコードを返すことはなく、台帳の上限は 100,000 行です。期限切れの行は、起動時、1 時間ごとのメンテナンス時、および後続の書き込み時に削除されます。収集が無効な場合でも、保持メンテナンスは継続して実行されます。

以前の実行／ツール専用台帳を備えた Gateway からアップグレードすると、起動時（または `openclaw doctor --fix` の実行時）にスキーマが自動的に移行されます。既存の行とその台帳シーケンスは保持されます。

## クエリ

* CLI：[`openclaw audit`](/ja-JP/cli/audit)。エージェント、セッション、実行、種別、ステータス、方向、チャンネル、時間範囲、およびカーソルページングのフィルターを使用できます。
* Gateway RPC：`audit.activity.list`（`operator.read` が必要）は、バージョン管理された V1 アクティビティイベントの共用体を返します。リリース済みの `audit.list` RPC は、従来の実行／ツールクライアント向けに変更されていません。[Gateway プロトコル](/ja-JP/gateway/protocol#audit-ledger-rpc)を参照してください。

## 関連項目

* [監査レコード CLI](/ja-JP/cli/audit)
* [設定リファレンス](/ja-JP/gateway/configuration-reference#audit)
* [Gateway プロトコル](/ja-JP/gateway/protocol#audit-ledger-rpc)
* [OpenTelemetry](/ja-JP/gateway/opentelemetry)