Motor de memoria QMD

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Qué añade frente al motor incorporado

• Reordenación y expansión de consultas para una mejor recuperación.
• Indexación de directorios adicionales — documentación de proyectos, notas del equipo, cualquier cosa en disco.
• Indexación de transcripciones de sesiones — recupera conversaciones anteriores.
• Totalmente local — se ejecuta con el paquete de runtime opcional node-llama-cpp y descarga automáticamente modelos GGUF.
• Reserva automática — si QMD no está disponible, OpenClaw recurre sin interrupciones al motor incorporado.

​

Primeros pasos

​

Requisitos previos

• Instala QMD: npm install -g @tobilu/qmd o bun install -g @tobilu/qmd
• Compilación de SQLite que permita extensiones (brew install sqlite en macOS).
• QMD debe estar en el PATH del Gateway.
• macOS y Linux funcionan directamente. Windows tiene mejor soporte mediante WSL2.

​

Activar

{
  memory: {
    backend: "qmd",
  },
}

​

Cómo funciona el componente auxiliar

• OpenClaw crea colecciones a partir de los archivos de memoria de tu espacio de trabajo y cualquier memory.qmd.paths configurado, luego ejecuta qmd update cuando se abre el gestor de QMD y periódicamente después (cada 5 minutos de forma predeterminada). Estas actualizaciones se ejecutan mediante subprocesos de QMD, no con un rastreo del sistema de archivos dentro del proceso. Los modos semánticos también ejecutan qmd embed.
• La colección predeterminada del espacio de trabajo hace seguimiento de MEMORY.md y del árbol memory/. memory.md en minúsculas no se indexa como archivo de memoria raíz.
• El escáner propio de QMD ignora rutas ocultas y directorios comunes de dependencias/compilación como .git, .cache, node_modules, vendor, dist y build. El inicio del Gateway no inicializa QMD de forma predeterminada, por lo que el arranque en frío evita importar el runtime de memoria o crear el observador de larga duración antes de que se use memoria por primera vez.
• Si aun así quieres una actualización al iniciar el Gateway, establece memory.qmd.update.startup en idle o immediate. La actualización de inicio opcional usa una ruta de subproceso QMD de una sola ejecución en lugar de crear el observador completo de larga duración dentro del proceso.
• Las búsquedas usan el searchMode configurado (predeterminado: search; también admite vsearch y query). search es solo BM25, por lo que OpenClaw omite las sondas de preparación vectorial semántica y el mantenimiento de embeddings en ese modo. Si un modo falla, OpenClaw reintenta con qmd query.
• Con versiones de QMD que anuncian filtros multcolección, OpenClaw agrupa colecciones del mismo origen en una única invocación de búsqueda QMD. Las versiones anteriores de QMD mantienen la reserva compatible por colección.
• Si QMD falla por completo, OpenClaw recurre al motor SQLite incorporado. Los intentos repetidos en turnos de chat aplican una breve espera tras un fallo de apertura para que un binario ausente o una dependencia rota del componente auxiliar no cree una tormenta de reintentos; openclaw memory status y las sondas CLI de una sola ejecución siguen comprobando QMD directamente.

​

Rendimiento de búsqueda y compatibilidad

qmd search "router notes" --json -n 10 -c memory-root-main -c memory-dir-main

qmd --help | grep -i collection

​

Sobrescrituras de modelos

export QMD_EMBED_MODEL="hf:Qwen/Qwen3-Embedding-0.6B-GGUF/Qwen3-Embedding-0.6B-Q8_0.gguf"
export QMD_RERANK_MODEL="/absolute/path/to/reranker.gguf"
export QMD_GENERATE_MODEL="/absolute/path/to/generator.gguf"

​

Indexación de rutas adicionales

{
  memory: {
    backend: "qmd",
    qmd: {
      paths: [{ name: "docs", path: "~/notes", pattern: "**/*.md" }],
    },
  },
}

​

Indexación de transcripciones de sesiones

{
  memory: {
    backend: "qmd",
    qmd: {
      sessions: { enabled: true },
    },
  },
}

​

Alcance de búsqueda

{
  memory: {
    qmd: {
      scope: {
        default: "deny",
        rules: [{ action: "allow", match: { chatType: "direct" } }],
      },
    },
  },
}

​

Citas

​

Cuándo usarlo

• Reordenación para obtener resultados de mayor calidad.
• Buscar documentación de proyectos o notas fuera del espacio de trabajo.
• Recuperar conversaciones de sesiones anteriores.
• Búsqueda totalmente local sin claves API.

​

Solución de problemas

{
  memory: {
    backend: "qmd",
    qmd: {
      command: "/absolute/path/to/qmd",
    },
  },
}

​

Configuración

​

Relacionado

• Resumen de memoria
• Motor de memoria incorporado
• Memoria de Honcho