Perché registrare
è cruciale

Eseguire OpenClaw in produzione senza strumenti di osservabilità è come volare alla cieca: i log del gateway, le tracce di audit delle approvazioni, le tracce degli strumenti del browser e la correlazione tra Docker e journal sono gli unici strumenti che consentono di eseguire il debug di agenti bloccati, tentativi di iniezione e cicli di riavvio.

✓ Tracce di controllo
✓ Gateway + Docker
✓ coda di approvazione
✓ Debug del prodotto

risposta diretta

Perché devi farlo?
Monitorare OpenClaw?

Risposta breve: Perché i problemi spesso risiedono negli strumenti, nelle approvazioni e nell'infrastruttura, non nel fatto che "il modello non risponde". Senza i log, non è possibile vedere le code bloccate, le interruzioni dei WebSocket o chi ha approvato un'azione distruttiva.

Sfumatura: Monitoraggio ≠ solo tempo di attività. L'osservabilità degli agenti AI comprende modelli comportamentali: tentativi di connessione, timeout del browser, flussi di lavoro anomali. Questa è governance, non metriche di vanità.

Problemi · docker · approvazioni

registri
utensili
audit
Approvare
Avviso
Coda
Correlare
GW+Docker

Osservabilità

Cosa ti serve per registrarti

approvazioni

