O Caminho Rápido de Busca de Memória QMD do OpenClaw Tinha Bugs Silenciosos

A busca de memória integrada do OpenClaw usa correspondência básica de palavras-chave, que funciona para consultas simples, mas tem dificuldade quando os agentes precisam encontrar informações aprendidas semanas antes sem correspondências exatas de palavras.

Os usuários podem alternar para o QMD, que realiza busca semântica em todos os arquivos markdown do espaço de trabalho. Isso permite que os agentes encontrem entradas relevantes mesmo quando as palavras-chave exatas não estão presentes. O QMD também faz busca híbrida, combinando abordagens de palavras-chave e semânticas para precisão e recuperação.

O OpenClaw tem um caminho rápido através do MCPorter que mantém o processo QMD ativo na memória, reduzindo os tempos de busca para 1-2 segundos em vez de 9-25 segundos quando iniciado a frio cada vez.

Este caminho rápido estava completamente quebrado com três bugs no mesmo arquivo:

• O gateway estava chamando nomes de ferramentas que não existem. O servidor MCP do QMD expõe uma ferramenta chamada query, mas o gateway estava chamando deep_search, search, etc. Cada chamada retornava código de saída 128.
• Formato de argumento errado. O gateway passou uma string plana, mas a ferramenta espera um array searches com subconsultas tipadas para busca por palavra-chave vs semântica vs híbrida.
• Incompatibilidade singular vs plural. O gateway passou collection: "name" mas a ferramenta espera collections: ["name"].

Cada parâmetro estava errado: nome da ferramenta, estrutura do argumento e nome do campo. A correção foi direta uma vez identificada, e uma pull request está disponível para qualquer pessoa executando QMD através do MCPorter.

A falha silenciosa significava que cada chamada retornava ao caminho mais lento da CLI, mas a funcionalidade permanecia, apenas com desempenho significativamente degradado que passou despercebido por semanas.