openclaw audit

エージェント実行とツールアクションについて、Gateway のメタデータのみの監査台帳をクエリします。

記録はデフォルトで有効です。新しい書き込みを停止するには、audit.enabled: false を設定します。既存のレコードは期限切れになるまで（30日間）クエリ可能なままです。 台帳は会話トランスクリプトとは別です。ID、 順序、出所、アクション、ステータス、正規化されたエラーコードを記録しますが、プロンプト、メッセージ、ツール引数、ツール結果、コマンド出力、生のエラーテキストは 保存しません。

Gateway は、境界付きのバックグラウンドライターを通じて、共有 OpenClaw 状態データベースにレコードを書き込みます。 クエリは 30 日より古いレコードを返さず、 台帳は 100,000 行に制限されます。期限切れの行は、 Gateway 起動時、毎時のメンテナンス時、および以後の書き込み時に削除されます。

openclaw auditopenclaw audit --agent main --status failedopenclaw audit --session "agent:main:main" --after 2026-07-01T00:00:00Zopenclaw audit --run 8c69f72e-8b11-4c54-98d5-1a3dd67450c3openclaw audit --kind tool_action --limit 50 --json

フィルター

• --agent <id>: 正確なエージェント ID
• --session <key>: 正確なセッションキー
• --run <id>: 正確な実行 ID
• --kind <kind>: agent_run または tool_action
• --status <status>: started、succeeded、failed、cancelled、 timed_out、blocked、または unknown
• --after <timestamp> / --before <timestamp>: 包含的な ISO タイムスタンプまたは Unix ミリ秒
• --limit <count>: 1 から 500 までのページサイズ。デフォルトは 100
• --cursor <sequence>: 以前の新しい順クエリを続行
• --json: 境界付きページを JSON として出力

テキスト出力には、時刻、種類、ステータス、エージェント、実行、アクションが表示されます。ツールアクションでは、 ツール名も表示されます。JSON 出力は同じメタデータの安全な境界付きエクスポートであり、 別のページが存在する場合は nextCursor を含みます。その値を --cursor に渡すと、ページング中に到着したレコードを並べ替えずに続行できます。

記録されるイベント

Gateway は既存のエージェントイベントストリームを 4 つのアクションに投影します。

• agent.run.started
• agent.run.finished
• tool.action.started
• tool.action.finished

すべてのレコードには、安定したイベント ID、単調増加する台帳シーケンス、 元の実行イベントシーケンス、ランタイムが提供する場合はライフサイクルタイムスタンプ （それ以外の場合は観測時刻）、エージェント/実行の出所、アクター、および redaction: "metadata_only" マーカーがあります。終端レコードは、成功、 失敗、キャンセル、タイムアウト、ポリシーブロックを、閉じたステータスとエラーコードで区別します。 unknown は、上流ランタイムが信頼できる終端結果を公開しない場合の明示的な非成功結果です。ツール呼び出し ID は、 安定した一方向フィンガープリントとしてのみエクスポートされます。ツール名はコンパクトな モデル向け名前契約に一致する必要があります。それ以外の値は unknown になります。セッション ID、セッション キー、実行 ID、および保持されたツール名はオペレーターメタデータです。エクスポートは 運用レコードとして保護してください。

監査台帳は、トランスクリプト、タスク履歴、Cron 実行履歴、 ログを置き換えるものではありません。会話内容を別のストアにコピーすることなく、 オペレーターの質問に対応する小さな実行横断インデックスを提供します。

Gateway RPC

audit.list には operator.read が必要で、同じフィルターを受け付けます。例:

openclaw gateway call audit.list --params '{"agentId":"main","status":"failed","limit":50}'

結果は { "events": AuditEvent[], "nextCursor"?: string } です。結果は 新しい順で、リクエストごとに 500 レコードに制限されます。

関連

• Gateway プロトコル
• セッション
• タスク
• Cron ジョブ