Memoria

openclaw memory

Administrar la indexación y la búsqueda de memoria semántica. Proporcionado por el complemento memory-core incluido. El comando está disponible cuando plugins.slots.memory selecciona memory-core (el predeterminado); otros complementos de memoria exponen sus propios espacios de nombres de CLI.

Relacionado:

• Concepto de memoria: Memory
• Wiki de memoria: Memory Wiki
• CLI de Wiki: wiki
• Complementos: Plugins

Ejemplos

openclaw memory status
openclaw memory status --deep
openclaw memory status --fix
openclaw memory index --force
openclaw memory search "meeting notes"
openclaw memory search --query "deployment" --max-results 20
openclaw memory promote --limit 10 --min-score 0.75
openclaw memory promote --apply
openclaw memory promote --json --min-recall-count 0 --min-unique-queries 0
openclaw memory promote-explain "router vlan"
openclaw memory promote-explain "router vlan" --json
openclaw memory rem-harness
openclaw memory rem-harness --json
openclaw memory status --json
openclaw memory status --deep --index
openclaw memory status --deep --index --verbose
openclaw memory status --agent main
openclaw memory index --agent main --verbose

Opciones

memory status y memory index:

• --agent <id>: limitar a un solo agente. Sin esto, estos comandos se ejecutan para cada agente configurado; si no se configura una lista de agentes, vuelven al agente predeterminado.
• --verbose: emitir registros detallados durante sondas e indexación.

memory status:

• --deep: sondear la preparación del almacén de vectores local, la preparación del proveedor de incrustaciones y la preparación de búsqueda de vectores semánticos. memory status simple sigue siendo rápido y no ejecuta trabajos de incrustación en vivo ni de descubrimiento de proveedores; el estado desconocido del almacén de vectores o del vector semántico significa que no se sondeó en ese comando. La búsqueda léxica QMD searchMode: "search" omite las sondas de vectores semánticos y el mantenimiento de incrustaciones incluso con --deep.
• --index: ejecutar una reindexación si el almacén está sucio (implica --deep).
• --fix: reparar bloqueos de recuperación obsoletos y normalizar los metadatos de promoción.
• --json: imprimir salida JSON.

Si memory status muestra Dreaming status: blocked, el cron de soñando administrado está habilitado pero el latido que lo impulsa no se está ejecutando para el agente predeterminado. Consulte Dreaming never runs para conocer las dos causas comunes.

memory index:

• --force: forzar una reindexación completa.

memory search:

• Entrada de consulta: pasar [query] posicional o --query <text>.
• Si se proporcionan ambos, --query tiene prioridad.
• Si no se proporciona ninguno, el comando finaliza con un error.
• --agent <id>: limitar a un solo agente (predeterminado: el agente predeterminado).
• --max-results <n>: limitar el número de resultados devueltos.
• --min-score <n>: filtrar las coincidencias con puntuación baja.
• --json: imprimir resultados en JSON.

memory promote:

Vista previa y aplicación de promociones de memoria a corto plazo.

openclaw memory promote [--apply] [--limit <n>] [--include-promoted]

• --apply — escribir promociones en MEMORY.md (predeterminado: solo vista previa).
• --limit <n> — limitar el número de candidatos mostrados.
• --include-promoted — incluir entradas ya promovidas en ciclos anteriores.

Opciones completas:

• Clasifica los candidatos a corto plazo de memory/YYYY-MM-DD.md utilizando señales de promoción ponderadas (frequency, relevance, query diversity, recency, consolidation, conceptual richness).
• Utiliza señales a corto plazo tanto de recuperaciones de memoria como de pasadas de ingestión diaria, además de señales de refuerzo de fase ligera/REM.
• Cuando la función de soñar está habilitada, memory-core gestiona automáticamente un trabajo cron que ejecuta un barrido completo (light -> REM -> deep) en segundo plano (no se requiere openclaw cron add manual).
• --agent <id>: limitar a un solo agente (predeterminado: el agente predeterminado).
• --limit <n>: máximo de candidatos a devolver/aplicar.
• --min-score <n>: puntuación mínima de promoción ponderada.
• --min-recall-count <n>: recuento mínimo de recuperaciones requerido para un candidato.
• --min-unique-queries <n>: recuento mínimo de consultas distintas requerido para un candidato.
• --apply: añadir los candidatos seleccionados a MEMORY.md y marcarlos como promovidos.
• --include-promoted: incluir candidatos ya promovidos en la salida.
• --json: imprimir salida en JSON.

