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.
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à.
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
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
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
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
stato dei canali openclaw --probe
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.
- 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à
- →
/salutesu 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 Dockero 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
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: 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).