> ## 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. # Auditrecords # `openclaw audit` Doorzoek het metagegevens-only auditlogboek van de Gateway voor agentruns, toolacties en optionele levenscyclusrecords van berichten. Het logboek is standaard ingeschakeld voor run- en toolgebeurtenissen. Stel [`audit.enabled: false`](/nl/gateway/configuration-reference#audit) in en start de Gateway opnieuw om alle nieuwe gebeurtenisrecords te stoppen. Berichtrecords zijn afzonderlijk standaard uitgeschakeld; stel `audit.messages` in op `direct` of `all` en start de Gateway opnieuw om ze vast te leggen. Bestaande records blijven doorzoekbaar totdat ze verlopen (30 dagen). Het logboek staat los van gesprekstranscripten: het registreert identiteit, volgorde, herkomst, actie, status en genormaliseerde resultaatcodes, maar slaat nooit inhoud op, en bericht-ID's verschijnen uitsluitend als installatiegebonden gepseudonimiseerde waarden met sleutel. [Auditgeschiedenis](/nl/gateway/audit) bepaalt het volledige gegevensmodel, de privacysemantiek, opslag- en bewaarlimieten en dekkingsbeperkingen; deze pagina beschrijft het commando-oppervlak. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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 ``` ## Filters * `--agent `: exacte agent-ID * `--session `: exacte sessiesleutel * `--run `: exacte run-ID * `--kind `: `agent_run`, `tool_action` of `message` * `--status `: `started`, `succeeded`, `failed`, `cancelled`, `timed_out`, `blocked` of `unknown` * `--direction `: berichtrichting, `inbound` of `outbound` * `--channel `: exact berichtkanaal * `--after ` / `--before `: inclusief ISO-tijdstempel of Unix-milliseconden * `--limit `: paginagrootte van 1 tot 500; standaard `100` * `--cursor `: ga door met een eerdere query in volgorde van nieuwste naar oudste * `--json`: druk de begrensde pagina af als JSON De CLI doorzoekt de geversioneerde activiteits-RPC, zodat één commando het volledige geconfigureerde logboek toont. Tekstuitvoer toont tijd, soort, richting, kanaal, status, agent, run en actie. Ontbrekende berichtherkomst wordt weergegeven als `-`; OpenClaw verzint geen agent- of run-ID's. Toolacties tonen ook de toolnaam. JSON- uitvoer bevat `nextCursor` wanneer er nog een pagina bestaat. Geef die waarde door aan `--cursor` om door te gaan zonder records die tijdens het pagineren binnenkomen opnieuw te ordenen. Deze exports blijven gevoelige operationele metagegevens, ook al ontbreken berichtteksten en ruwe identiteitsvelden van berichten. Agent-, sessie- en run-ID's, timing, kanalen, resultaten en stabiele HMAC-verwijzingen kunnen activiteit correleren. Bescherm ze met dezelfde toegangscontroles en bewaarmethoden als andere operationele records. ## Vastgelegde gebeurtenissen De Gateway projecteert vertrouwde levenscyclusstromen naar zes acties: * `agent.run.started` * `agent.run.finished` * `tool.action.started` * `tool.action.finished` * `message.inbound.processed` * `message.outbound.finished` Elk geretourneerd record heeft een stabiele gebeurtenis-ID, een monotoon oplopende logboekvolgorde, een levenscyclustijdstempel, actor, actie, status, een `schemaVersion: 1`-markering, bronvolgorde en `redaction: "metadata_only"`. Herkomstgegevens van agent/sessie/run en gebeurtenisspecifieke velden zijn alleen aanwezig wanneer de vertrouwde bron ze aanlevert. Berichtrecords laten bewust `sessionKey` en `sessionId` weg, waardoor `--session` alleen run- en toolrecords filtert. Afgesloten run- en toolrecords onderscheiden succes, mislukking, annulering, time-out en beleidsblokkeringen met afgesloten status- en foutcodes. `unknown` is een expliciet niet-succesvol resultaat wanneer een bovenliggende runtime geen gezaghebbend eindresultaat beschikbaar stelt. Toolaanroep-ID's worden alleen geëxporteerd als stabiele vingerafdrukken. Toolnamen moeten overeenkomen met het compacte, modelgerichte naamcontract; andere waarden worden `unknown`. Berichtrecords voegen richting, kanaal, gesprekstype, resultaat en optioneel afleveringstype, mislukkingsfase, duur, resultaataantal, genormaliseerde redencode en gepseudonimiseerde account-/gesprek-/bericht-/doelwaarden met sleutel toe. De huidige inkomende grens omvat geaccepteerde berichten die de kerndispatch bereiken, inclusief dubbele kernberichten en uiteindelijke verwerkingsresultaten. De uitgaande grens schrijft één eindrecord per oorspronkelijke logische antwoordpayload die gedeelde duurzame aflevering bereikt; opsplitsing en adapterfan-out worden samengevoegd in `resultCount`. Retrybare of ambigue verzendingen in de wachtrij worden pas vastgelegd nadat een bevestiging, dead letter of reconciliatie het resultaat definitief maakt. Plugin-lokale en directe verzendpaden die deze gedeelde grenzen omzeilen, vallen nog niet onder de dekking; het ontbreken van een record bewijst niet dat er geen bericht bestond. Het auditlogboek vervangt geen transcripten, taakgeschiedenis, Cron-rungeschiedenis of logboeken. Het biedt een kleine index over meerdere runs voor operationele vragen zonder gespreksinhoud naar een andere opslag te kopiëren. Voor inkomende rijen meet `durationMs` de kerndispatch en telt `resultCount` afgeronde tool-, blok- en antwoordpayloads in de wachtrij. Voor uitgaande rijen omvat `durationMs` het eigenaarschap van de aflevering tot de eindstatus (en daardoor de wachttijd in de wachtrij), terwijl `resultCount` geïdentificeerde fysieke platformverzendingen telt. `deliveryKind` beschrijft, indien aanwezig, de effectieve payload na hooks en rendering; onderdrukte en door crashes ambigue rijen laten dit weg. ## Gateway-RPC `audit.activity.list` vereist `operator.read` en accepteert dezelfde filters. Deze retourneert de benoemde V1-unie van activiteitsgebeurtenissen, inclusief run-, tool-, inkomende-bericht- en uitgaande-berichtrecords. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw gateway call audit.activity.list --params '{"channel":"telegram","limit":50}' ``` Het resultaat is `{ "events": AuditActivityEventV1[], "nextCursor"?: string }`. Resultaten staan van nieuw naar oud en zijn beperkt tot 500 records per aanvraag. De meegeleverde `audit.list`-RPC blijft ongewijzigd voor oudere run-/toolclients. Wanneer `audit.activity.list` niet beschikbaar is op een oudere Gateway, probeert de CLI `audit.list` alleen opnieuw als elk aangevraagd filter door die oudere methode wordt ondersteund. `--kind message`, `--direction` en `--channel` mislukken op een oudere Gateway met een upgrademelding in plaats van stilzwijgend te worden genegeerd. ## Gerelateerd * [Auditgeschiedenis](/nl/gateway/audit) * [Gateway-protocol](/nl/gateway/protocol#audit-ledger-rpc) * [Sessies](/nl/cli/sessions) * [Taken](/nl/cli/tasks) * [Cron-taken](/nl/automation/cron-jobs)