memory promote-explain:

Explicar un candidato de promoción específico y el desglose de su puntuación.

openclaw memory promote-explain <selector> [--agent <id>] [--include-promoted] [--json]

• <selector>: clave de candidato, fragmento de ruta o fragmento de snippet a buscar.
• --agent <id>: limitar a un solo agente (predeterminado: el agente predeterminado).
• --include-promoted: incluir candidatos ya promovidos.
• --json: imprimir salida en JSON.

memory rem-harness:

Vista previa de reflexiones REM, verdades candidatas y salida de promoción profunda sin escribir nada.

openclaw memory rem-harness [--agent <id>] [--include-promoted] [--json]

• --agent <id>: limitar a un solo agente (predeterminado: el agente predeterminado).
• --include-promoted: incluir candidatos profundos ya promovidos.
• --json: imprimir salida JSON.

Soñar

Dreaming es el sistema de consolidación de memoria en segundo plano con tres fases cooperativas: light (clasificar/preparar material a corto plazo), deep (promover hechos duraderos a MEMORY.md) y REM (reflexionar y sacar a la luz temas).

• Activar con plugins.entries.memory-core.config.dreaming.enabled: true.
• Alternar desde el chat con /dreaming on|off (o inspeccionar con /dreaming status).
• Dreaming se ejecuta en un programa de barrido gestionado (dreaming.frequency) y ejecuta las fases en orden: light, REM, deep.
• Solo la fase deep escribe memoria duradera en MEMORY.md.
• La salida de fase legible por humanos y las entradas del diario se escriben en DREAMS.md (o en dreams.md existente), con informes opcionales por fase en memory/dreaming/<phase>/YYYY-MM-DD.md.
• La clasificación utiliza señales ponderadas: frecuencia de recuerdo, relevancia de recuperación, diversidad de consultas, novedad temporal, consolidación entre días y riqueza de conceptos derivados.
• La promoción vuelve a leer la nota diaria en vivo antes de escribir en MEMORY.md, por lo que los fragmentos a corto plazo editados o eliminados no se promueven desde instantáneas obsoletas del almacén de recuerdo.
• Las ejecuciones programadas y manuales de memory promote comparten los mismos valores predeterminados de la fase deep a menos que pases anulaciones de umbral de CLI.
• Las ejecuciones automáticas se distribuyen en los espacios de trabajo de memoria configurados.

Programación predeterminada:

• Sweep cadence: dreaming.frequency = 0 3 * * *
• Deep thresholds: minScore=0.8, minRecallCount=3, minUniqueQueries=3, recencyHalfLifeDays=14, maxAgeDays=30

Ejemplo:

{
  "plugins": {
    "entries": {
      "memory-core": {
        "config": {
          "dreaming": {
            "enabled": true
          }
        }
      }
    }
  }
}

Notas:

• memory index --verbose imprime detalles por fase (proveedor, modelo, fuentes, actividad por lotes).
• memory status incluye cualquier ruta adicional configurada a través de memorySearch.extraPaths.
• Si los campos de clave de API remota de memoria activa efectiva están configurados como SecretRefs, el comando resuelve esos valores desde la instantánea de la puerta de enlace activa. Si la puerta de enlace no está disponible, el comando falla rápidamente.
• Nota de desviación de versión de gateway: esta ruta de comando requiere un gateway que soporte secrets.resolve; los gateways antiguos devuelven un error de método desconocido.
• Ajustar la cadencia de barrido programada con dreaming.frequency. La política de promoción profunda es, por lo demás, interna; usa las banderas de CLI en memory promote cuando necesites anulaciones manuales puntuales.
• memory rem-harness --path <file-or-dir> --grounded previsualiza What Happened, Reflections y Possible Lasting Updates basados a partir de notas diarias históricas sin escribir nada.
• memory rem-backfill --path <file-or-dir> escribe entradas de diario basadas reversibles en DREAMS.md para su revisión en la interfaz de usuario.
• memory rem-backfill --path <file-or-dir> --stage-short-term también siembra candidatos duraderos basados en el almacén de promoción a corto plazo en vivo para que la fase profunda normal pueda clasificarlos.
• memory rem-backfill --rollback elimina las entradas de diario basadas escritas previamente, y memory rem-backfill --rollback-short-term elimina los candidatos a corto plazo basados preparados previamente.
• Consulte Dreaming para obtener descripciones completas de las fases y la referencia de configuración.

Relacionado

• Referencia de CLI
• Resumen de memoria