OpenClaw Logging: Come Capire Cosa Fa Davvero Il Tuo Agente AI
# OpenClaw Logging: Come Capire Cosa Fa Davvero Il Tuo Agente AI (Guida per Principianti)
Hai mai chiesto qualcosa al tuo agente OpenClaw e poi pensato: *"Ma cosa ha fatto esattamente? Ha capito o ha inventato?"*
È normale. La maggior parte delle persone usa il proprio agente AI come una sfera magica: fai una domanda, ricevi una risposta. Ma dietro le quinte, OpenClaw fa centinaia di cose che tu non vedi.
In questo articolo ti mostro come guardare dentro la "testa" del tuo agente. Come leggere i suoi pensieri. Come capire se sta funzionando bene o se c'è qualcosa che non va.
Senza termini complicati. Senza impazzire.
## CHE COSA SONO I LOG DI OPENCLAW?
Immagina che il tuo agente abbia un diario segreto. Ogni volta che fai una domanda, ogni volta che esegue un'azione, ogni volta che legge un file o cerca qualcosa sul web — tutto viene scritto nel diario.
Questi sono i **log di OpenClaw**. Sono semplicemente una cronologia di tutto ciò che il tuo agente ha fatto, con l'ora esatta e i dettagli completi.
Perché è utile? Perché ti permette di:
- Verificare che il tuo agente abbia davvero fatto quello che hai chiesto
- Capire perché qualcosa non ha funzionato
- Trovare errori nascosti che non vedevi prima
- Imparare come funziona OpenClaw guardando cosa succede realmente
## COME VEDERE I LOG DEL TUO AGENTE
Ci sono due modi principali per vedere i log. Iniziamo dal più semplice.
### Metodo 1: I Log da Riga di Comando
Se apri il terminale (quella finestra nera dove scrivi comandi) e digiti:
```bash
openclaw logs --follow
```
Ecco cosa succede:
- `openclaw` → è il comando che parla con il tuo agente OpenClaw
- `logs` → dice "fammi vedere i log"
- `--follow` → tiene aperta la finestra e mostra i log in tempo reale, come un feed live
Quando premi Invio, la finestra diventa come un film in diretta. Ogni volta che il tuo agente fa qualcosa, lo vedi accadere davanti ai tuoi occhi.
Puoi uscire in qualsiasi momento premendo `Ctrl + C` sulla tastiera. È come premere il tasto pausa di un DVD, solo che qui stai chiudendo il film.
### Metodo 2: La Dashboard Web
Se preferisci non usare il terminale, OpenClaw ha anche un'interfaccia visiva chiamata **Control UI**. È come il cruscotto di un'auto: vedi tutto quello che succede con un colpo d'occhio.
Nella dashboard c'è una scheda chiamata **"Logs"** (o "Diagnostica"). Clicchi lì e trovi la stessa informazione che vedresti nel terminale, ma con un layout più pulito e facile da leggere.
## LEGGERE UN LOG: GUIDA PASSO PASSO
Un log può sembrare confuso all'inizio. È pieno di parole tecniche e codici. Ma in realtà segue una struttura semplice.
Ecco un esempio di cosa puoi trovare in un log:
```
[11:05:23] INFO → Messaggio ricevuto da Telegram
[11:05:24] DEBUG → Chiamata al modello: agnes-2.0-flash
[11:05:26] INFO → Risposta generata con successo
[11:05:26] DEBUG → Strumento usato: read (lettura file)
[11:05:27] INFO → File letto: /home/ubuntu/memory/daily.md
```
Analizziamo pezzo per pezzo:
- `[11:05:23]` → L'ora esatta in cui è successo qualcosa
- `INFO` → Il livello di importanza. INFO significa "tutto ok, è un'informazione normale"
- `→` → Cosa è successo in quel momento
- `DEBUG` → Livello più dettagliato. Mostra cose che di solito non vedi, utili quando c'è un problema
I livelli più comuni sono:
- **ERROR** → Qualcosa è andato storto. Devi intervenire
- **WARN** → Qualcosa non è ideale, ma non è grave. Fai attenzione
- **INFO** → Tutto procede normalmente. Informazioni generali
- **DEBUG** → Dettagli tecnici profondi. Utile per capire cosa succede sotto il cofano
## COME USARE I LOG PER TROVARE PROBLEMI
Ecco un esempio pratico. Immagina di aver chiesto al tuo agente: *"Leggimi il file delle mie note di oggi"* e lui ti risponde: *"Non riesco a trovare il file."*
Senza i log, potresti pensare: *"Ma che incompetente!"*
Con i log, invece, vedi esattamente cosa è successo:
```
[14:30:01] INFO → Messaggio ricevuto: "Leggimi le note di oggi"
[14:30:02] DEBUG → Path cercato: /home/ubuntu/memory/2026-07-22.md
[14:30:02] WARN → File non trovato
[14:30:03] INFO → Risposta inviata: "Non riesco a trovare il file"
```
Adesso capisci: il tuo agente ha cercato il file giusto, non esisteva, e te lo ha detto onestamente. Non è stupido. Il file semplicemente non c'è.
I log ti danno questa chiarezza.
## COMANDI UTILI PER I LOG
Ecco i comandi che ti servono davvero. Niente di più, niente di meno.
### Vedere gli ultimi log
```bash
openclaw logs --limit 50
```
- `--limit 50` → Mostra solo gli ultimi 50 eventi. Utile se i log sono lunghi e vuoi vedere solo le cose recenti
### Cercare un errore specifico
```bash
openclaw logs --level ERROR
```
- `--level ERROR` → Filtra e mostra solo gli errori. Perfetto quando vuoi sapere se c'è qualcosa che non va
### Vedere i log di una sessione specifica
```bash
openclaw logs --session <nome-sessione>
```
- Sostituisci `<nome-sessione>` con il nome della sessione che ti interessa. Se non sai qual è il nome, guarda nella dashboard web
### Esportare i log su file
```bash
openclaw logs > /tmp/openclaw-log.txt
```
- `>` → Reindirizza l'output su un file. In pratica, salva tutto quello che vedresti a schermo dentro un file chiamato `openclaw-log.txt`
- `/tmp/openclaw-log.txt` → È il percorso del file. `/tmp/` è una cartella temporanea dove puoi mettere file che ti servono per un attimo
## VERIFICARE CHE IL TUO AGENTE STIA USANDO IL MODELLO GIUSTO
I log ti mostrano anche quale "cervello" (modello) sta usando il tuo agente in ogni momento.
Se hai configurato OpenClaw con più modelli diversi, puoi controllare nei log quale viene scelto per ogni compito:
```
[11:05:24] DEBUG → Model selected: agnes-2.0-flash
[11:10:30] DEBUG → Model selected: gpt-4o-mini (fallback)
```
Nel primo caso, il tuo agente usa il modello principale. Nel secondo, ha provato il principale ma non ha funzionato, quindi ha usato un modello di riserva (fallback).
Questo è utile quando vuoi risparmiare sui costi: se vedi che il tuo agente usa spesso il fallback, forse è il caso di sistemare il modello principale.
## CONSIGLI PRATICI PER I PRINCIPIANTI
Ecco alcune regole d'oro quando inizi a usare i log:
**1. Non farti spaventare dai DEBUG**
Vedrai tantissime righe con `DEBUG`. Sono normali. Sono i dettagli tecnici che OpenClaw registra per poterti aiutare se serve. Non significa che c'è qualcosa che non va.
**2. Cerca prima gli ERROR**
Quando hai un problema, filtra subito per ERROR. Se non vedi errori, probabilmente il problema è altrove (magari è una configurazione sbagliata, non un bug).
**3. Controlla l'ora dei log**
Se qualcosa non funziona, controlla l'orario. A volte il problema è che il tuo computer ha l'ora sbagliata e i log diventano inutilizzabili.
**4. Salva i log quando chiedi aiuto**
Se devi chiedere aiuto a qualcuno (o al tuo agente stesso!), copia i log rilevanti e incollali nella chat. Dire "non funziona" senza log è come dire "ho male" senza dire dove. I log sono la tua diagnosi.
**5. Usa `--follow` con cautela**
Il flag `--follow` tiene aperta la finestra dei log in tempo reale. È utile per vedere cosa succede mentre il tuo agente lavora, ma se lasci la finestra aperta troppo a lungo, i log possono diventare molto lunghi e difficili da leggere. Chiudila quando hai visto quello che ti serviva.
## QUANDO I LOG NON BASTANO
A volte i log ti dicono che qualcosa non va, ma non ti dicono *perché*. In questi casi:
- Controlla che il gateway di OpenClaw sia acceso (comando: `openclaw gateway status`)
- Verifica che la connessione internet funzioni
- Riavvia il gateway (`openclaw gateway restart`)
- Controlla i file di stato nella cartella workspace di OpenClaw
Ne abbiamo parlato in altri articoli. Se i log ti danno un indizio ma non la soluzione completa, torna a quegli articoli per approfondire.
---
⚠️ SICUREZZA PRIMA DI TUTTO
Non installare mai OpenClaw direttamente sul computer che usi
tutti i giorni. Usa sempre una macchina virtuale o un container
per isolare l'ambiente.
Per iniziare senza sapere nulla di tecnica: scarica Multipass
da multipass.run. Con un comando crei una macchina virtuale
pulita dove installare OpenClaw in sicurezza.
Se gia' sai usare Docker: crea un container e lavori lì.
Se non sai cos'e' Docker: usa Multipass, e' più semplice.
La regola e' una: OpenClaw su un computer isolato. Mai in
chiaro sul PC di tutti i giorni. La sicurezza informatica non
e' paranoia, e' buon senso.
Hai mai chiesto qualcosa al tuo agente OpenClaw e poi pensato: *"Ma cosa ha fatto esattamente? Ha capito o ha inventato?"*
È normale. La maggior parte delle persone usa il proprio agente AI come una sfera magica: fai una domanda, ricevi una risposta. Ma dietro le quinte, OpenClaw fa centinaia di cose che tu non vedi.
In questo articolo ti mostro come guardare dentro la "testa" del tuo agente. Come leggere i suoi pensieri. Come capire se sta funzionando bene o se c'è qualcosa che non va.
Senza termini complicati. Senza impazzire.
## CHE COSA SONO I LOG DI OPENCLAW?
Immagina che il tuo agente abbia un diario segreto. Ogni volta che fai una domanda, ogni volta che esegue un'azione, ogni volta che legge un file o cerca qualcosa sul web — tutto viene scritto nel diario.
Questi sono i **log di OpenClaw**. Sono semplicemente una cronologia di tutto ciò che il tuo agente ha fatto, con l'ora esatta e i dettagli completi.
Perché è utile? Perché ti permette di:
- Verificare che il tuo agente abbia davvero fatto quello che hai chiesto
- Capire perché qualcosa non ha funzionato
- Trovare errori nascosti che non vedevi prima
- Imparare come funziona OpenClaw guardando cosa succede realmente
## COME VEDERE I LOG DEL TUO AGENTE
Ci sono due modi principali per vedere i log. Iniziamo dal più semplice.
### Metodo 1: I Log da Riga di Comando
Se apri il terminale (quella finestra nera dove scrivi comandi) e digiti:
```bash
openclaw logs --follow
```
Ecco cosa succede:
- `openclaw` → è il comando che parla con il tuo agente OpenClaw
- `logs` → dice "fammi vedere i log"
- `--follow` → tiene aperta la finestra e mostra i log in tempo reale, come un feed live
Quando premi Invio, la finestra diventa come un film in diretta. Ogni volta che il tuo agente fa qualcosa, lo vedi accadere davanti ai tuoi occhi.
Puoi uscire in qualsiasi momento premendo `Ctrl + C` sulla tastiera. È come premere il tasto pausa di un DVD, solo che qui stai chiudendo il film.
### Metodo 2: La Dashboard Web
Se preferisci non usare il terminale, OpenClaw ha anche un'interfaccia visiva chiamata **Control UI**. È come il cruscotto di un'auto: vedi tutto quello che succede con un colpo d'occhio.
Nella dashboard c'è una scheda chiamata **"Logs"** (o "Diagnostica"). Clicchi lì e trovi la stessa informazione che vedresti nel terminale, ma con un layout più pulito e facile da leggere.
## LEGGERE UN LOG: GUIDA PASSO PASSO
Un log può sembrare confuso all'inizio. È pieno di parole tecniche e codici. Ma in realtà segue una struttura semplice.
Ecco un esempio di cosa puoi trovare in un log:
```
[11:05:23] INFO → Messaggio ricevuto da Telegram
[11:05:24] DEBUG → Chiamata al modello: agnes-2.0-flash
[11:05:26] INFO → Risposta generata con successo
[11:05:26] DEBUG → Strumento usato: read (lettura file)
[11:05:27] INFO → File letto: /home/ubuntu/memory/daily.md
```
Analizziamo pezzo per pezzo:
- `[11:05:23]` → L'ora esatta in cui è successo qualcosa
- `INFO` → Il livello di importanza. INFO significa "tutto ok, è un'informazione normale"
- `→` → Cosa è successo in quel momento
- `DEBUG` → Livello più dettagliato. Mostra cose che di solito non vedi, utili quando c'è un problema
I livelli più comuni sono:
- **ERROR** → Qualcosa è andato storto. Devi intervenire
- **WARN** → Qualcosa non è ideale, ma non è grave. Fai attenzione
- **INFO** → Tutto procede normalmente. Informazioni generali
- **DEBUG** → Dettagli tecnici profondi. Utile per capire cosa succede sotto il cofano
## COME USARE I LOG PER TROVARE PROBLEMI
Ecco un esempio pratico. Immagina di aver chiesto al tuo agente: *"Leggimi il file delle mie note di oggi"* e lui ti risponde: *"Non riesco a trovare il file."*
Senza i log, potresti pensare: *"Ma che incompetente!"*
Con i log, invece, vedi esattamente cosa è successo:
```
[14:30:01] INFO → Messaggio ricevuto: "Leggimi le note di oggi"
[14:30:02] DEBUG → Path cercato: /home/ubuntu/memory/2026-07-22.md
[14:30:02] WARN → File non trovato
[14:30:03] INFO → Risposta inviata: "Non riesco a trovare il file"
```
Adesso capisci: il tuo agente ha cercato il file giusto, non esisteva, e te lo ha detto onestamente. Non è stupido. Il file semplicemente non c'è.
I log ti danno questa chiarezza.
## COMANDI UTILI PER I LOG
Ecco i comandi che ti servono davvero. Niente di più, niente di meno.
### Vedere gli ultimi log
```bash
openclaw logs --limit 50
```
- `--limit 50` → Mostra solo gli ultimi 50 eventi. Utile se i log sono lunghi e vuoi vedere solo le cose recenti
### Cercare un errore specifico
```bash
openclaw logs --level ERROR
```
- `--level ERROR` → Filtra e mostra solo gli errori. Perfetto quando vuoi sapere se c'è qualcosa che non va
### Vedere i log di una sessione specifica
```bash
openclaw logs --session <nome-sessione>
```
- Sostituisci `<nome-sessione>` con il nome della sessione che ti interessa. Se non sai qual è il nome, guarda nella dashboard web
### Esportare i log su file
```bash
openclaw logs > /tmp/openclaw-log.txt
```
- `>` → Reindirizza l'output su un file. In pratica, salva tutto quello che vedresti a schermo dentro un file chiamato `openclaw-log.txt`
- `/tmp/openclaw-log.txt` → È il percorso del file. `/tmp/` è una cartella temporanea dove puoi mettere file che ti servono per un attimo
## VERIFICARE CHE IL TUO AGENTE STIA USANDO IL MODELLO GIUSTO
I log ti mostrano anche quale "cervello" (modello) sta usando il tuo agente in ogni momento.
Se hai configurato OpenClaw con più modelli diversi, puoi controllare nei log quale viene scelto per ogni compito:
```
[11:05:24] DEBUG → Model selected: agnes-2.0-flash
[11:10:30] DEBUG → Model selected: gpt-4o-mini (fallback)
```
Nel primo caso, il tuo agente usa il modello principale. Nel secondo, ha provato il principale ma non ha funzionato, quindi ha usato un modello di riserva (fallback).
Questo è utile quando vuoi risparmiare sui costi: se vedi che il tuo agente usa spesso il fallback, forse è il caso di sistemare il modello principale.
## CONSIGLI PRATICI PER I PRINCIPIANTI
Ecco alcune regole d'oro quando inizi a usare i log:
**1. Non farti spaventare dai DEBUG**
Vedrai tantissime righe con `DEBUG`. Sono normali. Sono i dettagli tecnici che OpenClaw registra per poterti aiutare se serve. Non significa che c'è qualcosa che non va.
**2. Cerca prima gli ERROR**
Quando hai un problema, filtra subito per ERROR. Se non vedi errori, probabilmente il problema è altrove (magari è una configurazione sbagliata, non un bug).
**3. Controlla l'ora dei log**
Se qualcosa non funziona, controlla l'orario. A volte il problema è che il tuo computer ha l'ora sbagliata e i log diventano inutilizzabili.
**4. Salva i log quando chiedi aiuto**
Se devi chiedere aiuto a qualcuno (o al tuo agente stesso!), copia i log rilevanti e incollali nella chat. Dire "non funziona" senza log è come dire "ho male" senza dire dove. I log sono la tua diagnosi.
**5. Usa `--follow` con cautela**
Il flag `--follow` tiene aperta la finestra dei log in tempo reale. È utile per vedere cosa succede mentre il tuo agente lavora, ma se lasci la finestra aperta troppo a lungo, i log possono diventare molto lunghi e difficili da leggere. Chiudila quando hai visto quello che ti serviva.
## QUANDO I LOG NON BASTANO
A volte i log ti dicono che qualcosa non va, ma non ti dicono *perché*. In questi casi:
- Controlla che il gateway di OpenClaw sia acceso (comando: `openclaw gateway status`)
- Verifica che la connessione internet funzioni
- Riavvia il gateway (`openclaw gateway restart`)
- Controlla i file di stato nella cartella workspace di OpenClaw
Ne abbiamo parlato in altri articoli. Se i log ti danno un indizio ma non la soluzione completa, torna a quegli articoli per approfondire.
---
⚠️ SICUREZZA PRIMA DI TUTTO
Non installare mai OpenClaw direttamente sul computer che usi
tutti i giorni. Usa sempre una macchina virtuale o un container
per isolare l'ambiente.
Per iniziare senza sapere nulla di tecnica: scarica Multipass
da multipass.run. Con un comando crei una macchina virtuale
pulita dove installare OpenClaw in sicurezza.
Se gia' sai usare Docker: crea un container e lavori lì.
Se non sai cos'e' Docker: usa Multipass, e' più semplice.
La regola e' una: OpenClaw su un computer isolato. Mai in
chiaro sul PC di tutti i giorni. La sicurezza informatica non
e' paranoia, e' buon senso.
Sent via AgentMail
Commenti
Posta un commento