--- read_when: - Вам необходимо ответить, кто запустил агента или инструмент, когда он был запущен и чем завершился его запуск - Вам нужны метаданные жизненного цикла входящих или исходящих сообщений без их содержимого - Вам нужен ограниченный экспорт активности с безопасным редактированием конфиденциальных данных summary: Справочник CLI по записям аудита жизненного цикла запусков, инструментов и сообщений, содержащим только метаданные title: Записи аудита x-i18n: generated_at: "2026-07-13T17:56:53Z" model: gpt-5.6 postprocess_version: locale-links-v1 prompt_version: 24 provider: openai source_hash: da9df6f388b0a24c3b79d755fa59d047cce99262bc6d9c890be7a83da75693a8 source_path: cli/audit.md workflow: 16 --- # `openclaw audit` Запрашивайте журнал аудита Gateway, содержащий только метаданные, для запусков агентов, действий инструментов и регистрируемых по явному согласию событий жизненного цикла сообщений. Журнал по умолчанию включён для событий запусков и инструментов. Задайте [`audit.enabled: false`](/ru/gateway/configuration-reference#audit) и перезапустите Gateway, чтобы прекратить запись всех новых событий. Запись событий сообщений отдельно отключена по умолчанию; задайте для `audit.messages` значение `direct` или `all` и перезапустите Gateway, чтобы записывать их. Существующие записи остаются доступными для запросов до истечения срока их хранения (30 дней). Журнал существует отдельно от расшифровок разговоров: он записывает идентичность, порядок, происхождение, действие, статус и нормализованные коды результатов, но никогда не хранит содержимое, а идентификаторы сообщений представлены только локальными для установки ключевыми псевдонимами. В разделе [История аудита](/ru/gateway/audit) описаны полная модель данных, семантика конфиденциальности, ограничения хранения и срока хранения, а также пределы охвата; на этой странице рассматривается интерфейс команд. ```bash openclaw audit openclaw audit --agent main --status failed openclaw audit --session "agent:main:main" --after 2026-07-01T00:00:00Z openclaw audit --run 8c69f72e-8b11-4c54-98d5-1a3dd67450c3 openclaw audit --kind tool_action --limit 50 --json openclaw audit --kind message --direction outbound --channel telegram --json ``` ## Фильтры - `--agent `: точный идентификатор агента - `--session `: точный ключ сеанса - `--run `: точный идентификатор запуска - `--kind `: `agent_run`, `tool_action` или `message` - `--status `: `started`, `succeeded`, `failed`, `cancelled`, `timed_out`, `blocked` или `unknown` - `--direction `: направление сообщения, `inbound` или `outbound` - `--channel `: точный канал сообщения - `--after ` / `--before `: включительная временная метка ISO или время Unix в миллисекундах - `--limit `: размер страницы от 1 до 500; по умолчанию `100` - `--cursor `: продолжить предыдущий запрос с сортировкой от новых записей к старым - `--json`: вывести ограниченную страницу в формате JSON CLI обращается к версионированному RPC активности, поэтому одна команда показывает весь настроенный журнал. Текстовый вывод содержит время, тип, направление, канал, статус, агента, запуск и действие. Отсутствующее происхождение сообщения отображается как `-`; OpenClaw не создаёт вымышленные идентификаторы агентов или запусков. Для действий инструментов также отображается имя инструмента. Вывод JSON содержит `nextCursor`, если существует следующая страница. Передайте это значение параметру `--cursor`, чтобы продолжить без изменения порядка записей, поступивших во время постраничного просмотра. Эти экспортированные данные остаются конфиденциальными операционными метаданными, хотя тела сообщений и необработанные поля идентификации сообщений отсутствуют. Идентификаторы агентов, сеансов и запусков, время, каналы, результаты и стабильные ссылки HMAC позволяют сопоставлять действия. Защищайте их с помощью тех же средств управления доступом и правил хранения, что и другие операторские записи. ## Записываемые события Gateway преобразует доверенные потоки жизненного цикла в шесть действий: - `agent.run.started` - `agent.run.finished` - `tool.action.started` - `tool.action.finished` - `message.inbound.processed` - `message.outbound.finished` Каждая возвращаемая запись содержит стабильный идентификатор события, монотонно возрастающий порядковый номер в журнале, временную метку жизненного цикла, субъекта, действие, статус, маркер `schemaVersion: 1`, порядковый номер источника и `redaction: "metadata_only"`. Данные о происхождении агента, сеанса и запуска, а также поля конкретного события присутствуют только тогда, когда их предоставляет доверенный источник. В записях сообщений намеренно отсутствуют `sessionKey` и `sessionId`, поэтому фильтры `--session` применяются только к записям запусков и инструментов. Терминальные записи запусков и инструментов различают успешное завершение, сбой, отмену, тайм-аут и блокировки политиками с помощью закрытого статуса и кодов ошибок. `unknown` — это явный неуспешный результат, когда вышестоящая среда выполнения не предоставляет достоверный терминальный результат. Идентификаторы вызовов инструментов экспортируются только как стабильные отпечатки. Имена инструментов должны соответствовать контракту компактных имён, доступных модели; другие значения преобразуются в `unknown`. Записи сообщений дополнительно содержат направление, канал, тип разговора, результат и необязательные тип доставки, этап сбоя, длительность, количество результатов, нормализованный код причины и ключевые псевдонимы учётной записи, разговора, сообщения и адресата. Текущая граница входящих сообщений охватывает принятые сообщения, которые достигают основной диспетчеризации, включая результаты обработки дубликатов и терминальной обработки в ядре. На границе исходящих сообщений записывается одна терминальная строка для каждого исходного логического содержимого ответа, достигшего общей надёжной доставки; разбиение на части и разветвление адаптером агрегируются в `resultCount`. Поставленные в очередь повторяемые или неоднозначные отправки записываются только после того, как подтверждение, попадание в очередь недоставленных сообщений или сверка делает результат терминальным. Локальные для плагина и прямые пути отправки, обходящие эти общие границы, пока не охвачены; отсутствие строки не доказывает, что сообщения не существовало. Журнал аудита не заменяет расшифровки, историю задач, историю запусков Cron или журналы. Он предоставляет небольшой межзапусковый индекс для операторских запросов без копирования содержимого разговоров в другое хранилище. Для входящих строк `durationMs` измеряет диспетчеризацию ядра, а `resultCount` подсчитывает завершённые поставленные в очередь полезные нагрузки инструментов, блокировок и ответов. Для исходящих строк `durationMs` охватывает владение доставкой до её терминального результата (и, следовательно, время ожидания в очереди), а `resultCount` подсчитывает идентифицированные физические отправки на платформу. `deliveryKind`, когда присутствует, описывает фактическую полезную нагрузку после хуков и рендеринга; подавленные строки и строки с неоднозначным результатом из-за сбоя не содержат этого поля. ## RPC Gateway `audit.activity.list` требует `operator.read` и принимает те же фильтры. Он возвращает именованное объединение событий активности V1, включая записи запусков, инструментов, входящих и исходящих сообщений. ```bash openclaw gateway call audit.activity.list --params '{"channel":"telegram","limit":50}' ``` Результат — `{ "events": AuditActivityEventV1[], "nextCursor"?: string }`. Результаты отсортированы от новых к старым и ограничены 500 записями на запрос. Поставляемый RPC `audit.list` остаётся без изменений для старых клиентов запусков и инструментов. Когда `audit.activity.list` недоступен в старой версии Gateway, CLI повторяет запрос через `audit.list` только в том случае, если каждый запрошенный фильтр поддерживается этим устаревшим методом. `--kind message`, `--direction` и `--channel` завершаются ошибкой с сообщением о необходимости обновления в старой версии Gateway, а не молча отбрасываются. ## Связанные разделы - [История аудита](/ru/gateway/audit) - [Протокол Gateway](/ru/gateway/protocol#audit-ledger-rpc) - [Сеансы](/ru/cli/sessions) - [Задачи](/ru/cli/tasks) - [Задания Cron](/ru/automation/cron-jobs)