Busca na memória do OpenClaw

A ferramenta de busca na memória encontra notas relevantes nos arquivos de memória de um agente mesmo quando a redação difere do texto original: ela divide a memória em pequenos pedaços e os pesquisa com embeddings, palavras-chave ou ambos. Os embeddings da OpenAI são o padrão e há suporte a uma dúzia de provedores, incluindo um provedor local gerenciado que dispensa chave de API. A seguir: como uma busca é executada, o ranking que a documentação detalha, a evocação por gatilhos que roda antes de uma resposta, as regras de fallback, a memória de sessão e a lista de solução de problemas.

Provedores e os dois caminhos

• A chave provider indica um entre OpenAI, Gemini, Voyage, Mistral, Bedrock, DeepInfra, GitHub Copilot, Ollama, LM Studio, um endpoint genérico compatível com OpenAI ou local, que instala um servidor llama.cpp verificado e um pequeno modelo de embeddings de cerca de um terço de gigabyte; uma entrada de provedor personalizada também funciona quando usa um tipo de API compatível.
• Dois caminhos de recuperação rodam em paralelo e se mesclam: a busca vetorial encontra significados semelhantes, então uma consulta sobre o host do Gateway encontra uma nota sobre a máquina que roda o OpenClaw, e a busca por palavras-chave BM25 encontra termos exatos, como IDs, strings de erro e chaves de configuração. Se um dos caminhos não estiver disponível, o outro roda sozinho.
• A busca por nome de arquivo indexa os caminhos separadamente do conteúdo, então um caminho exato, um nome base ou um nome sem extensão fica à frente de correspondências parciais, enquanto os trechos continuam vindo do conteúdo das notas.
• Alguns endpoints compatíveis com OpenAI precisam de tipos de entrada assimétricos para consultas e documentos, definidos por duas chaves de configuração.

Notas antigas perdem peso no ranking aos poucos, para que as informações recentes apareçam primeiro.

O ranking

O motor integrado aplica uma fórmula determinística: relevância híbrida vezes decaimento por recência vezes um multiplicador de importância. A importância é pontuada uma única vez, quando uma entrada é escrita por um fluxo de memória que já tem um modelo no loop, e uma pontuação ausente é neutra. Notas diárias datadas decaem com meia-vida de trinta dias, então a nota do mês passado pontua com metade do peso original, enquanto os arquivos curados de memória e de usuário e os arquivos sem data continuam perenes. A documentação credita ao artigo Generative Agents o resultado de relevância, recência e importância, sem adicionar uma chamada de modelo no momento da consulta. Em seguida, uma etapa de diversidade reordena os candidatos pontuados para reduzir trechos quase idênticos, com uma configuração fixa com viés para a relevância e um conjunto limitado de candidatos, sem alterar pontuações nem chamar um provedor. As correspondências por palavra-chave são preservadas quando todos os resultados ranqueados ficam abaixo da pontuação mínima configurada, e a busca híbrida preenche as vagas restantes com resultados apenas de palavras-chave.

Evocação por gatilhos e as regras de fallback

• Em turnos interativos elegíveis, o motor compara a mensagem recebida com frases curtas de gatilho armazenadas nas entradas indexadas e pode adicionar até três entradas compactas ao contexto oculto antes da resposta; só entradas promovidas e confiáveis dos arquivos raiz de memória e de usuário se qualificam, e notas diárias, transcrições importadas e transcrições de sessão nunca são injetadas automaticamente.
• Definir o provedor como none desativa os embeddings de propósito, para uma busca apenas por palavras-chave; deixá-lo indefinido ou em auto recorre ao ranking apenas por palavras-chave quando a configuração dos embeddings ou uma requisição falha, assim como faz o provedor local, e a indexação ainda registra o texto para a busca por palavras-chave antes da primeira busca.
• Indicar explicitamente qualquer outro provedor e vê-lo falhar no momento da requisição faz a ferramenta sinalizar a memória como indisponível em vez de se degradar silenciosamente, o que mantém visível uma configuração quebrada; a correção está na configuração do provedor ou da autenticação, ou em none para uma evocação deliberadamente apenas por palavras-chave.

A memória do OpenClaw explicada explica os arquivos pesquisados, e o dreaming do OpenClaw, a varredura noturna que decide o que é promovido para eles e, portanto, o que a evocação por gatilhos pode injetar.

Memória de sessão e solução de problemas

A evocação exata em texto completo a partir de transcrições cabe à ferramenta de busca de sessões; indexar transcrições na busca na memória é opcional, ativado por uma flag experimental e uma lista de fontes, com uma opção de corpus para pesquisar apenas as notas, configurações de visibilidade cujo padrão é all e acesso entre agentes regido pela configuração de agente para agente. Imagens e áudio podem ser indexados junto com o Markdown usando um modelo de embeddings do Gemini, mas só em caminhos extras, não nas raízes de memória padrão. Quando não houver resultados, verifique o status do índice e reconstrua-o; quando só voltarem correspondências por palavra-chave, provavelmente o provedor de embeddings não está configurado, o que o status detalhado mostra; quando os embeddings locais atingirem o tempo limite, inspecione os endpoints do servidor gerenciado antes de reconstruir; e texto CJK que não é encontrado exige uma reconstrução forçada do índice. Modelos locais no OpenClaw cobre os modelos locais ao lado dos quais ficam os provedores locais, e sessões no OpenClaw, as transcrições que essa opção indexa.

Na Diali

Na Diali, a busca na memória roda com o provedor de embeddings que a sua chave de modelo oferecer e recorre ao caminho por palavras-chave descrito na documentação quando não houver nenhum; de qualquer forma, as notas ficam no espaço de trabalho persistente do assistente. OpenClaw hospedado na Diali é o assistente.

• Vetorial para o significado, BM25 para termos exatos, mesclados.
• Relevância vezes recência vezes importância; notas diárias perdem metade do peso a cada trinta dias.
• Um provedor explícito quebrado é sinalizado, nunca escondido.