chore(i18n): refresh es translations
This commit is contained in:
parent
4e01c20514
commit
7c5ea384b6
@ -3,28 +3,28 @@ read_when:
|
||||
- Quieres entender para qué sirve la memoria activa
|
||||
- Quieres activar la memoria activa para un agente conversacional
|
||||
- Quieres ajustar el comportamiento de la memoria activa sin habilitarla en todas partes
|
||||
summary: Un subagente de memoria bloqueante propiedad del plugin que inyecta memoria relevante en sesiones de chat interactivas
|
||||
summary: Un subagente de memoria propiedad del plugin que inyecta memoria relevante en sesiones de chat interactivas
|
||||
title: Memoria activa
|
||||
x-i18n:
|
||||
generated_at: "2026-04-10T05:12:18Z"
|
||||
generated_at: "2026-04-11T04:55:45Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 6a51437df4ae4d9d57764601dfcfcdadb269e2895bf49dc82b9f496c1b3cb341
|
||||
source_hash: e8b0e6539e09678e9e8def68795f8bcb992f98509423da3da3123eda88ec1dd5
|
||||
source_path: concepts/active-memory.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Memoria activa
|
||||
|
||||
La memoria activa es un subagente de memoria bloqueante opcional propiedad del plugin que se ejecuta
|
||||
antes de la respuesta principal para las sesiones conversacionales elegibles.
|
||||
La memoria activa es un subagente de memoria de bloqueo opcional propiedad del plugin que se ejecuta
|
||||
antes de la respuesta principal en las sesiones conversacionales elegibles.
|
||||
|
||||
Existe porque la mayoría de los sistemas de memoria son capaces, pero reactivos. Dependen de
|
||||
Existe porque la mayoría de los sistemas de memoria son capaces pero reactivos. Dependen de
|
||||
que el agente principal decida cuándo buscar en la memoria, o de que el usuario diga cosas
|
||||
como "recuerda esto" o "busca en la memoria". Para entonces, el momento en que la memoria
|
||||
como "recuerda esto" o "busca en la memoria". Para entonces, el momento en el que la memoria
|
||||
habría hecho que la respuesta se sintiera natural ya pasó.
|
||||
|
||||
La memoria activa le da al sistema una oportunidad acotada de sacar a la superficie memoria relevante
|
||||
La memoria activa da al sistema una oportunidad limitada de mostrar memoria relevante
|
||||
antes de que se genere la respuesta principal.
|
||||
|
||||
## Pega esto en tu agente
|
||||
@ -56,15 +56,15 @@ configuración autónoma y segura por defecto:
|
||||
}
|
||||
```
|
||||
|
||||
Esto activa el plugin para el agente `main`, lo mantiene limitado a sesiones
|
||||
de estilo mensaje directo de forma predeterminada, le permite heredar primero el modelo de la sesión actual y
|
||||
Esto activa el plugin para el agente `main`, lo mantiene limitado de forma predeterminada a sesiones
|
||||
de estilo mensaje directo, le permite heredar primero el modelo de la sesión actual y
|
||||
sigue permitiendo la reserva remota integrada si no hay ningún modelo explícito o heredado
|
||||
disponible.
|
||||
|
||||
Después de eso, reinicia el gateway:
|
||||
Después de eso, reinicia la gateway:
|
||||
|
||||
```bash
|
||||
node scripts/run-node.mjs gateway --profile dev
|
||||
openclaw gateway
|
||||
```
|
||||
|
||||
Para inspeccionarlo en vivo en una conversación:
|
||||
@ -78,10 +78,10 @@ Para inspeccionarlo en vivo en una conversación:
|
||||
La configuración más segura es:
|
||||
|
||||
1. habilitar el plugin
|
||||
2. apuntar a un agente conversacional
|
||||
3. mantener el registro activado solo mientras ajustas la configuración
|
||||
2. dirigirlo a un agente conversacional
|
||||
3. mantener el registro activado solo mientras haces ajustes
|
||||
|
||||
Comienza con esto en `openclaw.json`:
|
||||
Empieza con esto en `openclaw.json`:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -106,25 +106,25 @@ Comienza con esto en `openclaw.json`:
|
||||
}
|
||||
```
|
||||
|
||||
Luego reinicia el gateway:
|
||||
Luego reinicia la gateway:
|
||||
|
||||
```bash
|
||||
node scripts/run-node.mjs gateway --profile dev
|
||||
openclaw gateway
|
||||
```
|
||||
|
||||
Qué significa esto:
|
||||
|
||||
- `plugins.entries.active-memory.enabled: true` activa el plugin
|
||||
- `config.agents: ["main"]` habilita la memoria activa solo para el agente `main`
|
||||
- `config.allowedChatTypes: ["direct"]` mantiene la memoria activa activada de forma predeterminada solo para sesiones de estilo mensaje directo
|
||||
- `config.agents: ["main"]` hace que solo el agente `main` use la memoria activa
|
||||
- `config.allowedChatTypes: ["direct"]` mantiene la memoria activa habilitada de forma predeterminada solo para sesiones de estilo mensaje directo
|
||||
- si `config.model` no está configurado, la memoria activa hereda primero el modelo de la sesión actual
|
||||
- `config.modelFallbackPolicy: "default-remote"` mantiene la reserva remota integrada como predeterminada cuando no hay ningún modelo explícito o heredado disponible
|
||||
- `config.promptStyle: "balanced"` usa el estilo de prompt predeterminado de propósito general para el modo `recent`
|
||||
- la memoria activa sigue ejecutándose solo en sesiones de chat interactivas persistentes elegibles
|
||||
- `config.modelFallbackPolicy: "default-remote"` mantiene la reserva remota integrada como valor predeterminado cuando no hay un modelo explícito o heredado disponible
|
||||
- `config.promptStyle: "balanced"` usa el estilo de prompt general predeterminado para el modo `recent`
|
||||
- la memoria activa sigue ejecutándose solo en sesiones de chat persistentes, interactivas y elegibles
|
||||
|
||||
## Cómo verla
|
||||
## Cómo verlo
|
||||
|
||||
La memoria activa inyecta contexto del sistema oculto para el modelo. No expone
|
||||
La memoria activa inyecta contexto oculto del sistema para el modelo. No expone
|
||||
etiquetas sin procesar `<active_memory_plugin>...</active_memory_plugin>` al cliente.
|
||||
|
||||
## Alternancia por sesión
|
||||
@ -139,7 +139,7 @@ sesión de chat actual sin editar la configuración:
|
||||
```
|
||||
|
||||
Esto tiene alcance de sesión. No cambia
|
||||
`plugins.entries.active-memory.enabled`, la selección del agente ni otra
|
||||
`plugins.entries.active-memory.enabled`, la selección de agentes ni otra
|
||||
configuración global.
|
||||
|
||||
Si quieres que el comando escriba la configuración y pause o reanude la memoria activa para
|
||||
@ -152,35 +152,35 @@ todas las sesiones, usa la forma global explícita:
|
||||
```
|
||||
|
||||
La forma global escribe `plugins.entries.active-memory.config.enabled`. Deja
|
||||
`plugins.entries.active-memory.enabled` activado para que el comando siga estando disponible para
|
||||
`plugins.entries.active-memory.enabled` activado para que el comando siga disponible para
|
||||
volver a activar la memoria activa más adelante.
|
||||
|
||||
Si quieres ver qué está haciendo la memoria activa en una sesión en vivo, activa el modo
|
||||
detallado para esa sesión:
|
||||
Si quieres ver qué está haciendo la memoria activa en una sesión en vivo, activa
|
||||
el modo detallado para esa sesión:
|
||||
|
||||
```text
|
||||
/verbose on
|
||||
```
|
||||
|
||||
Con el modo detallado activado, OpenClaw puede mostrar:
|
||||
Con el modo detallado habilitado, OpenClaw puede mostrar:
|
||||
|
||||
- una línea de estado de la memoria activa como `Active Memory: ok 842ms recent 34 chars`
|
||||
- un resumen de depuración legible como `Active Memory Debug: Lemon pepper wings with blue cheese.`
|
||||
|
||||
Esas líneas se derivan del mismo paso de memoria activa que alimenta el contexto oculto del
|
||||
sistema, pero están formateadas para humanos en lugar de exponer marcado de prompt sin procesar.
|
||||
Esas líneas se derivan del mismo paso de memoria activa que alimenta el contexto oculto
|
||||
del sistema, pero están formateadas para humanos en lugar de exponer marcado de prompt sin procesar.
|
||||
|
||||
De forma predeterminada, la transcripción del subagente de memoria bloqueante es temporal y se elimina
|
||||
después de que finaliza la ejecución.
|
||||
De forma predeterminada, la transcripción del subagente de memoria de bloqueo es temporal y se elimina
|
||||
después de que se completa la ejecución.
|
||||
|
||||
Ejemplo de flujo:
|
||||
Flujo de ejemplo:
|
||||
|
||||
```text
|
||||
/verbose on
|
||||
what wings should i order?
|
||||
```
|
||||
|
||||
Forma esperada de la respuesta visible:
|
||||
Forma visible de respuesta esperada:
|
||||
|
||||
```text
|
||||
...normal assistant reply...
|
||||
@ -191,14 +191,14 @@ Forma esperada de la respuesta visible:
|
||||
|
||||
## Cuándo se ejecuta
|
||||
|
||||
La memoria activa usa dos compuertas:
|
||||
La memoria activa usa dos controles:
|
||||
|
||||
1. **Inclusión por configuración**
|
||||
El plugin debe estar habilitado, y el id del agente actual debe aparecer en
|
||||
1. **Participación mediante configuración**
|
||||
El plugin debe estar habilitado y el id del agente actual debe aparecer en
|
||||
`plugins.entries.active-memory.config.agents`.
|
||||
2. **Elegibilidad estricta en tiempo de ejecución**
|
||||
Incluso cuando está habilitada y dirigida, la memoria activa solo se ejecuta para
|
||||
sesiones de chat interactivas persistentes elegibles.
|
||||
Incluso cuando está habilitada y dirigida, la memoria activa solo se ejecuta en
|
||||
sesiones de chat persistentes, interactivas y elegibles.
|
||||
|
||||
La regla real es:
|
||||
|
||||
@ -214,12 +214,12 @@ eligible interactive persistent chat session
|
||||
active memory runs
|
||||
```
|
||||
|
||||
Si cualquiera de esos elementos falla, la memoria activa no se ejecuta.
|
||||
Si cualquiera de esas condiciones falla, la memoria activa no se ejecuta.
|
||||
|
||||
## Tipos de sesión
|
||||
|
||||
`config.allowedChatTypes` controla qué tipos de conversaciones pueden ejecutar Memoria
|
||||
activa.
|
||||
activa en absoluto.
|
||||
|
||||
El valor predeterminado es:
|
||||
|
||||
@ -227,8 +227,8 @@ El valor predeterminado es:
|
||||
allowedChatTypes: ["direct"]
|
||||
```
|
||||
|
||||
Eso significa que la Memoria activa se ejecuta de forma predeterminada en sesiones de estilo mensaje directo, pero
|
||||
no en sesiones de grupo o canal a menos que las incluyas explícitamente.
|
||||
Eso significa que Memoria activa se ejecuta de forma predeterminada en sesiones de estilo mensaje directo, pero
|
||||
no en sesiones de grupo o canal a menos que las habilites explícitamente.
|
||||
|
||||
Ejemplos:
|
||||
|
||||
@ -249,14 +249,14 @@ allowedChatTypes: ["direct", "group", "channel"]
|
||||
La memoria activa es una función de enriquecimiento conversacional, no una
|
||||
función de inferencia para toda la plataforma.
|
||||
|
||||
| Superficie | ¿Se ejecuta la memoria activa? |
|
||||
| Superficie | ¿Se ejecuta la memoria activa? |
|
||||
| ------------------------------------------------------------------- | ------------------------------------------------------- |
|
||||
| Sesiones persistentes de Control UI / chat web | Sí, si el plugin está habilitado y el agente está seleccionado |
|
||||
| Otras sesiones de canal interactivas en la misma ruta de chat persistente | Sí, si el plugin está habilitado y el agente está seleccionado |
|
||||
| Ejecuciones sin interfaz de un solo uso | No |
|
||||
| Sesiones persistentes de la UI de control / chat web | Sí, si el plugin está habilitado y el agente está dirigido |
|
||||
| Otras sesiones de canales interactivos en la misma ruta de chat persistente | Sí, si el plugin está habilitado y el agente está dirigido |
|
||||
| Ejecuciones puntuales sin interfaz | No |
|
||||
| Ejecuciones de latido/en segundo plano | No |
|
||||
| Rutas internas genéricas de `agent-command` | No |
|
||||
| Ejecución interna/de ayuda de subagentes | No |
|
||||
| Ejecución de subagentes/ayudantes internos | No |
|
||||
|
||||
## Por qué usarla
|
||||
|
||||
@ -264,19 +264,19 @@ Usa la memoria activa cuando:
|
||||
|
||||
- la sesión es persistente y orientada al usuario
|
||||
- el agente tiene memoria a largo plazo significativa para buscar
|
||||
- la continuidad y la personalización importan más que el determinismo puro del prompt
|
||||
- la continuidad y la personalización importan más que el determinismo bruto del prompt
|
||||
|
||||
Funciona especialmente bien para:
|
||||
|
||||
- preferencias estables
|
||||
- hábitos recurrentes
|
||||
- contexto del usuario a largo plazo que debería aflorar de forma natural
|
||||
- contexto de usuario a largo plazo que debería aparecer de forma natural
|
||||
|
||||
No es una buena opción para:
|
||||
No es adecuada para:
|
||||
|
||||
- automatización
|
||||
- workers internos
|
||||
- tareas de API de un solo uso
|
||||
- tareas puntuales de API
|
||||
- lugares donde la personalización oculta sería sorprendente
|
||||
|
||||
## Cómo funciona
|
||||
@ -292,7 +292,7 @@ flowchart LR
|
||||
I --> M["Main Reply"]
|
||||
```
|
||||
|
||||
El subagente de memoria bloqueante solo puede usar:
|
||||
El subagente de memoria de bloqueo solo puede usar:
|
||||
|
||||
- `memory_search`
|
||||
- `memory_get`
|
||||
@ -301,20 +301,20 @@ Si la conexión es débil, debe devolver `NONE`.
|
||||
|
||||
## Modos de consulta
|
||||
|
||||
`config.queryMode` controla cuánto de la conversación ve el subagente de memoria bloqueante.
|
||||
`config.queryMode` controla cuánta conversación ve el subagente de memoria de bloqueo.
|
||||
|
||||
## Estilos de prompt
|
||||
|
||||
`config.promptStyle` controla cuán dispuesto o estricto es el subagente de memoria bloqueante
|
||||
`config.promptStyle` controla qué tan dispuesto o estricto es el subagente de memoria de bloqueo
|
||||
al decidir si devolver memoria.
|
||||
|
||||
Estilos disponibles:
|
||||
|
||||
- `balanced`: predeterminado de propósito general para el modo `recent`
|
||||
- `strict`: el menos dispuesto; ideal cuando quieres muy poca contaminación del contexto cercano
|
||||
- `contextual`: el más favorable para la continuidad; ideal cuando el historial de conversación debe importar más
|
||||
- `recall-heavy`: más dispuesto a sacar a la superficie memoria con coincidencias más suaves pero aún plausibles
|
||||
- `precision-heavy`: prefiere agresivamente `NONE` a menos que la coincidencia sea evidente
|
||||
- `balanced`: valor predeterminado de propósito general para el modo `recent`
|
||||
- `strict`: el menos dispuesto; mejor cuando quieres muy poca influencia del contexto cercano
|
||||
- `contextual`: el más favorable para la continuidad; mejor cuando el historial de conversación debe importar más
|
||||
- `recall-heavy`: más dispuesto a mostrar memoria en coincidencias menos claras pero aún plausibles
|
||||
- `precision-heavy`: prefiere agresivamente `NONE` a menos que la coincidencia sea obvia
|
||||
- `preference-only`: optimizado para favoritos, hábitos, rutinas, gustos y hechos personales recurrentes
|
||||
|
||||
Asignación predeterminada cuando `config.promptStyle` no está configurado:
|
||||
@ -325,7 +325,7 @@ recent -> balanced
|
||||
full -> contextual
|
||||
```
|
||||
|
||||
Si configuras `config.promptStyle` explícitamente, esa anulación prevalece.
|
||||
Si configuras `config.promptStyle` explícitamente, esa anulación tiene prioridad.
|
||||
|
||||
Ejemplo:
|
||||
|
||||
@ -333,9 +333,9 @@ Ejemplo:
|
||||
promptStyle: "preference-only"
|
||||
```
|
||||
|
||||
## Política de reserva de modelo
|
||||
## Política de reserva del modelo
|
||||
|
||||
Si `config.model` no está configurado, la Memoria activa intenta resolver un modelo en este orden:
|
||||
Si `config.model` no está configurado, Memoria activa intenta resolver un modelo en este orden:
|
||||
|
||||
```text
|
||||
explicit plugin model
|
||||
@ -358,15 +358,15 @@ Otra opción:
|
||||
modelFallbackPolicy: "resolved-only"
|
||||
```
|
||||
|
||||
Usa `resolved-only` si quieres que la Memoria activa omita la recuperación en lugar de usar
|
||||
la reserva remota integrada predeterminada cuando no hay ningún modelo explícito o heredado
|
||||
Usa `resolved-only` si quieres que Memoria activa omita la recuperación en lugar de usar
|
||||
la reserva remota integrada predeterminada cuando no haya un modelo explícito o heredado
|
||||
disponible.
|
||||
|
||||
## Vías de escape avanzadas
|
||||
|
||||
Estas opciones intencionalmente no forman parte de la configuración recomendada.
|
||||
|
||||
`config.thinking` puede anular el nivel de razonamiento del subagente de memoria bloqueante:
|
||||
`config.thinking` puede anular el nivel de razonamiento del subagente de memoria de bloqueo:
|
||||
|
||||
```json5
|
||||
thinking: "medium"
|
||||
@ -378,11 +378,11 @@ Predeterminado:
|
||||
thinking: "off"
|
||||
```
|
||||
|
||||
No habilites esto de forma predeterminada. La Memoria activa se ejecuta en la ruta de respuesta, por lo que el tiempo
|
||||
adicional de razonamiento incrementa directamente la latencia visible para el usuario.
|
||||
No habilites esto de forma predeterminada. Memoria activa se ejecuta en la ruta de respuesta, por lo que el
|
||||
tiempo adicional de razonamiento aumenta directamente la latencia visible para el usuario.
|
||||
|
||||
`config.promptAppend` agrega instrucciones adicionales del operador después del prompt predeterminado de Memoria
|
||||
activa y antes del contexto de la conversación:
|
||||
`config.promptAppend` agrega instrucciones adicionales del operador después del prompt
|
||||
predeterminado de Memoria activa y antes del contexto de la conversación:
|
||||
|
||||
```json5
|
||||
promptAppend: "Prefer stable long-term preferences over one-off events."
|
||||
@ -395,8 +395,8 @@ sigue agregando después el contexto de la conversación:
|
||||
promptOverride: "You are a memory search agent. Return NONE or one compact user fact."
|
||||
```
|
||||
|
||||
No se recomienda personalizar prompts a menos que estés probando deliberadamente un
|
||||
contrato de recuperación distinto. El prompt predeterminado está ajustado para devolver `NONE`
|
||||
No se recomienda la personalización del prompt a menos que estés probando deliberadamente un
|
||||
contrato de recuperación diferente. El prompt predeterminado está ajustado para devolver `NONE`
|
||||
o contexto compacto de hechos del usuario para el modelo principal.
|
||||
|
||||
### `message`
|
||||
@ -407,19 +407,19 @@ Solo se envía el mensaje más reciente del usuario.
|
||||
Latest user message only
|
||||
```
|
||||
|
||||
Usa esto cuando:
|
||||
Úsalo cuando:
|
||||
|
||||
- quieres el comportamiento más rápido
|
||||
- quieres el sesgo más fuerte hacia la recuperación de preferencias estables
|
||||
- los turnos de seguimiento no necesitan contexto conversacional
|
||||
- quieras el comportamiento más rápido
|
||||
- quieras el sesgo más fuerte hacia la recuperación de preferencias estables
|
||||
- los turnos de seguimiento no necesiten contexto conversacional
|
||||
|
||||
Tiempo de espera recomendado:
|
||||
|
||||
- comienza alrededor de `3000` a `5000` ms
|
||||
- empieza alrededor de `3000` a `5000` ms
|
||||
|
||||
### `recent`
|
||||
|
||||
Se envía el mensaje más reciente del usuario más una pequeña cola conversacional reciente.
|
||||
Se envían el mensaje más reciente del usuario y una pequeña cola conversacional reciente.
|
||||
|
||||
```text
|
||||
Recent conversation tail:
|
||||
@ -431,18 +431,18 @@ Latest user message:
|
||||
...
|
||||
```
|
||||
|
||||
Usa esto cuando:
|
||||
Úsalo cuando:
|
||||
|
||||
- quieres un mejor equilibrio entre velocidad y base conversacional
|
||||
- las preguntas de seguimiento suelen depender de los últimos turnos
|
||||
- quieras un mejor equilibrio entre velocidad y base conversacional
|
||||
- las preguntas de seguimiento dependan con frecuencia de los últimos turnos
|
||||
|
||||
Tiempo de espera recomendado:
|
||||
|
||||
- comienza alrededor de `15000` ms
|
||||
- empieza alrededor de `15000` ms
|
||||
|
||||
### `full`
|
||||
|
||||
La conversación completa se envía al subagente de memoria bloqueante.
|
||||
La conversación completa se envía al subagente de memoria de bloqueo.
|
||||
|
||||
```text
|
||||
Full conversation context:
|
||||
@ -452,15 +452,15 @@ user: ...
|
||||
...
|
||||
```
|
||||
|
||||
Usa esto cuando:
|
||||
Úsalo cuando:
|
||||
|
||||
- la mejor calidad de recuperación importa más que la latencia
|
||||
- la conversación contiene una preparación importante muy atrás en el hilo
|
||||
- la mayor calidad de recuperación importe más que la latencia
|
||||
- la conversación contenga una preparación importante muy atrás en el hilo
|
||||
|
||||
Tiempo de espera recomendado:
|
||||
|
||||
- auméntalo considerablemente en comparación con `message` o `recent`
|
||||
- comienza alrededor de `15000` ms o más según el tamaño del hilo
|
||||
- auméntalo sustancialmente en comparación con `message` o `recent`
|
||||
- empieza alrededor de `15000` ms o más, según el tamaño del hilo
|
||||
|
||||
En general, el tiempo de espera debe aumentar con el tamaño del contexto:
|
||||
|
||||
@ -470,16 +470,16 @@ message < recent < full
|
||||
|
||||
## Persistencia de transcripciones
|
||||
|
||||
Las ejecuciones del subagente de memoria bloqueante de la memoria activa crean una transcripción real `session.jsonl`
|
||||
durante la llamada al subagente de memoria bloqueante.
|
||||
Las ejecuciones del subagente de memoria de bloqueo de la memoria activa crean una transcripción real `session.jsonl`
|
||||
durante la llamada del subagente de memoria de bloqueo.
|
||||
|
||||
De forma predeterminada, esa transcripción es temporal:
|
||||
|
||||
- se escribe en un directorio temporal
|
||||
- se usa solo para la ejecución del subagente de memoria bloqueante
|
||||
- se elimina inmediatamente después de que finaliza la ejecución
|
||||
- se usa solo para la ejecución del subagente de memoria de bloqueo
|
||||
- se elimina inmediatamente después de que termina la ejecución
|
||||
|
||||
Si quieres conservar esas transcripciones del subagente de memoria bloqueante en disco para depuración o
|
||||
Si quieres conservar en disco esas transcripciones del subagente de memoria de bloqueo para depuración o
|
||||
inspección, activa la persistencia explícitamente:
|
||||
|
||||
```json5
|
||||
@ -500,7 +500,8 @@ inspección, activa la persistencia explícitamente:
|
||||
```
|
||||
|
||||
Cuando está habilitada, la memoria activa almacena las transcripciones en un directorio separado dentro de la
|
||||
carpeta de sesiones del agente de destino, no en la ruta principal de transcripción de la conversación del usuario.
|
||||
carpeta de sesiones del agente de destino, no en la ruta principal de transcripción de la conversación
|
||||
del usuario.
|
||||
|
||||
La disposición predeterminada es conceptualmente:
|
||||
|
||||
@ -512,9 +513,9 @@ Puedes cambiar el subdirectorio relativo con `config.transcriptDir`.
|
||||
|
||||
Usa esto con cuidado:
|
||||
|
||||
- las transcripciones del subagente de memoria bloqueante pueden acumularse rápidamente en sesiones con mucha actividad
|
||||
- las transcripciones del subagente de memoria de bloqueo pueden acumularse rápidamente en sesiones con mucha actividad
|
||||
- el modo de consulta `full` puede duplicar mucho contexto de conversación
|
||||
- estas transcripciones contienen contexto de prompt oculto y memorias recuperadas
|
||||
- estas transcripciones contienen contexto oculto del prompt y memorias recuperadas
|
||||
|
||||
## Configuración
|
||||
|
||||
@ -526,36 +527,36 @@ plugins.entries.active-memory
|
||||
|
||||
Los campos más importantes son:
|
||||
|
||||
| Clave | Tipo | Significado |
|
||||
| --------------------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
|
||||
| `enabled` | `boolean` | Habilita el plugin en sí |
|
||||
| `config.agents` | `string[]` | Id. de agentes que pueden usar memoria activa |
|
||||
| `config.model` | `string` | Referencia opcional del modelo del subagente de memoria bloqueante; cuando no está configurado, la memoria activa usa el modelo de la sesión actual |
|
||||
| `config.queryMode` | `"message" \| "recent" \| "full"` | Controla cuánto de la conversación ve el subagente de memoria bloqueante |
|
||||
| `config.promptStyle` | `"balanced" \| "strict" \| "contextual" \| "recall-heavy" \| "precision-heavy" \| "preference-only"` | Controla cuán dispuesto o estricto es el subagente de memoria bloqueante al decidir si devolver memoria |
|
||||
| `config.thinking` | `"off" \| "minimal" \| "low" \| "medium" \| "high" \| "xhigh" \| "adaptive"` | Anulación avanzada del nivel de razonamiento para el subagente de memoria bloqueante; valor predeterminado `off` por velocidad |
|
||||
| `config.promptOverride` | `string` | Reemplazo avanzado completo del prompt; no se recomienda para uso normal |
|
||||
| `config.promptAppend` | `string` | Instrucciones avanzadas adicionales añadidas al prompt predeterminado o reemplazado |
|
||||
| `config.timeoutMs` | `number` | Tiempo de espera máximo estricto para el subagente de memoria bloqueante |
|
||||
| `config.maxSummaryChars` | `number` | Cantidad máxima total de caracteres permitida en el resumen de active-memory |
|
||||
| `config.logging` | `boolean` | Emite registros de memoria activa durante el ajuste |
|
||||
| `config.persistTranscripts` | `boolean` | Conserva en disco las transcripciones del subagente de memoria bloqueante en lugar de eliminar los archivos temporales |
|
||||
| `config.transcriptDir` | `string` | Directorio relativo de transcripciones del subagente de memoria bloqueante dentro de la carpeta de sesiones del agente |
|
||||
| Clave | Tipo | Significado |
|
||||
| --------------------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
|
||||
| `enabled` | `boolean` | Habilita el propio plugin |
|
||||
| `config.agents` | `string[]` | IDs de agentes que pueden usar memoria activa |
|
||||
| `config.model` | `string` | Referencia opcional al modelo del subagente de memoria de bloqueo; cuando no está configurado, la memoria activa usa el modelo de la sesión actual |
|
||||
| `config.queryMode` | `"message" \| "recent" \| "full"` | Controla cuánta conversación ve el subagente de memoria de bloqueo |
|
||||
| `config.promptStyle` | `"balanced" \| "strict" \| "contextual" \| "recall-heavy" \| "precision-heavy" \| "preference-only"` | Controla qué tan dispuesto o estricto es el subagente de memoria de bloqueo al decidir si devolver memoria |
|
||||
| `config.thinking` | `"off" \| "minimal" \| "low" \| "medium" \| "high" \| "xhigh" \| "adaptive"` | Anulación avanzada del nivel de razonamiento para el subagente de memoria de bloqueo; valor predeterminado `off` para velocidad |
|
||||
| `config.promptOverride` | `string` | Reemplazo avanzado completo del prompt; no se recomienda para uso normal |
|
||||
| `config.promptAppend` | `string` | Instrucciones adicionales avanzadas añadidas al prompt predeterminado o reemplazado |
|
||||
| `config.timeoutMs` | `number` | Tiempo de espera máximo estricto para el subagente de memoria de bloqueo |
|
||||
| `config.maxSummaryChars` | `number` | Número máximo total de caracteres permitidos en el resumen de active-memory |
|
||||
| `config.logging` | `boolean` | Emite registros de memoria activa durante el ajuste |
|
||||
| `config.persistTranscripts` | `boolean` | Conserva en disco las transcripciones del subagente de memoria de bloqueo en lugar de eliminar archivos temporales |
|
||||
| `config.transcriptDir` | `string` | Directorio relativo de transcripciones del subagente de memoria de bloqueo dentro de la carpeta de sesiones del agente |
|
||||
|
||||
Campos de ajuste útiles:
|
||||
Campos útiles para ajuste:
|
||||
|
||||
| Clave | Tipo | Significado |
|
||||
| ----------------------------- | -------- | ------------------------------------------------------------ |
|
||||
| `config.maxSummaryChars` | `number` | Cantidad máxima total de caracteres permitida en el resumen de active-memory |
|
||||
| `config.maxSummaryChars` | `number` | Número máximo total de caracteres permitidos en el resumen de active-memory |
|
||||
| `config.recentUserTurns` | `number` | Turnos previos del usuario que se incluirán cuando `queryMode` sea `recent` |
|
||||
| `config.recentAssistantTurns` | `number` | Turnos previos del asistente que se incluirán cuando `queryMode` sea `recent` |
|
||||
| `config.recentUserChars` | `number` | Cantidad máxima de caracteres por turno reciente del usuario |
|
||||
| `config.recentAssistantChars` | `number` | Cantidad máxima de caracteres por turno reciente del asistente |
|
||||
| `config.recentUserChars` | `number` | Máximo de caracteres por turno reciente del usuario |
|
||||
| `config.recentAssistantChars` | `number` | Máximo de caracteres por turno reciente del asistente |
|
||||
| `config.cacheTtlMs` | `number` | Reutilización de caché para consultas idénticas repetidas |
|
||||
|
||||
## Configuración recomendada
|
||||
|
||||
Comienza con `recent`.
|
||||
Empieza con `recent`.
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -577,25 +578,25 @@ Comienza con `recent`.
|
||||
}
|
||||
```
|
||||
|
||||
Si quieres inspeccionar el comportamiento en vivo mientras ajustas la configuración, usa `/verbose on` en la
|
||||
sesión en lugar de buscar un comando de depuración de active-memory independiente.
|
||||
Si quieres inspeccionar el comportamiento en vivo mientras haces ajustes, usa `/verbose on` en la
|
||||
sesión en lugar de buscar un comando de depuración de active-memory separado.
|
||||
|
||||
Luego cambia a:
|
||||
|
||||
- `message` si quieres menor latencia
|
||||
- `full` si decides que el contexto adicional vale la pena aunque el subagente de memoria bloqueante sea más lento
|
||||
- `full` si decides que el contexto adicional vale la pena pese a que el subagente de memoria de bloqueo sea más lento
|
||||
|
||||
## Depuración
|
||||
|
||||
Si la memoria activa no aparece donde esperas:
|
||||
|
||||
1. Confirma que el plugin esté habilitado en `plugins.entries.active-memory.enabled`.
|
||||
2. Confirma que el id. del agente actual figure en `config.agents`.
|
||||
3. Confirma que estás probando mediante una sesión de chat interactiva persistente.
|
||||
4. Activa `config.logging: true` y observa los registros del gateway.
|
||||
5. Verifica que la búsqueda en memoria en sí funcione con `openclaw memory status --deep`.
|
||||
2. Confirma que el id del agente actual esté listado en `config.agents`.
|
||||
3. Confirma que estás probando mediante una sesión de chat persistente e interactiva.
|
||||
4. Activa `config.logging: true` y observa los registros de la gateway.
|
||||
5. Verifica que la búsqueda de memoria en sí funcione con `openclaw memory status --deep`.
|
||||
|
||||
Si las coincidencias de memoria son ruidosas, ajusta más:
|
||||
Si los resultados de memoria son ruidosos, ajusta más estrictamente:
|
||||
|
||||
- `maxSummaryChars`
|
||||
|
||||
@ -603,11 +604,11 @@ Si la memoria activa es demasiado lenta:
|
||||
|
||||
- reduce `queryMode`
|
||||
- reduce `timeoutMs`
|
||||
- reduce la cantidad de turnos recientes
|
||||
- reduce los recuentos de turnos recientes
|
||||
- reduce los límites de caracteres por turno
|
||||
|
||||
## Páginas relacionadas
|
||||
|
||||
- [Búsqueda en memoria](/es/concepts/memory-search)
|
||||
- [Búsqueda de memoria](/es/concepts/memory-search)
|
||||
- [Referencia de configuración de memoria](/es/reference/memory-config)
|
||||
- [Configuración del Plugin SDK](/es/plugins/sdk-setup)
|
||||
|
||||
Loading…
Reference in New Issue
Block a user