Arxi Decision Gate Asset Core
Docs
Arxi Docs

Documentació de gravació de proves i evidències que mostren manipulació.

Altres documents de producte

Arxi OpenClaw Integració Arquitectura

Audiència: Enginyers que implementen o validen el acoblament d’OpenClaw a Arxi.

Taula de continguts

  1. Visió Executiva
  2. Mapping Contract
  3. Política de Redacció i Càrrega Limitada
  4. Política de Bretxa de Seqüència
  5. Modes de signatura i verificació
  6. Fixture i Cobertura de Proves
  7. Limits actuals i pròxims passos

Executive Overview

Arxi integra fluxos d’OpenClaw a través d’un adaptador d’ingestió determinista basat en fixtures en system-tests. La integració registra esdeveniments d’agents d’OpenClaw com a sobres d’Arxi utilitzant una política de mapeig versionada, gestió explícita de buits de seqüència i validació de tancament en cas d’error mitjançant LocalRecorderAdapter.

F:system-tests/tests/suites/integration_openclaw.rs L1-L220

Mapping Contract

Els payloads d’esdeveniment d’OpenClaw es mapegen a sobres d’Arxi amb aquest contracte:

  • Mapeig del tipus d’esdeveniment: openclaw.<stream>.<phase_or_default>.
  • Mapping version marker: envelope payload includes Indicador de versió del mapeig: la càrrega útil de l’enviament inclou mapping.mapping_version = "openclaw_arxi_v1".
  • Deterministic IDs: envelope IDs are derived from IDs deterministes: els IDs d’envelopa es deriven de (run_id, seq, stream, session_key) utilitzant el mapeig SHA-256-a-UUIDv7.
  • Correlació de traç: OpenClaw runId es mapa a Arxi trace_id.

F:system-tests/tests/suites/integration_openclaw.rs L224-L387

Redacció i Política de Càrrega Limitada

Per reduir el risc de divulgació i d’esgotament de recursos en proves immutables:

  • Sensitive keys are redacted using hash-only summaries under Les claus sensibles són redactades utilitzant resums només amb hash sota openclaw_redaction_v1.
  • Long strings are truncated at MAX_STRING_CHARS with deterministic Les cadenes llargues es truncaran a MAX_STRING_CHARS amb un resum determinista + metadades de vista prèvia.
  • Oversized JSON payload fragments are bounded at Els fragments de càrrega útil JSON de gran mida estan limitats a MAX_EVENT_DATA_BYTES amb metadades de resum deterministes.
  • Session keys are stored as SHA-256 digests (session_key_sha256) in Les claus de sessió es desant com a resums SHA-256 (session_key_sha256) en metadades de càrrega útil.
  • Sanitization counters (redacted_fields, truncated_fields) are stored Els comptadors de sanitització (redacted_fields, truncated_fields) es guarden per a l’auditoria.

F:system-tests/tests/suites/integration_openclaw.rs L62-L100 F:system-tests/tests/suites/integration_openclaw.rs L245-L387 F:system-tests/tests/suites/integration_openclaw.rs L656-L809

Política de Sequència-Gap

Dos modes estan implementats i validades:

  • record_anomaly: record openclaw.integration.sequence_gap envelope and record_anomaly: registrar l’envolup openclaw.integration.sequence_gap i continuar la ingestió.
  • strict_fail: fallar tancat immediatament en cas de buit i aturar la ingestió.

F:system-tests/tests/suites/integration_openclaw.rs L390-L446 F:system-tests/tests/suites/integration_openclaw.rs L573-L658

Modes de Signatura i Verificació

Les proves d’integració s’executen tant:

  • Unsigned lane: vàlid-amb-advertències (SignatureVerificationSkipped).
  • Signed lane: verificació estricta de la confiança arrel mitjançant TrustPolicy::AllMustSign.

F:system-tests/tests/suites/integration_openclaw.rs L498-L572

Fixture i Cobertura de Proves

La cobertura d’integració d’OpenClaw actualment inclou:

  • Ingesta i verificació del flux de simulació del gateway.
  • Ingesta i verificació del flux de retrocés al estil CLI.
  • Anomalia de seqüència-gap i comportaments de fallada estricta.
  • Comprovacions de redacció de camps d’eines sensibles.
  • Comprovacions de delimitació del camp d’assistent de mida excessiva.
  • Comprovacions de stabilitat del hash de reproducció determinista.

Fixtures:

  • system-tests/tests/fixtures/openclaw_gateway_mock_events.json
  • system-tests/tests/fixtures/openclaw_cli_mock_events.json

Entrades del registre: F:system-tests/test_registry.toml L1-L260

Límits Actuals i Properes Passes

Límits actuals:

  • Mapping is implemented in system-tests harness code, not yet extracted as a El mapeig s’implementa en el codi de proves del sistema, encara no s’ha extret com a un contenidor d’integració de producció.
  • Redaction uses key-name policy and deterministic summaries; context-aware La redacció utilitza una política de nom-clau i resums deterministes; la classificació de camps conscient del context és una extensió futura.

Passos següents naturals:

  1. Extreure el mapejador en el mòdul/runtime arxi-openclaw-adapter.
  2. Afegir corpus de fixtures per a fluxos de caos de timeout/fallback d’OpenClaw.
  3. Afegir fixtures de política per a perfils de redacció d’allowlist/denylist explícits.