diff --git a/docs/it/concepts/active-memory.md b/docs/it/concepts/active-memory.md index 9a15fa9da..36bce94e3 100644 --- a/docs/it/concepts/active-memory.md +++ b/docs/it/concepts/active-memory.md @@ -3,28 +3,28 @@ read_when: - Vuoi capire a cosa serve la memoria attiva - Vuoi attivare la memoria attiva per un agente conversazionale - Vuoi regolare il comportamento della memoria attiva senza abilitarla ovunque -summary: Un sotto-agente di memoria bloccante di proprietà del plugin che inserisce la memoria pertinente nelle sessioni di chat interattive +summary: Un sotto-agente di memoria bloccante gestito dal plugin che inserisce la memoria pertinente nelle sessioni di chat interattive title: Memoria attiva x-i18n: - generated_at: "2026-04-10T08:13:33Z" + generated_at: "2026-04-11T08:00:33Z" model: gpt-5.4 provider: openai - source_hash: 6a51437df4ae4d9d57764601dfcfcdadb269e2895bf49dc82b9f496c1b3cb341 + source_hash: e8b0e6539e09678e9e8def68795f8bcb992f98509423da3da3123eda88ec1dd5 source_path: concepts/active-memory.md workflow: 15 --- # Memoria attiva -La memoria attiva è un sotto-agente di memoria bloccante opzionale di proprietà del plugin che viene eseguito +La memoria attiva è un sotto-agente di memoria bloccante opzionale gestito dal plugin che viene eseguito prima della risposta principale per le sessioni conversazionali idonee. -Esiste perché la maggior parte dei sistemi di memoria è capace ma reattiva. Si affida -all'agente principale per decidere quando cercare nella memoria, oppure all'utente per dire cose -come "ricorda questo" o "cerca nella memoria". A quel punto, il momento in cui la memoria avrebbe -reso la risposta naturale è già passato. +Esiste perché la maggior parte dei sistemi di memoria è capace ma reattiva. Si basa +sull'agente principale per decidere quando cercare nella memoria, oppure sull'utente che dica cose +come "ricorda questo" o "cerca nella memoria". A quel punto, il momento in cui la memoria +avrebbe reso la risposta naturale è già passato. -La memoria attiva offre al sistema una possibilità limitata di far emergere memoria pertinente +La memoria attiva offre al sistema una possibilità limitata di far emergere la memoria pertinente prima che venga generata la risposta principale. ## Incolla questo nel tuo agente @@ -57,22 +57,22 @@ configurazione autonoma e sicura per impostazione predefinita: ``` Questo attiva il plugin per l'agente `main`, lo mantiene limitato per impostazione predefinita alle -sessioni in stile messaggio diretto, gli consente di ereditare prima il modello della sessione corrente e +sessioni in stile messaggio diretto, gli permette prima di ereditare il modello della sessione corrente e consente comunque il fallback remoto integrato se non è disponibile alcun modello esplicito o ereditato. Dopo, riavvia il gateway: ```bash -node scripts/run-node.mjs gateway --profile dev +openclaw gateway ``` -Per ispezionarlo in tempo reale in una conversazione: +Per ispezionarlo dal vivo in una conversazione: ```text /verbose on ``` -## Attiva la memoria attiva +## Attivare la memoria attiva La configurazione più sicura è: @@ -108,25 +108,25 @@ Inizia con questo in `openclaw.json`: Poi riavvia il gateway: ```bash -node scripts/run-node.mjs gateway --profile dev +openclaw gateway ``` -Cosa significa: +Ecco cosa significa: - `plugins.entries.active-memory.enabled: true` attiva il plugin - `config.agents: ["main"]` abilita la memoria attiva solo per l'agente `main` -- `config.allowedChatTypes: ["direct"]` mantiene la memoria attiva abilitata solo per impostazione predefinita per le sessioni in stile messaggio diretto +- `config.allowedChatTypes: ["direct"]` mantiene la memoria attiva solo per impostazione predefinita per le sessioni in stile messaggio diretto - se `config.model` non è impostato, la memoria attiva eredita prima il modello della sessione corrente -- `config.modelFallbackPolicy: "default-remote"` mantiene come impostazione predefinita il fallback remoto integrato quando non è disponibile alcun modello esplicito o ereditato +- `config.modelFallbackPolicy: "default-remote"` mantiene il fallback remoto integrato come impostazione predefinita quando non è disponibile alcun modello esplicito o ereditato - `config.promptStyle: "balanced"` usa lo stile di prompt predefinito per uso generale per la modalità `recent` -- la memoria attiva viene comunque eseguita solo su sessioni di chat persistenti interattive idonee +- la memoria attiva continua a essere eseguita solo sulle sessioni di chat interattive persistenti idonee -## Come vederla +## Come visualizzarla La memoria attiva inserisce contesto di sistema nascosto per il modello. Non espone -tag raw `...` al client. +tag grezzi `...` al client. -## Interruttore della sessione +## Attivazione/disattivazione per sessione Usa il comando del plugin quando vuoi mettere in pausa o riprendere la memoria attiva per la sessione di chat corrente senza modificare la configurazione: @@ -137,8 +137,8 @@ sessione di chat corrente senza modificare la configurazione: /active-memory on ``` -Questo è limitato alla sessione. Non modifica -`plugins.entries.active-memory.enabled`, il targeting dell'agente o altre +Questo vale per la sessione corrente. Non modifica +`plugins.entries.active-memory.enabled`, la selezione dell'agente o altre configurazioni globali. Se vuoi che il comando scriva la configurazione e metta in pausa o riprenda la memoria attiva per @@ -154,7 +154,7 @@ La forma globale scrive `plugins.entries.active-memory.config.enabled`. Lascia `plugins.entries.active-memory.enabled` attivo in modo che il comando resti disponibile per riattivare la memoria attiva in seguito. -Se vuoi vedere cosa sta facendo la memoria attiva in una sessione in tempo reale, attiva la modalità +Se vuoi vedere cosa sta facendo la memoria attiva in una sessione dal vivo, attiva la modalità verbose per quella sessione: ```text @@ -166,23 +166,23 @@ Con verbose abilitato, OpenClaw può mostrare: - una riga di stato della memoria attiva come `Active Memory: ok 842ms recent 34 chars` - un riepilogo di debug leggibile come `Active Memory Debug: Lemon pepper wings with blue cheese.` -Queste righe derivano dallo stesso passaggio della memoria attiva che alimenta il contesto di -sistema nascosto, ma sono formattate per le persone invece di esporre markup raw del prompt. +Queste righe derivano dallo stesso passaggio di memoria attiva che alimenta il contesto di +sistema nascosto, ma sono formattate per gli esseri umani invece di esporre markup grezzo del prompt. Per impostazione predefinita, la trascrizione del sotto-agente di memoria bloccante è temporanea e viene eliminata dopo il completamento dell'esecuzione. -Flusso di esempio: +Esempio di flusso: ```text /verbose on -quali ali dovrei ordinare? +what wings should i order? ``` -Forma prevista della risposta visibile: +Forma attesa della risposta visibile: ```text -...normale risposta dell'assistente... +...normal assistant reply... 🧩 Active Memory: ok 842ms recent 34 chars 🔎 Active Memory Debug: Lemon pepper wings with blue cheese. @@ -190,44 +190,43 @@ Forma prevista della risposta visibile: ## Quando viene eseguita -La memoria attiva usa due criteri: +La memoria attiva usa due controlli: -1. **Adesione esplicita nella configurazione** +1. **Consenso esplicito tramite configurazione** Il plugin deve essere abilitato e l'id dell'agente corrente deve comparire in `plugins.entries.active-memory.config.agents`. 2. **Idoneità rigorosa in fase di esecuzione** - Anche quando è abilitata e selezionata, la memoria attiva viene eseguita solo per - sessioni di chat persistenti interattive idonee. + Anche se abilitata e selezionata, la memoria attiva viene eseguita solo per le + sessioni di chat interattive persistenti idonee. La regola effettiva è: ```text -plugin abilitato +plugin enabled + -id agente selezionato +agent id targeted + -tipo di chat consentito +allowed chat type + -sessione di chat persistente interattiva idonea +eligible interactive persistent chat session = -la memoria attiva viene eseguita +active memory runs ``` -Se uno qualsiasi di questi fallisce, la memoria attiva non viene eseguita. +Se uno qualsiasi di questi controlli fallisce, la memoria attiva non viene eseguita. ## Tipi di sessione -`config.allowedChatTypes` controlla quali tipi di conversazioni possono eseguire la Memoria -attiva. +`config.allowedChatTypes` controlla quali tipi di conversazioni possono eseguire la memoria attiva. -Il valore predefinito è: +L'impostazione predefinita è: ```json5 allowedChatTypes: ["direct"] ``` -Questo significa che la Memoria attiva viene eseguita per impostazione predefinita nelle sessioni in stile messaggio diretto, ma -non nelle sessioni di gruppo o di canale a meno che tu non le abiliti esplicitamente. +Questo significa che la memoria attiva viene eseguita per impostazione predefinita nelle sessioni in stile +messaggio diretto, ma non nelle sessioni di gruppo o canale a meno che tu non le abiliti esplicitamente. Esempi: @@ -246,16 +245,16 @@ allowedChatTypes: ["direct", "group", "channel"] ## Dove viene eseguita La memoria attiva è una funzionalità di arricchimento conversazionale, non una -funzionalità di inferenza valida per tutta la piattaforma. +funzionalità di inferenza estesa a tutta la piattaforma. -| Superficie | Esegue la memoria attiva? | -| ------------------------------------------------------------------- | ------------------------------------------------------- | -| Sessioni persistenti di chat in Control UI / web chat | Sì, se il plugin è abilitato e l'agente è selezionato | -| Altre sessioni di canale interattive sullo stesso percorso di chat persistente | Sì, se il plugin è abilitato e l'agente è selezionato | -| Esecuzioni headless one-shot | No | -| Esecuzioni heartbeat/background | No | -| Percorsi interni generici `agent-command` | No | -| Esecuzione di sotto-agenti/helper interni | No | +| Surface | La memoria attiva viene eseguita? | +| ------------------------------------------------------------------- | ------------------------------------------------------ | +| Sessioni persistenti del Control UI / chat web | Sì, se il plugin è abilitato e l'agente è selezionato | +| Altre sessioni di canale interattive sullo stesso percorso di chat persistente | Sì, se il plugin è abilitato e l'agente è selezionato | +| Esecuzioni headless una tantum | No | +| Esecuzioni heartbeat/background | No | +| Percorsi interni generici `agent-command` | No | +| Esecuzione di sotto-agenti/helper interni | No | ## Perché usarla @@ -275,20 +274,20 @@ Funziona particolarmente bene per: - automazione - worker interni -- attività API one-shot +- attività API una tantum - contesti in cui una personalizzazione nascosta sarebbe sorprendente ## Come funziona -La forma di esecuzione è: +La struttura in fase di esecuzione è: ```mermaid flowchart LR - U["Messaggio utente"] --> Q["Crea query di memoria"] - Q --> R["Sotto-agente di memoria bloccante della memoria attiva"] - R -->|NONE or empty| M["Risposta principale"] - R -->|relevant summary| I["Aggiungi contesto di sistema nascosto active_memory_plugin"] - I --> M["Risposta principale"] + U["User Message"] --> Q["Build Memory Query"] + Q --> R["Active Memory Blocking Memory Sub-Agent"] + R -->|NONE or empty| M["Main Reply"] + R -->|relevant summary| I["Append Hidden active_memory_plugin System Context"] + I --> M["Main Reply"] ``` Il sotto-agente di memoria bloccante può usare solo: @@ -309,10 +308,10 @@ propenso o rigoroso quando decide se restituire memoria. Stili disponibili: -- `balanced`: valore predefinito per uso generale per la modalità `recent` -- `strict`: il meno propenso; ideale quando vuoi pochissima influenza dal contesto vicino +- `balanced`: impostazione predefinita per uso generale per la modalità `recent` +- `strict`: il meno propenso; ideale quando vuoi pochissima contaminazione dal contesto vicino - `contextual`: il più favorevole alla continuità; ideale quando la cronologia della conversazione dovrebbe contare di più -- `recall-heavy`: più disposto a far emergere memoria anche con corrispondenze meno forti ma comunque plausibili +- `recall-heavy`: più disposto a far emergere memoria su corrispondenze meno forti ma comunque plausibili - `precision-heavy`: preferisce in modo aggressivo `NONE` a meno che la corrispondenza non sia ovvia - `preference-only`: ottimizzato per preferiti, abitudini, routine, gusti e fatti personali ricorrenti @@ -324,7 +323,7 @@ recent -> balanced full -> contextual ``` -Se imposti `config.promptStyle` esplicitamente, quell'override prevale. +Se imposti esplicitamente `config.promptStyle`, questa sostituzione ha la precedenza. Esempio: @@ -334,18 +333,18 @@ promptStyle: "preference-only" ## Criterio di fallback del modello -Se `config.model` non è impostato, la Memoria attiva prova a risolvere un modello in questo ordine: +Se `config.model` non è impostato, la memoria attiva prova a risolvere un modello in questo ordine: ```text -modello esplicito del plugin --> modello della sessione corrente --> modello primario dell'agente --> fallback remoto integrato opzionale +explicit plugin model +-> current session model +-> agent primary model +-> optional built-in remote fallback ``` `config.modelFallbackPolicy` controlla l'ultimo passaggio. -Valore predefinito: +Impostazione predefinita: ```json5 modelFallbackPolicy: "default-remote" @@ -357,8 +356,8 @@ Altra opzione: modelFallbackPolicy: "resolved-only" ``` -Usa `resolved-only` se vuoi che la Memoria attiva salti il recupero invece di usare -il valore predefinito remoto integrato quando non è disponibile alcun modello esplicito o +Usa `resolved-only` se vuoi che la memoria attiva salti il richiamo invece di fare +fallback al valore remoto integrato predefinito quando non è disponibile alcun modello esplicito o ereditato. ## Meccanismi di uscita avanzati @@ -371,69 +370,69 @@ Queste opzioni intenzionalmente non fanno parte della configurazione consigliata thinking: "medium" ``` -Valore predefinito: +Impostazione predefinita: ```json5 thinking: "off" ``` -Non abilitarlo per impostazione predefinita. La Memoria attiva viene eseguita nel percorso della risposta, quindi tempo di +Non abilitarlo per impostazione predefinita. La memoria attiva viene eseguita nel percorso della risposta, quindi il tempo di thinking aggiuntivo aumenta direttamente la latenza visibile all'utente. -`config.promptAppend` aggiunge istruzioni supplementari per l'operatore dopo il prompt predefinito della Memoria -attiva e prima del contesto della conversazione: +`config.promptAppend` aggiunge istruzioni extra dell'operatore dopo il prompt predefinito della memoria attiva +e prima del contesto della conversazione: ```json5 -promptAppend: "Dai priorità alle preferenze stabili a lungo termine rispetto agli eventi una tantum." +promptAppend: "Prefer stable long-term preferences over one-off events." ``` -`config.promptOverride` sostituisce il prompt predefinito della Memoria attiva. OpenClaw -continua comunque ad aggiungere dopo il contesto della conversazione: +`config.promptOverride` sostituisce il prompt predefinito della memoria attiva. OpenClaw +continua comunque ad aggiungere il contesto della conversazione subito dopo: ```json5 -promptOverride: "Sei un agente di ricerca della memoria. Restituisci NONE o un fatto utente compatto." +promptOverride: "You are a memory search agent. Return NONE or one compact user fact." ``` -La personalizzazione del prompt non è consigliata a meno che tu non stia testando deliberatamente un -contratto di recupero diverso. Il prompt predefinito è regolato per restituire `NONE` -oppure un contesto compatto di fatti utente per il modello principale. +La personalizzazione del prompt non è consigliata a meno che tu non stia deliberatamente testando un +contratto di richiamo diverso. Il prompt predefinito è ottimizzato per restituire `NONE` +oppure un contesto compatto basato su fatti dell'utente per il modello principale. ### `message` Viene inviato solo l'ultimo messaggio dell'utente. ```text -Solo l'ultimo messaggio dell'utente +Only the latest user message ``` -Usalo quando: +Usa questa modalità quando: -- vuoi il comportamento più veloce -- vuoi il bias più forte verso il recupero di preferenze stabili -- i turni successivi non hanno bisogno del contesto conversazionale +- vuoi il comportamento più rapido +- vuoi il bias più forte verso il richiamo di preferenze stabili +- i turni successivi non richiedono contesto conversazionale Timeout consigliato: -- inizia intorno a `3000` a `5000` ms +- inizia intorno a `3000` - `5000` ms ### `recent` Vengono inviati l'ultimo messaggio dell'utente più una piccola coda conversazionale recente. ```text -Coda recente della conversazione: +Recent conversation tail: user: ... assistant: ... user: ... -Ultimo messaggio dell'utente: +Latest user message: ... ``` -Usalo quando: +Usa questa modalità quando: - vuoi un miglior equilibrio tra velocità e ancoraggio conversazionale -- le domande di follow-up spesso dipendono dagli ultimi pochi turni +- le domande di follow-up dipendono spesso dagli ultimi turni Timeout consigliato: @@ -444,21 +443,21 @@ Timeout consigliato: L'intera conversazione viene inviata al sotto-agente di memoria bloccante. ```text -Contesto completo della conversazione: +Full conversation context: user: ... assistant: ... user: ... ... ``` -Usalo quando: +Usa questa modalità quando: -- la massima qualità del recupero conta più della latenza +- la migliore qualità di richiamo conta più della latenza - la conversazione contiene impostazioni importanti molto indietro nel thread Timeout consigliato: -- aumentalo in modo significativo rispetto a `message` o `recent` +- aumentalo in modo sostanziale rispetto a `message` o `recent` - inizia intorno a `15000` ms o più, a seconda della dimensione del thread In generale, il timeout dovrebbe aumentare con la dimensione del contesto: @@ -467,17 +466,18 @@ In generale, il timeout dovrebbe aumentare con la dimensione del contesto: message < recent < full ``` -## Persistenza della trascrizione +## Persistenza delle trascrizioni -Le esecuzioni del sotto-agente di memoria bloccante della memoria attiva creano una vera trascrizione `session.jsonl` durante la chiamata del sotto-agente di memoria bloccante. +Le esecuzioni del sotto-agente di memoria bloccante della memoria attiva creano una vera trascrizione `session.jsonl` +durante la chiamata al sotto-agente di memoria bloccante. Per impostazione predefinita, quella trascrizione è temporanea: - viene scritta in una directory temporanea - viene usata solo per l'esecuzione del sotto-agente di memoria bloccante -- viene eliminata immediatamente dopo la fine dell'esecuzione +- viene eliminata immediatamente al termine dell'esecuzione -Se vuoi conservare su disco quelle trascrizioni del sotto-agente di memoria bloccante per debug o +Se vuoi mantenere su disco quelle trascrizioni del sotto-agente di memoria bloccante per debug o ispezione, attiva esplicitamente la persistenza: ```json5 @@ -498,22 +498,22 @@ ispezione, attiva esplicitamente la persistenza: ``` Quando è abilitata, la memoria attiva archivia le trascrizioni in una directory separata sotto la -cartella delle sessioni dell'agente di destinazione, non nel percorso principale della trascrizione -della conversazione utente. +cartella delle sessioni dell'agente di destinazione, non nel percorso della trascrizione principale +della conversazione dell'utente. -Il layout predefinito è, concettualmente: +La struttura predefinita è concettualmente: ```text agents//sessions/active-memory/.jsonl ``` -Puoi modificare la sottodirectory relativa con `config.transcriptDir`. +Puoi cambiare la sottodirectory relativa con `config.transcriptDir`. -Usalo con attenzione: +Usa questa opzione con cautela: - le trascrizioni del sotto-agente di memoria bloccante possono accumularsi rapidamente nelle sessioni molto attive - la modalità di query `full` può duplicare molto contesto conversazionale -- queste trascrizioni contengono contesto nascosto del prompt e memorie recuperate +- queste trascrizioni contengono contesto di prompt nascosto e memorie richiamate ## Configurazione @@ -525,32 +525,32 @@ plugins.entries.active-memory I campi più importanti sono: -| Chiave | Tipo | Significato | -| --------------------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | -| `enabled` | `boolean` | Abilita il plugin stesso | -| `config.agents` | `string[]` | ID agente che possono usare la memoria attiva | -| `config.model` | `string` | Riferimento facoltativo al modello del sotto-agente di memoria bloccante; se non è impostato, la memoria attiva usa il modello della sessione corrente | -| `config.queryMode` | `"message" \| "recent" \| "full"` | Controlla quanta parte della conversazione vede il sotto-agente di memoria bloccante | -| `config.promptStyle` | `"balanced" \| "strict" \| "contextual" \| "recall-heavy" \| "precision-heavy" \| "preference-only"` | Controlla quanto il sotto-agente di memoria bloccante sia propenso o rigoroso nel decidere se restituire memoria | -| `config.thinking` | `"off" \| "minimal" \| "low" \| "medium" \| "high" \| "xhigh" \| "adaptive"` | Override avanzato del thinking per il sotto-agente di memoria bloccante; valore predefinito `off` per velocità | -| `config.promptOverride` | `string` | Sostituzione avanzata completa del prompt; non consigliata per l'uso normale | -| `config.promptAppend` | `string` | Istruzioni supplementari avanzate aggiunte al prompt predefinito o sostituito | -| `config.timeoutMs` | `number` | Timeout rigido per il sotto-agente di memoria bloccante | -| `config.maxSummaryChars` | `number` | Numero massimo totale di caratteri consentiti nel riepilogo di active-memory | -| `config.logging` | `boolean` | Emette log della memoria attiva durante la regolazione | +| Chiave | Tipo | Significato | +| --------------------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | +| `enabled` | `boolean` | Abilita il plugin stesso | +| `config.agents` | `string[]` | ID agente che possono usare la memoria attiva | +| `config.model` | `string` | Riferimento facoltativo al modello del sotto-agente di memoria bloccante; se non impostato, la memoria attiva usa il modello della sessione corrente | +| `config.queryMode` | `"message" \| "recent" \| "full"` | Controlla quanta parte della conversazione vede il sotto-agente di memoria bloccante | +| `config.promptStyle` | `"balanced" \| "strict" \| "contextual" \| "recall-heavy" \| "precision-heavy" \| "preference-only"` | Controlla quanto il sotto-agente di memoria bloccante sia propenso o rigoroso quando decide se restituire memoria | +| `config.thinking` | `"off" \| "minimal" \| "low" \| "medium" \| "high" \| "xhigh" \| "adaptive"` | Sostituzione avanzata del livello di thinking per il sotto-agente di memoria bloccante; impostazione predefinita `off` per maggiore velocità | +| `config.promptOverride` | `string` | Sostituzione avanzata completa del prompt; non consigliata per l'uso normale | +| `config.promptAppend` | `string` | Istruzioni avanzate aggiuntive accodate al prompt predefinito o sostituito | +| `config.timeoutMs` | `number` | Timeout rigido per il sotto-agente di memoria bloccante | +| `config.maxSummaryChars` | `number` | Numero massimo totale di caratteri consentiti nel riepilogo della memoria attiva | +| `config.logging` | `boolean` | Emette log della memoria attiva durante la regolazione | | `config.persistTranscripts` | `boolean` | Mantiene su disco le trascrizioni del sotto-agente di memoria bloccante invece di eliminare i file temporanei | | `config.transcriptDir` | `string` | Directory relativa delle trascrizioni del sotto-agente di memoria bloccante sotto la cartella delle sessioni dell'agente | Campi utili per la regolazione: -| Chiave | Tipo | Significato | -| ----------------------------- | -------- | ----------------------------------------------------------------- | -| `config.maxSummaryChars` | `number` | Numero massimo totale di caratteri consentiti nel riepilogo di active-memory | -| `config.recentUserTurns` | `number` | Turni utente precedenti da includere quando `queryMode` è `recent` | +| Chiave | Tipo | Significato | +| ----------------------------- | -------- | --------------------------------------------------------------- | +| `config.maxSummaryChars` | `number` | Numero massimo totale di caratteri consentiti nel riepilogo della memoria attiva | +| `config.recentUserTurns` | `number` | Turni utente precedenti da includere quando `queryMode` è `recent` | | `config.recentAssistantTurns` | `number` | Turni assistente precedenti da includere quando `queryMode` è `recent` | -| `config.recentUserChars` | `number` | Numero massimo di caratteri per turno utente recente | -| `config.recentAssistantChars` | `number` | Numero massimo di caratteri per turno assistente recente | -| `config.cacheTtlMs` | `number` | Riutilizzo della cache per query identiche ripetute | +| `config.recentUserChars` | `number` | Numero massimo di caratteri per ogni turno utente recente | +| `config.recentAssistantChars` | `number` | Numero massimo di caratteri per ogni turno assistente recente | +| `config.cacheTtlMs` | `number` | Riutilizzo della cache per query identiche ripetute | ## Configurazione consigliata @@ -576,8 +576,8 @@ Inizia con `recent`. } ``` -Se vuoi ispezionare il comportamento in tempo reale durante la regolazione, usa `/verbose on` nella -sessione invece di cercare un comando di debug separato per active-memory. +Se vuoi ispezionare il comportamento dal vivo durante la regolazione, usa `/verbose on` nella +sessione invece di cercare un comando di debug separato per la memoria attiva. Poi passa a: @@ -586,15 +586,15 @@ Poi passa a: ## Debug -Se la memoria attiva non compare dove ti aspetti: +Se la memoria attiva non compare dove te l'aspetti: 1. Conferma che il plugin sia abilitato in `plugins.entries.active-memory.enabled`. 2. Conferma che l'ID dell'agente corrente sia elencato in `config.agents`. -3. Conferma che il test avvenga tramite una sessione di chat persistente interattiva. +3. Conferma di stare testando tramite una sessione di chat interattiva persistente. 4. Attiva `config.logging: true` e osserva i log del gateway. -5. Verifica che la ricerca in memoria funzioni con `openclaw memory status --deep`. +5. Verifica che la ricerca nella memoria stessa funzioni con `openclaw memory status --deep`. -Se i risultati di memoria sono troppo rumorosi, restringi: +Se i risultati della memoria sono rumorosi, restringi: - `maxSummaryChars`