​

Mecanismo de Memória QMD

​

O que ele adiciona em relação ao mecanismo builtin

• Reranqueamento e expansão de consulta para melhor recall.
• Indexa diretórios extras — docs do projeto, notas da equipe, qualquer coisa no disco.
• Indexa transcrições de sessão — relembra conversas anteriores.
• Totalmente local — roda via Bun + node-llama-cpp, baixa automaticamente modelos GGUF.
• Fallback automático — se o QMD não estiver disponível, o OpenClaw volta para o mecanismo builtin sem interrupções.

​

Primeiros passos

​

Pré-requisitos

• Instale o QMD: npm install -g @tobilu/qmd ou bun install -g @tobilu/qmd
• Build do SQLite que permita extensões (brew install sqlite no macOS).
• O QMD deve estar no PATH do gateway.
• macOS e Linux funcionam imediatamente. O Windows é melhor suportado via WSL2.

​

Habilitar

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

​

Como o sidecar funciona

• O OpenClaw cria coleções a partir dos seus arquivos de memória do workspace e de quaisquer memory.qmd.paths configurados, depois executa qmd update + qmd embed na inicialização e periodicamente (o padrão é a cada 5 minutos).
• A coleção padrão do workspace acompanha MEMORY.md mais a árvore memory/. memory.md em minúsculas continua sendo um fallback de bootstrap, não uma coleção QMD separada.
• A atualização na inicialização roda em segundo plano para que o início do chat não seja bloqueado.
• As buscas usam o searchMode configurado (padrão: search; também suporta vsearch e query). Se um modo falhar, o OpenClaw tenta novamente com qmd query.
• Se o QMD falhar completamente, o OpenClaw volta para o mecanismo SQLite builtin.

​

Sobrescritas de modelo

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"

​

Indexando caminhos extras

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

​

Indexando transcrições de sessão

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

​

Escopo de busca

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

​

Citações

​

Quando usar

• Reranqueamento para resultados de maior qualidade.
• Buscar docs de projeto ou notas fora do workspace.
• Relembrar conversas de sessões passadas.
• Busca totalmente local sem chaves de API.

​

Solução de problemas

​

Configuração