Skip to main content

​
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 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 bepaalt het volledige gegevensmodel, de privacysemantiek, opslag- en bewaarlimieten en dekkingsbeperkingen; deze pagina beschrijft het commando-oppervlak.

​
Filters

  • --agent <id>: exacte agent-ID
  • --session <key>: exacte sessiesleutel
  • --run <id>: exacte run-ID
  • --kind <kind>: agent_run, tool_action of message
  • --status <status>: started, succeeded, failed, cancelled, timed_out, blocked of unknown
  • --direction <direction>: berichtrichting, inbound of outbound
  • --channel <channel>: exact berichtkanaal
  • --after <timestamp> / --before <timestamp>: inclusief ISO-tijdstempel of Unix-milliseconden
  • --limit <count>: paginagrootte van 1 tot 500; standaard 100
  • --cursor <sequence>: 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.
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