> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Plugin del registro di attività Il Plugin Logbook trasforma l'attività sullo schermo in un diario di lavoro automatico. Acquisisce istantanee periodiche dello schermo da un Node associato, le riassume in osservazioni con indicazione temporale e crea schede cronologiche nella [UI di controllo](/it/web/control-ui). Può inoltre generare note per il resoconto giornaliero e rispondere a domande su una giornata monitorata. Lo stato gestito da OpenClaw rimane nel Gateway, in `/logbook/`, ma l'elaborazione del modello non avviene necessariamente in locale. Le schermate campionate vengono inviate al percorso di visione configurato; le osservazioni e il testo della cronologia vengono inviati al modello predefinito dell'agente. Usa percorsi di modelli locali per entrambe le fasi se il contenuto dello schermo e il testo derivato dell'attività devono rimanere sul computer. Logbook è incluso e disabilitato per impostazione predefinita. L'abilitazione del Plugin consente al Gateway di acquisire lo schermo, poiché il valore predefinito di `captureEnabled` è `true`. ## Prima di iniziare Sono necessari: * Un Node connesso che esponga `screen.snapshot` o `logbook.snapshot`. Il Node dell'app macOS richiede l'autorizzazione Registrazione schermo. Un host Node macOS headless (`openclaw node host run`) riceve il comando `logbook.snapshot` fornito dal Plugin e basato sullo strumento di sistema `screencapture`. * Il Plugin Codex incluso, abilitato e autenticato. Attualmente Codex fornisce il contratto di estrazione strutturata delle immagini richiesto da Logbook. Accedi con `openclaw models auth login --provider openai`; consulta [Harness Codex](/it/plugins/codex-harness) per altri metodi di autenticazione. * Un modello predefinito dell'agente funzionante. Logbook lo usa per sintetizzare schede, note per il resoconto e domande e risposte sulla giornata dopo l'elaborazione visiva. ## Avvio rapido Abilita i Plugin Codex e Logbook: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw plugins enable codex openclaw plugins enable logbook ``` Configura un modello di visione esplicito per un avvio deterministico: ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { plugins: { entries: { codex: { enabled: true, }, logbook: { enabled: true, config: { visionModel: "codex/gpt-5.6-sol", }, }, }, }, } ``` Se usi `plugins.allow`, includi sia `codex` sia `logbook`. Riavvia il Gateway dopo aver modificato la configurazione dei Plugin, quindi esamina le registrazioni e apri il pannello di controllo: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw gateway restart openclaw plugins inspect logbook --runtime --json openclaw nodes status --connected openclaw nodes describe --node openclaw dashboard ``` La descrizione del Node deve includere `screen.snapshot` o `logbook.snapshot`. I Node headless pubblicizzano `logbook.snapshot` solo dopo l'attivazione del Plugin. Consulta [Risoluzione dei problemi dei Node](/it/nodes/troubleshooting) se il comando non è presente. La scheda Logbook viene visualizzata solo quando il Plugin è abilitato e la sessione della UI di controllo dispone di `operator.write`. La riga di stato dovrebbe mostrare **Acquisizione in corso** senza errori. Una scheda della cronologia viene visualizzata alla chiusura della finestra di analisi; in alternativa, puoi selezionare **Analizza ora** dopo l'acquisizione dell'attività. ## Funzionamento 1. **Acquisizione**: ogni `captureIntervalSeconds` (valore predefinito: 30 secondi), Logbook richiama il comando di acquisizione del Node selezionato e archivia un fotogramma JPEG ridimensionato. I fotogrammi consecutivi identici vengono contrassegnati come inattivi ed esclusi dall'analisi. 2. **Osservazione**: una volta trascorsa una finestra di analisi (valore predefinito: 15 minuti), il Plugin campiona fino a 16 fotogrammi attivi e li invia al modello di visione, che restituisce osservazioni sull'attività con indicazione temporale ("VS Code: modifica di store.ts, correzione di un errore di tipo"). Anche un'interruzione dell'acquisizione superiore a due minuti o la mezzanotte locale chiudono la finestra corrente. 3. **Sintesi**: le osservazioni e le schede esistenti degli ultimi 45 minuti vengono rielaborate in schede della cronologia (ciascuna di 10-60 minuti) con titolo, riepilogo, categoria, app principale ed eventuali brevi distrazioni. 4. **Eliminazione**: i fotogrammi più vecchi di `retentionDays` (valore predefinito: 14) vengono eliminati. Le schede, le osservazioni e i resoconti memorizzati nella cache vengono conservati. I confini delle giornate e gli orari della cronologia usano il fuso orario locale del Gateway, non quello del browser. I fotogrammi e il database SQLite della cronologia si trovano in `/logbook/`. ## Flusso dei modelli e dei dati Logbook usa due percorsi di modelli distinti: | Fase | Dati inviati | Percorso del modello | | ---------------------- | ------------------------------------------------------------------------ | -------------------------------------------------------------------------- | | Osservazione | Fino a 16 fotogrammi JPEG campionati e relativi orari di acquisizione | `visionModel` o una voce Codex `tools.media` compatibile presa in prestito | | Sintesi schede | Osservazioni con indicazione temporale e schede recenti della cronologia | Modello predefinito dell'agente tramite il runtime LLM del Plugin | | Generazione resoconto | Schede del giorno selezionato e del giorno precedente | Modello predefinito dell'agente tramite il runtime LLM del Plugin | | Domande sulla giornata | Domanda, schede del giorno selezionato e osservazioni recenti | Modello predefinito dell'agente tramite il runtime LLM del Plugin | Il database SQLite completo non viene inviato ad alcun modello. Le schermate grezze vengono inviate solo alla fase di osservazione; la sintesi delle schede, il resoconto e le domande e risposte ricevono testo derivato. ## Configurazione ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { plugins: { entries: { codex: { enabled: true, }, logbook: { enabled: true, config: { captureEnabled: true, captureIntervalSeconds: 30, analysisIntervalMinutes: 15, nodeId: "my-mac", screenIndex: 0, maxWidth: 1440, visionModel: "codex/gpt-5.6-sol", retentionDays: 14, }, }, }, }, } ``` Tutte le chiavi di configurazione di Logbook sono facoltative. I valori numerici vengono arrotondati a interi e limitati all'intervallo supportato. | Chiave | Valore predefinito | Intervallo o valori | Comportamento | | ------------------------- | ------------------ | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | `captureEnabled` | `true` | booleano | Interruttore principale persistente per le nuove istantanee; la cronologia rimane disponibile con `false` | | `captureIntervalSeconds` | `30` | `5`-`600` | Intervallo tra i tentativi di acquisizione | | `analysisIntervalMinutes` | `15` | `3`-`120` | Finestra di osservazione prevista; interruzioni e mezzanotte possono chiuderla prima | | `nodeId` | non impostato | ID o nome visualizzato del Node | Vincola l'acquisizione a un Node connesso; la corrispondenza non distingue maiuscole e minuscole | | `screenIndex` | `0` | `0`-`16` | Indice dello schermo con base zero | | `maxWidth` | `1440` | `480`-`3840` | Limite richiesto per le dimensioni dell'acquisizione; macOS headless lo applica alla dimensione maggiore | | `visionModel` | non impostato | `provider/model` | Percorso strutturato esplicito; i riferimenti non validi sospendono l'analisi, i provider non supportati causano il fallimento dei batch | | `retentionDays` | `14` | `1`-`365` | Elimina i fotogrammi meno recenti; schede, osservazioni e resoconti rimangono | Senza `nodeId`, Logbook preferisce un Node dell'app connesso che esponga `screen.snapshot`, quindi ripiega su un Node headless che esponga `logbook.snapshot`. In una configurazione non vincolata, un Node che non funziona viene spostato dietro gli altri Node idonei. L'interruttore di pausa del pannello di controllo si applica solo alla sessione e viene reimpostato quando il Gateway si riavvia; usa `captureEnabled: false` per un arresto persistente. ### Selezione del modello di visione Logbook risolve il modello di osservazione nel seguente ordine: 1. `plugins.entries.logbook.config.visionModel` 2. la prima voce Codex con supporto delle immagini in `tools.media.image.models` 3. la prima voce Codex con supporto delle immagini in `tools.media.models` Gli altri provider multimediali vengono ignorati perché attualmente non espongono il contratto di estrazione strutturata richiesto da Logbook. L'impostazione `tools.media.image.enabled: false` disabilita i valori predefiniti multimediali presi in prestito, ma un `visionModel` esplicito di Logbook continua a essere applicato. ## Scheda del pannello di controllo * **Cronologia**: schede espandibili per ciascuna attività con colori delle categorie, app principale, indicatori delle distrazioni e un fotogramma chiave dell'istantanea. * **Giornata in sintesi**: rapporto di concentrazione, ripartizione per categorie, app principali. * **Resoconto giornaliero**: trasforma ieri e oggi in un aggiornamento pronto da incollare. * **Domande sulla giornata**: domande in linguaggio naturale con risposte basate sulla cronologia monitorata ("quando ho esaminato la PR del Gateway?"). * **Analizza ora**: chiude immediatamente la finestra di acquisizione corrente anziché attendere l'intervallo di analisi. ## Metodi del Gateway Logbook registra i seguenti metodi RPC del Gateway: | Metodo | Parametri | Ambito | Risultato | | --------------------- | ------------------------ | ---------------- | ------------------------------------------------------------------------------------------------------------------ | | `logbook.status` | nessuno | `operator.read` | Stato dell'acquisizione, dell'analisi, del modello, del Node, del giorno del Gateway e del fuso orario del Gateway | | `logbook.days` | nessuno | `operator.read` | Giorni con conteggi delle schede della cronologia e relativi limiti temporali | | `logbook.timeline` | `{ day?: "YYYY-MM-DD" }` | `operator.read` | Schede derivate e statistiche giornaliere; per impostazione predefinita usa il giorno corrente del Gateway | | `logbook.frames` | `{ startMs, endMs }` | `operator.write` | Metadati dei fotogrammi nell'intervallo richiesto espresso in millisecondi dall'epoca | | `logbook.frame` | `{ frameId }` | `operator.write` | Un fotogramma JPEG grezzo in base64 | | `logbook.standup` | `{ day?, refresh? }` | `operator.write` | Testo del resoconto memorizzato nella cache o rigenerato per un giorno | | `logbook.ask` | `{ day?, question }` | `operator.write` | Risposta basata sulla cronologia di un giorno | | `logbook.capture.set` | `{ paused }` | `operator.write` | Stato di pausa applicato solo alla sessione e stato aggiornato | | `logbook.analyze.now` | nessuno | `operator.write` | Avvia l'analisi in sospeso o restituisce il motivo per cui non è stato possibile avviarla | I metodi di lettura restituiscono lo stato operativo o il testo derivato. I pixel grezzi delle schermate, le azioni che comportano consumo del modello e le modifiche del runtime richiedono `operator.write`. Anche la scheda della UI di controllo richiede `operator.write` perché espone tali azioni e le anteprime dei fotogrammi grezzi; un client di sola lettura può comunque chiamare direttamente i metodi del testo derivato. ## Note sulla privacy * Le istantanee possono contenere qualsiasi elemento visualizzato sullo schermo, inclusi dati segreti. I fotogrammi non lasciano mai il computer, salvo quando vengono usati come input campionato per il modello di osservazione configurato. * Le osservazioni, le schede recenti e le domande possono lasciare il computer tramite il modello predefinito dell'agente durante la sintesi delle schede, la generazione del resoconto o le domande e risposte. Applica i criteri di gestione dei dati del provider a entrambi i percorsi dei modelli. * Usa percorsi locali sia per il modello di osservazione strutturata sia per il modello predefinito dell'agente quando è necessaria una pipeline completamente locale. * I fotogrammi, il database della cronologia e le acquisizioni temporanee vengono scritti con autorizzazioni dei file riservate al proprietario. * L'aggiunta di `screen.snapshot` a `gateway.nodes.denyCommands` funge da interruttore generale per l'acquisizione dello schermo: blocca sia l'acquisizione del Node dell'app sia il comando `logbook.snapshot` di Logbook. * L'impostazione `tools.media.image.enabled: false` impedisce inoltre a Logbook di prendere in prestito i modelli multimediali per immagini per l'analisi; in tal caso viene usato soltanto un `visionModel` esplicito nella configurazione del Plugin. ## Risoluzione dei problemi ### La scheda Logbook non è presente Controlla tutti e tre i requisiti: 1. `openclaw plugins list --enabled` include `logbook`. 2. Il Gateway è stato riavviato dopo la modifica del Plugin o dell'elenco consentito. 3. La connessione della UI di controllo dispone di `operator.write`; le sessioni di sola lettura non ricevono il descrittore della scheda interattiva. Se `plugins.allow` è impostato, deve includere sia `logbook` sia `codex` per la configurazione consigliata. ### L'acquisizione segnala un errore ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw nodes status --connected openclaw nodes describe --node openclaw logs --follow ``` * Verifica che il nodo esponga `screen.snapshot` o `logbook.snapshot`. * Concedi l'autorizzazione Registrazione schermo sul Mac di acquisizione. * Se `nodeId` è configurato, verifica che corrisponda all'ID del nodo o al nome visualizzato. * Verifica che `gateway.nodes.denyCommands` non contenga `screen.snapshot`. Dopo tre errori consecutivi, Logbook applica un'attesa per dieci cicli di acquisizione e quindi riprova. Una configurazione non vincolata può passare a un altro nodo idoneo. ### Le acquisizioni riescono, ma non compaiono schede * Lo stato **Modello mancante** indica che non è stato trovato alcun percorso di visione strutturata compatibile. Abilita e autentica il Plugin Codex oppure imposta un `visionModel` esplicito valido. I fotogrammi acquisiti restano in sospeso finché manca il modello e possono essere analizzati dopo aver corretto la configurazione. * Attendi per `analysisIntervalMinutes` oppure seleziona **Analizza ora** dopo che è stata acquisita dell'attività. * I fotogrammi consecutivi identici costituiscono una prova di inattività e non entrano nei batch di analisi. Modifica la schermata visibile prima di eseguire il test. * Se il batch più recente mostra un errore, correggi il problema del modello o di autenticazione e seleziona **Analizza ora**. I batch non riusciti vengono riprovati solo tramite questa azione esplicita, per evitare costi ripetuti del modello. ## Contenuti correlati * [Gestire i plugin](/it/plugins/manage-plugins) * [Harness Codex](/it/plugins/codex-harness) * [Comprensione dei contenuti multimediali](/it/nodes/media-understanding) * [Nodi](/it/nodes) * [Risoluzione dei problemi dei nodi](/it/nodes/troubleshooting) * [Interfaccia di controllo](/it/web/control-ui)