Impegni dedotti

Gli impegni sono memorie di follow-up di breve durata. Quando sono abilitati, OpenClaw può rilevare che una conversazione ha creato un'opportunità per una verifica futura e ricordarsi di riprenderla in seguito.

Esempi:

• Menzioni un colloquio per domani. OpenClaw potrebbe chiederti in seguito com'è andato.
• Dici di essere esausto. OpenClaw potrebbe chiederti più tardi se hai dormito.
• L'agente dice che farà un follow-up dopo un cambiamento. OpenClaw potrebbe tenere traccia di questo punto in sospeso.

Gli impegni non sono fatti persistenti come MEMORY.md e non sono promemoria esatti. Si collocano tra la memoria e l'automazione: OpenClaw ricorda un obbligo legato alla conversazione, poi Heartbeat lo recapita quando è il momento.

Abilitare gli impegni

Gli impegni sono disabilitati per impostazione predefinita (commitments.enabled: false). Abilitali nella configurazione:

openclaw config set commitments.enabled trueopenclaw config set commitments.maxPerDay 3

Configurazione openclaw.json equivalente:

{  "commitments": {    "enabled": true,    "maxPerDay": 3  }}

commitments.maxPerDay limita il numero di follow-up dedotti che possono essere recapitati per sessione dell'agente nell'arco di una giornata mobile. Il valore predefinito è 3.

Come funziona

Dopo una risposta dell'agente, OpenClaw può eseguire in background un passaggio di estrazione nascosto in un contesto separato, con gli strumenti disabilitati. Questo passaggio cerca esclusivamente gli impegni di follow-up dedotti. Non scrive nella conversazione visibile e non chiede all'agente principale di ragionare sull'estrazione.

Quando trova un candidato con un elevato livello di attendibilità, OpenClaw memorizza un impegno con:

• l'ID dell'agente
• la chiave della sessione
• il canale originale e la destinazione di recapito
• una finestra temporale prevista
• un breve suggerimento per la verifica
• metadati non prescrittivi che consentono a Heartbeat di decidere se inviarlo

Il recapito avviene tramite Heartbeat. Quando un impegno giunge a scadenza, Heartbeat lo aggiunge al turno di Heartbeat per lo stesso agente e lo stesso ambito del canale. Il prompt avverte esplicitamente che i metadati dell'impegno non sono attendibili e indica al modello di non seguire le istruzioni contenute al loro interno né di usare strumenti a causa di tali istruzioni. Il modello può inviare un unico messaggio naturale di verifica oppure rispondere HEARTBEAT_OK per ignorarlo. Se Heartbeat è configurato con target: "none", gli impegni giunti a scadenza rimangono interni e non inviano messaggi di verifica esterni. I prompt di recapito degli impegni non riproducono il testo della conversazione originale, ma solo il messaggio di verifica suggerito e i metadati; inoltre, i turni di Heartbeat relativi agli impegni giunti a scadenza vengono eseguiti senza gli strumenti di OpenClaw.

OpenClaw non recapita mai un impegno dedotto immediatamente dopo averlo scritto. La scadenza viene impostata ad almeno un intervallo di Heartbeat successivo alla creazione dell'impegno, in modo che il follow-up non venga riproposto nello stesso momento in cui è stato dedotto.

Ambito

Gli impegni sono limitati all'esatto contesto dell'agente e del canale in cui sono stati creati. Un follow-up dedotto durante una conversazione con un agente in Discord non viene recapitato da un altro agente, da un altro canale o da una sessione non correlata.

Questo ambito è parte integrante della funzionalità. I messaggi naturali di verifica devono sembrare la prosecuzione della stessa conversazione, non un sistema globale di promemoria.

Impegni e promemoria

Le richieste esplicite dell'utente appartengono già al percorso dello scheduler. Gli impegni servono esclusivamente per i follow-up dedotti: quei momenti in cui l'utente non ha chiesto un promemoria, ma la conversazione ha chiaramente creato un'utile opportunità di verifica futura.

Gestire gli impegni

Usa la CLI per esaminare e cancellare gli impegni memorizzati:

openclaw commitmentsopenclaw commitments --allopenclaw commitments --agent mainopenclaw commitments --status snoozedopenclaw commitments dismiss cm_abc123

Consulta openclaw commitments per il riferimento completo dei comandi.

Privacy e costi

L'estrazione degli impegni utilizza un passaggio LLM, quindi la sua abilitazione aggiunge l'uso del modello in background dopo i turni idonei. Il passaggio è nascosto nella conversazione visibile all'utente, ma può leggere lo scambio recente necessario per stabilire se esiste un follow-up.

Gli impegni memorizzati fanno parte dello stato locale di OpenClaw. Sono memoria operativa, non memoria a lungo termine. Disabilita la funzionalità con:

openclaw config set commitments.enabled false

Risoluzione dei problemi

Se i follow-up previsti non vengono visualizzati:

• Verifica che commitments.enabled sia true.
• Controlla con openclaw commitments --all la presenza di record in sospeso, ignorati, posticipati o scaduti.
• Assicurati che Heartbeat sia in esecuzione per l'agente.
• Controlla se commitments.maxPerDay è già stato raggiunto per quella sessione dell'agente.
• Ricorda che i promemoria espliciti vengono ignorati dall'estrazione degli impegni e dovrebbero essere visualizzati invece nelle attività pianificate.

Contenuti correlati

• Panoramica della memoria
• Active Memory
• Heartbeat
• Attività pianificate
• openclaw commitments
• Riferimento della configurazione