.zip voor bugrapporten maken: opgeschoonde Gateway-
status, statuscontroles, logboeken, configuratiestructuur en recente stabiliteitsgebeurtenissen zonder payload.
Behandel diagnostische bundels als geheimen totdat ze zijn gecontroleerd. Payloads en aanmeldgegevens
worden standaard geredigeerd, maar de bundel bevat nog steeds een samenvatting van lokale Gateway-logboeken en
runtimestatus op hostniveau.
Snel aan de slag
Chatopdracht
Eigenaren kunnen/diagnostics [note] in elk gesprek uitvoeren om een lokale
Gateway-export aan te vragen als één kopieerbaar ondersteuningsrapport:
- Verstuur
/diagnostics, eventueel met een korte opmerking (/diagnostics bad tool choice). - OpenClaw stuurt een inleiding en vraagt om één expliciete uitvoeringsgoedkeuring, waarmee
openclaw gateway diagnostics export --jsonwordt uitgevoerd. Keur diagnostiek niet goed via een regel die alles toestaat. - Na goedkeuring antwoordt OpenClaw met het lokale bundelpad, een samenvatting van het manifest, privacyopmerkingen en relevante sessie-id’s.
/diagnostics uitvoeren, maar OpenClaw stuurt het
exportresultaat, de goedkeuringsverzoeken en het overzicht van Codex-sessies en -threads
privé naar de eigenaar. De groep ziet alleen een korte melding dat de diagnostiek
privé is verzonden. Als er geen privéroute naar de eigenaar bestaat, wordt de opdracht veilig geweigerd en wordt
de eigenaar gevraagd deze vanuit een privébericht uit te voeren.
Wanneer de actieve sessie de native OpenAI Codex-harness gebruikt, geldt dezelfde uitvoeringsgoedkeuring
ook voor het uploaden van OpenAI-feedback over de Codex-threads die OpenClaw
kent. Die upload staat los van het lokale Gateway-zipbestand en vindt alleen
plaats voor Codex-harnesssessies. In het goedkeuringsverzoek staat dat goedkeuring
ook Codex-feedback verstuurt, zonder Codex-sessie- of thread-id’s te vermelden. Na
goedkeuring vermeldt het antwoord kanalen, OpenClaw-sessie-id’s, Codex-thread-id’s en
lokale hervattingsopdrachten voor de threads die naar OpenAI zijn verzonden. Als de goedkeuring wordt
geweigerd of genegeerd, worden de export, de upload van Codex-feedback en de
lijst met Codex-id’s overgeslagen.
Dat maakt de foutopsporingscyclus voor Codex kort: merk ongewenst gedrag in een kanaal op,
voer /diagnostics uit, keur één keer goed, deel het rapport en voer vervolgens lokaal de weergegeven
opdracht codex resume <thread-id> uit als je de thread
zelf wilt inspecteren. Zie Codex-harness.
Wat de export bevat
summary.md: voor mensen leesbaar overzicht voor ondersteuning.diagnostics.json: machineleesbare samenvatting van configuratie, logboeken, status, statuscontroles en stabiliteitsgegevens.manifest.json: exportmetadata en bestandenlijst.- Opgeschoonde configuratiestructuur en niet-geheime configuratiegegevens.
- Opgeschoonde logboeksamenvattingen en recente geredigeerde logboekregels.
- Gateway-status- en statuscontrolemomentopnamen op basis van beschikbare gegevens.
stability/latest.json: nieuwste opgeslagen stabiliteitsbundel, indien beschikbaar.
Privacymodel
Behouden: namen van subsystemen, plugin-id’s, provider-id’s, kanaal-id’s, geconfigureerde modi, statuscodes, tijdsduren, aantallen bytes, wachtrijstatus, geheugengegevens, opgeschoonde logboekmetadata, geredigeerde operationele berichten, configuratiestructuur en niet-geheime functie-instellingen. Weggelaten of geredigeerd: chattekst, prompts, instructies, webhook-bodies, tooluitvoer, aanmeldgegevens, API-sleutels, tokens, cookies, geheime waarden, onbewerkte request-/response-bodies, account-id’s, bericht-id’s, onbewerkte sessie-id’s, hostnamen en lokale gebruikersnamen. Wanneer een logboekbericht lijkt op tekst uit een gebruikers-, chat-, prompt- of toolpayload, vermeldt de export alleen dat een bericht is weggelaten, plus het aantal bytes.Stabiliteitsrecorder
De Gateway registreert standaard een begrensde stabiliteitsstroom zonder payload wanneer diagnostiek is ingeschakeld. Deze legt operationele feiten vast, geen inhoud. Dezelfde Heartbeat bemonstert ook de activiteit wanneer de eventloop of CPU verzadigd lijkt, en genereertdiagnostic.liveness.warning-gebeurtenissen met eventloopvertraging,
eventloopgebruik, CPU-kernverhouding, aantallen actieve/wachtende/in de wachtrij geplaatste sessies,
de huidige opstart-/runtimefase (indien bekend), recente fasespannen en
begrensde werklabels. Deze worden alleen Gateway-logboekregels op niveau warn wanneer
werk wacht of in de wachtrij staat, of wanneer actief werk samenvalt met aanhoudende eventloopvertraging;
anders worden ze vastgelegd op debug. Activiteitsmetingen bij inactiviteit worden nog steeds geregistreerd
als diagnostische gebeurtenissen, maar leiden op zichzelf nooit tot een waarschuwing.
Opstartfasen genereren diagnostic.phase.completed-gebeurtenissen met kloktijd- en
CPU-timing. Diagnostiek voor vastgelopen ingebedde uitvoeringen markeert terminalProgressStale=true
wanneer de laatste bridge-voortgang terminaal leek (bijvoorbeeld een onbewerkt response-item
of een gebeurtenis voor voltooiing van een response), maar de Gateway de
ingebedde uitvoering nog steeds als actief beschouwt.
Inspecteer de live recorder:
~/.openclaw/logs/stability/ wanneer er gebeurtenissen bestaan.
Nuttige opties
Diagnostiek uitschakelen
Diagnostiek is standaard ingeschakeld. De stabiliteitsrecorder en verzameling van diagnostische gebeurtenissen uitschakelen:rss_threshold, heap_threshold, rss_growth) zonder een
bestandssysteemscan uit te voeren of een momentopname van vóór een OOM te schrijven.
Gerelateerd
- Statuscontroles
- Gateway-CLI
- Gateway-protocol
- Logboekregistratie
- OpenTelemetry-export - afzonderlijke flow voor het streamen van diagnostiek naar een collector