OpenClaw Memória QMD: Captar Fallback Silencioso

A resposta segura é: não tratar uma busca de memória bem sucedida de OpenClaw como prova de que QMD é saudável . Primeiro provem que o gateway pode resolver o binário QMD e que o QMD não foi o fallback construído que serviu à busca. Em seguida, aplique as verificações de prontidão exigidas pelo modo de pesquisa configurado, confirme que o índice é fresco e retira um canário sintético. Essa distinção é importante porque o OpenClaw volta deliberadamente ao seu motor de memória embuilt se o QMD falhar. O fallback preserva o comportamento útil da memória, mas muda o fato a ser testado. Um resultado pode ser válido como OpenClaw encontrou uma memória enquanto sendo inválido como o backend QMD configurado está pronto. A regra de funcionamento deste guia é: O QMD só é saudável quando a disponibilidade executável, o backend eficaz, a frescura da atualização, a prontidão específica do modo e a recuperação de canários concordarem. Isto é mais estreito do que provar que um agente se lembrava da coisa certa em todas as situações. Trata se de um recibo de saúde backend: prova de que o caminho de recuperação previsto está disponível e atual o suficiente para a próxima etapa dependente da memória. Uma consulta verde pode esconder o backend errado O Documentação QMD da OpenClaw descreve o QMD como um sidecar local primeiro que combina BM25, pesquisa de vetores e re ranqueamento. O OpenClaw cria colecções gerenciadas, executa atualizações e, quando os modos semânticos exigem isso, mantém as incorporações. Também documenta a queda automática do motor SQLite quando o QMD não pode abrir. O retrocesso é uma característica de disponibilidade sensata. Não é evidência da QMD. Considere duas corridas que ambas recuperam a mesma frase sintética: Observação Correr A Correr B Endos de fundo configurados qmd qmd Query retorna o canário Sim, sim. Sim, sim. Eficácia do backend qmd builtin Veredicto da QMD candidato saudável atividade de retorno O texto devolvido não pode distinguir essas corridas. A identidade do backend deve ter maior prioridade do que o sucesso da recuperação. Comece no ambiente que realmente lança o gateway. Uma concha interativa pode ter um PATH diferente de um serviço: O primeiro comando deve resolver um executável. O segundo grava uma versão. O terceiro pede que o OpenClaw sonde o estado da memória em vez de confiar em uma falha de conversão em cache. Se o qmd version funcionar apenas no seu shell de login, a orientação oficial de resolução de problemas recomenda colocar um memory.qmd.command absoluto e verificar novamente a partir do ambiente do gateway. Não registar todo o ambiente de serviço para provar isso. Um recibo útil requer apenas: A versão acima é um exemplo do inquérito de pesquisa atual, não um requisito mínimo. A última versão do QMD GitHub observada para este artigo foi V2.5.3, publicada em 29 de maio de 2026. O OpenClaw mantém caminhos de compatibilidade para as formas mais antigas de coleção QMD e MCP, por isso not latest não é automaticamente unhealthy. Gravar a versão porque os campos de compatibilidade, diagnóstico e saída mudam. No corredor de publicações usado para este artigo, OpenClaw 2026.7.1 2 foi instalado e seu armazenamento de memória de construção configurado foi relatado pronto, enquanto qmd version retornou command not found . Não foi um teste de interrupção do QMD. O corredor não foi configurado como uma implantação do QMD. Foi uma observação de fronteira útil: um comando de memória OpenClaw saudável e a disponibilidade de QMD são fatos separados. Preparação depende do searchMode A QMD dispõe de três modos de pesquisa relevantes no contrato atual OpenClaw: O search é o léxico BM25. O vsearch utiliza evidências vetoriais. O query utiliza o caminho híbrido/modelo apoiado e pode incluir a re ranqueação. O Referência de configuração de memória é explícito que o search é apenas BM25. A OpenClaw não realiza as sondas semânticas de prontidão de vetores e não integra a manutenção nesse modo. Portanto, uma regra geral, como embedings pendentes significa que a memória é insalubre é errada. Use esta porta de modo consciente: Modo de pesquisa Requisitos de recolha fresca Requisitos de inserção em espera zero Canário requerido search Sim, sim. Não Sim, sim. vsearch Sim, sim. Sim, sim. Sim, sim. query Sim, sim. Sim, sim. Sim, sim. Este não é um argumento para a pesquisa léxica sobre a pesquisa semântica. Impede que um verificador de saúde imponha uma dependência que o modo selecionado não utiliza. O intervalo de atualização QMD padrão documentado do OpenClaw é de cinco minutos, enquanto o intervalo de incorporação é padrão para sessenta minutos. Esses valores descrevem a programação, não um limiar universal de saúde. Construir um contrato de locação de frescura a partir da sua configuração e tolerância operacional: Por exemplo, um intervalo de cinco minutos, uma atualização normal de noventa e dois segundos e uma margem de trinta e dois segundos dão um contrato de arrendamento de sete minutos. Uma idade de actualização de 421 segundos está obsoleta sob essa política; 419 segundos ainda estão dentro do contrato de locação. Não alargue silenciosamente o contrato de locação após um alerta. Se as atualizações ultrapassarem regularmente esse limite, fique a carga de trabalho ou revise a política com evidências registadas. Caso contrário, um índice obsoleto torna se permanentemente verde. A primeira consulta semântica pode ser inusualmente lenta porque a QMD pode baixar aproximadamente 2 GB de modelos GGUF para expansão e re ranqueamento da consulta. Isso faz com que a espera para a dependência documentada da primeira corrida seja diferente da permanência. Coloque uma instalação limitada ou uma janela de aquecimento em torno da primeira sonda, e, em seguida, precise evidência de progresso ou parada. Construir um canário que prova o caminho gerenciado Um canário deve ser sintético, único e seguro de conservar. Não deve conter um facto do cliente, um prompt, uma chave API, um endereço de e mail ou uma decisão de tarefa real. Criar um arquivo Markdown sob uma coleção que OpenClaw realmente gerenciapara a coleção padrão de espaço de trabalho, isto é, MEMORY.md ou a árvore memory/ . Use um token como: Registre o seu caminho de fonte relativo e hash de conteúdo, permita que o ciclo de atualização configurado seja concluído, em seguida, procure o token exato através do OpenClaw: O recibo deve estabelecer: 1. O arquivo de origem pertence à coleção gerenciada prevista; 2. A última atualização bem sucedida está incluída no contrato de locação de frescura; 3. Os vetores semânticos estão prontos se o modo precisar deles; 4. O backend efetivo é o QMD; 5. O canário exato é devolvido da fonte esperada. Um resultado vazio não prova imediatamente que a QMD está quebrada. O contrato oficial nomeia várias explicações mais estreitas: os caminhos ocultos são ignorados, a raiz de minúscula memory.md não é a mesma que a MEMORY.md , o escopo de grupo/canais é negado por padrão e padrões de caminhos extras podem excluir um arquivo. Preserva essas distinções para que a reparação permaneça limitada. Evite invocar manualmente o qmd update com diretórios XDG arbitrários. A OpenClaw dá a cada agente uma casa QMD controlada por si mesma. Um comando direto no ambiente errado pode testar um índice diferente e produzir um resultado verde convincente, mas irrelevante. Da mesma forma, não use um canário bem sucedido para reivindicar uma ampla qualidade de recordação. O canário prova que um documento conhecido cruzou o caminho atual de ingestão e recuperação. Uma referência representativa de recall, o teste de continuidade de decisão e a verificação dos resultados a jusante permanecem separados. Repete o veredicto antes de enviar um alerta O artefato criado para este artigo aceita um recibo normalizado JSON e retorna um estado. A sua prioridade é intencional: 1. config drift 2. qmd unavailable 3. fallback active 4. stale index 5. vector not ready 6. retrieval failed 7. healthy Aqui está a decisão central: A repetição de seis casos produziu seis veredictos esperados: Caso Evidências importantes O veredicto BM25 com 27 incorporadores pendentes modo é search , canário encontrado healthy QMD binário faltando comando não resolvido qmd unavailable Canário encontrado através de construção backend eficaz é construído fallback active Idade de cobrança 721s, aluguer 420s atualização obsoleta stale index Modo de consulta com 14 inserções pendentes Vectores incompletos vector not ready Modo vetorial fresco, sem canário Retorno ausente retrieval failed Esta repetição adiciona dois controles úteis. Em primeiro lugar, o builtin fallback não pode emprestar um resultado verde da camada de recuperação. Em segundo lugar, a pesquisa BM25 não herda uma falsa dependência da manutenção de vetores. Cada estado não saudável recebe uma ação seguinte: QMD indisponível: Resolver o binário do ambiente do gateway e sondar novamente. Fallback ativo: inspecionar a falha aberta do QMD; não desativar a falha apenas para tornar o compressor vermelho. Stale index: esperar ou executar o caminho de atualização gerenciada, em seguida, verificar um novo tempo de sucesso. Vectors não prontos: acabamento de incorporação para o modelo ativo e verificação da consistência das impressões digitais com os diagnósticos QMD atuais. Retrieval falhou: inspecione o escopo de coleta, padrão de arquivo, evidências de atualização e token exato antes de reconstruir qualquer coisa. Reconstruir todos os índices não é a reparação padrão. Aumenta o custo e destrói evidências que poderiam distinguir um erro de caminho de um erro de frescura. Expirar o recibo e manter a conclusão estreita Um recibo saudável é limitado por tempo. Armazenar o tempo de verificação, o modo configurado, a versão QMD, o backend efetivo, a última atualização bem sucedida, a contagem pendente de vetores, quando aplicável, o hash da fonte canária e o veredicto. Expirar quando o contrato de locação de frescura terminar ou qualquer uma dessas entradas mudar. O recibo prova: O executável QMD previsto foi acessível; O OpenClaw estava a utilizar o QMD no momento do controlo; O índice gerido foi suficientemente fresco; As dependências do modo selecionado estiveram prontas; um item seguro conhecido era recuperável. A Xnot prova que cada memória é relevante, que cada decisão sobreviveu à compactação, que os dados privados são corretamente classificados ou que um agente produziu o produto pretendido. Aqueles precisam de provas separadas. A direção do produto da Sidewisp é tornar os limites de saúde como estes visíveis nos tempos de execução dos agentes: identificar o que está funcionando, expor as evidências, distinguir a espera do fracasso e preservar a autoridade humana sobre as reparações. A Sidewisp está atualmente em prévia privada. O adaptador de produção OpenClaw e o motor de monitorização não são geralmente enviados, por isso este guia é um padrão operacional que pode ser implementado hojenão é uma alegação de que o Sidewisp já realiza essas verificações QMD. Se uma tarefa dependente da memória for importante, solicite o recibo antes do início da tarefa e verifique o resultado real da tarefa depois. Isso fecha ambas as lacunas falsas e verdes: a memória funcionou sem QMD e a QMD funcionou sem o trabalho ser feito.