In sospeso, concesso, negato: attore, timestamp, payload (comando, URL, oggetto dell'e-mail), ID di controllo. Senza questo, "L'IA non fa nulla" sembra un'interruzione del servizio.

Azioni del browser

naviga, clicca, invia — URL di destinazione, riepilogo del selettore, risultato. Connetti Automazione del browser incidenti

esecuzione terminale

Comando, codice di uscita, frammento di stderr: mai rivelare segreti completi in chiaro.

Chiamate API/upstream

Provider (Anthropic, compatibile con OpenAI, Ollama), stato HTTP, latenza: nessuna chiave API nei log.

Eventi del flusso di lavoro

Inizio/fine passaggio, ID flusso di lavoro, canale — per flusso di lavoro regressioni

Guasti e escalation

Strumento negato, timeout, disconnessione WebSocket, riavvio — con ID di correlazione su Gateway + contenitore.

Agenti AI

Perché gli agenti di intelligenza artificiale necessitano di un monitoraggio aggiuntivo

Risposta breve: piani probabilistici + esecuzione autonoma degli strumenti = modalità di errore prive delle classiche metriche delle applicazioni.

  • → Piani allucinatori presentati come chiamate di strumenti valide.
  • → Tentativi autonomi senza limiti → limiti di frequenza e spam di approvazione.
  • → Instabilità del browser: blocco, OOM, CAPTCHA — Gateway "integro", agente silenzioso.
  • → I tentativi di iniezione rapidi si manifestano come sequenze di strumenti insolite.
  • → Guasti a cascata: attivazione dell'e-mail → timeout del browser → approvazione bloccata → allungamento della coda.

Debug

Registri e debug da terminale

terminale
registri openclaw --follow

Previsto: Gateway pronto, l'agente esegue, lo strumento chiama

Se errato: silenzioso dopo le approvazioni in entrata → o servizio non funzionante

Prossimo: stato del gateway OpenClaw e medico OpenClaw

terminale
journalctl -u openclaw-gateway -f

Previsto: Log di systemd Gateway su hardware fisico

Se errato: restart-loop → config/auth prima delle metriche

Prossimo: journalctl -u openclaw-gateway -n 100 --no-pager

terminale
docker compose logs -f --tail=100

Previsto: output standard del contenitore + contesto di salute

Se errato: solo OOM/riavvio → docker RAM/salute

Prossimo: docker compose ps && curl …/healthz

terminale
stato dei canali openclaw --probe

Previsto: canali collegati

Se errato: disconnetti → WebSocket/proxy

Prossimo: Vedere Problemi

governance

Tracce di controllo
e responsabilità

Risposta breve: Registri per gli operatori; tracce di controllo per chi deciso riguardo alle azioni degli agenti mutageni.

  • ✓ Chi ha approvato quale comando distruttivo? — ID utente, non solo "approvato".
  • ✓ Conservazione immutabile o in sola aggiunta per le finestre di conformità.
  • ✓ Revisionabilità: esportazione della traccia di controllo in caso di incidente, senza la necessità di informazioni riservate sul prodotto.
  • ✓ Rollback: il pin di configurazione/immagine è collegato all'ID di controllo della distribuzione.
  • ✓ Responsabilità: separazione degli agenti di sviluppo/produzione nelle etichette dei log.
📋 Campi minimi di controllo
  • timestamp (UTC)
  • attore (utente/servizio)
  • tipo di azione + hash del payload
  • ID di correlazione flusso di lavoro/canale
  • concessione/rifiuto + versione della politica

produzione

Monitoraggio in produzione

Salute e tempo di attività

  • →/salute su Gateway — avviso per non-200
  • →Conteggio dei riavvii di systemd/Docker: nessun ciclo di crash "silenzioso".
  • →Sondaggio periodico del canale WebSocket

Code e lavoratori

  • →Profondità della coda di approvazione: avviso al di sopra della soglia
  • →Memoria di lavoro del browser — Statistiche Docker o metriche host
  • →Tasso di fallimento delle fasi del flusso di lavoro nelle 24 ore

Avvisi (realistici per le PMI)

  • →Gateway non pronto > 2 min
  • →Approvazioni in sospeso > N senza intervento umano
  • →Timeout ripetuto dello strumento del browser (>5/h)
  • →OOM / Uscita 137 sul container

Segnali

Quando gli agenti diventano inaffidabili

Cicli di ripetizione

Lo stesso strumento viene chiamato 50 volte — spesso si tratta di CAPTCHA, selezione errata o piano basato sull'iniezione.

Flussi di lavoro fuori controllo

Una tempesta di email innesca centinaia di esecuzioni, senza alcun limite di frequenza per gli inneschi.

Approvazioni violate

La coda è piena, nessuno riceve notifiche: l'agente sembra "guasto".

Pressione della memoria

Avvisi di heap → riavvio silenzioso — correlare con browser + Gateway su un VPS.

Contenitori di zombi

Vecchio contenitore browser/gateway accanto allo stack di composizione: conflitto di porte, log errati.

Operativo

Errori comuni nel monitoraggio

  • ✕ Nessun registro di controllo per approvare/rifiutare: impossibile analizzare l'incidente a posteriori.
  • ✕ Solo "L'IA ha detto X" senza payload dello strumento
  • ✕ Non salvare i log (journald vacuum, Docker log driver default small)
  • ✕ Nessun avviso di ciclo di riavvio: rilevato dall'utente
  • ✕ Arresti anomali del processo del browser non monitorati: i log del gateway appaiono normali.
  • ✕ Approvazioni in sospeso non presenti nella dashboard: diagnosi errata di "modello non funzionante".
  • ✕ Iniezione rapida non riconosciuta: nessun avviso per catene di strumenti anomale

FAQ

Registri e
Domande frequenti sul monitoraggio

Risposta immediata a ogni domanda: brevi estratti e panoramiche generate dall'IA.

Risoluzione dei problemi →

Risposta breve: Gli agenti IA non sono deterministici: i log mostrano le chiamate agli strumenti, le approvazioni e gli errori, informazioni necessarie per il debug e la governance.

Causa: La sola chat non è sufficiente per la produzione.

Consiglio: Accedi a Gateway + strumenti + approvazioni con ID di correlazione.

Risposta breve: Approvazioni, strumenti browser/terminale/API, fasi del flusso di lavoro, disconnessioni WebSocket, riavvii: con attore e timestamp.

Causa: Modificare gli atti senza verifica = lacuna di conformità.

Consiglio: Nessun segreto scritto in chiaro.

Risposta breve: URL per azione + risultato + frequenza di timeout; RAM del worker; approvazione all'invio.

Causa: Il problema DOM/blocco non è visibile nei log del solo Gateway.

Consiglio: Automazione del browser metrica

Risposta breve: Solitamente si verifica un errore in healthz, un errore di memoria insufficiente (OOM) o un arresto anomalo del gateway — leggi log di Docker Compose prima del riavvio.

Causa: configurazione, memoria, doppio Gateway.

Consiglio: docker + Problemi.

Risposta breve: Registri immutabili (o in sola aggiunta) di chi ha utilizzato quale strumento/approvato quale azione: responsabilità, non "ha deciso l'IA".

Causa: regolamentazione e analisi interne post-mortem.

Consiglio: approvazioni Registrazione necessaria in ambiente di produzione.

Risposta breve: Sequenze di strumenti anomale dopo la posta/navigazione: URL inaspettati di shell, esportazione e amministrazione; non è un rilevatore perfetto, ma registra e segnala.

Causa: L'iniezione attiva i piani, non una "firma del virus".

Consiglio: Sicurezza + nega le regole sugli strumenti.

Risposta breve: Senza un audit di approvazione/rifiuto, non è possibile sapere se un'azione sia stata causata da persone o da politiche aziendali: un punto cruciale in caso di provvedimenti dannosi.

Causa: maschere di coda in sospeso come errore dell'IA.

Consiglio: Avviso sulla profondità della coda + registrazione di ogni cambio di stato.

Osservabilità

Monitoraggio e audit
È arredato?

Analizziamo i log di Gateway, i registri di controllo delle approvazioni, la conservazione dei dati Docker/journald e gli avvisi relativi alla profondità della coda, ai riavvii e agli errori degli strumenti del browser, per le aziende che utilizzano OpenClaw in produzione. Inviaci la tua configurazione di log attuale (senza dati sensibili).

✓ Tracce di controllo
✓ governance
✓ Su misura