Pular para conteúdo

Search Memory

Search Memory é a busca interna da memória do bot. Ela serve para encontrar informações salvas nos arquivos Markdown, mesmo quando você não lembra a palavra exata.


Em linguagem simples

É como pesquisar no caderno do bot, mas com entendimento de significado.

Você pode pedir:

"Busca o que sabemos sobre o projeto X"

"O que ficou decidido sobre a rotina de segunda?"

"Procura na memória algo sobre esse cliente"

O bot procura nos arquivos de memória e traz o que for mais relevante.


O que ele busca

Normalmente, a busca cobre:

  • MEMORY.md
  • arquivos dentro de memory/
  • perfis de pessoas
  • notas de projetos
  • protocolos
  • notas diárias
  • outros arquivos Markdown de memória configurados

Ela não substitui o histórico bruto de mensagens. Se você quer uma frase exata que alguém mandou, peça para buscar no histórico de conversa.


Como funciona por baixo dos panos

A instalação padrão usa o memory-core com índice local em SQLite.

Índice local típico: ~/.openclaw/memory/main.sqlite — o nome pode variar por agente/instalação.

Ele combina:

  • FTS/BM25 — busca textual por palavras
  • vetores semânticos — busca por significado
  • sqlite-vec — armazenamento/consulta vetorial local quando disponível
  • embeddings — normalmente text-embedding-3-small, dependendo da configuração

O comando técnico mais comum para diagnóstico é:

openclaw memory status --deep

Usuário final não precisa rodar isso. É só para administrador ou suporte.


Quando pedir Search Memory

Use quando:

  • o assunto já foi discutido antes
  • você quer retomar uma decisão antiga
  • o bot parece não lembrar algo importante
  • você quer checar preferências, contexto ou projeto salvo

Exemplo bom:

"Busca na memória o que combinamos sobre os relatórios da Alfa Tech"


Quando não basta

Search Memory trabalha com memória consolidada. Para coisas literais, recentes ou com prova exata, o bot pode precisar buscar o histórico bruto ou a fonte real.

Exemplos:

  • quem disse uma frase específica
  • horário exato de uma mensagem
  • preço atual
  • status atual de um sistema
  • dado financeiro ou operacional que muda com frequência

Nesses casos, peça:

"Confere na fonte"

"Busca no histórico literal"