ClawMem es la capa de memoria persistente que viene con Sentō. Indexa el workspace de tu agente (~/workspace/) y le da retrieval rápido sobre sus propias notas, conversaciones previas, y cualquier archivo que hayas agregado.

Sin ClawMem, tu agente arrancaría cada conversación desde cero. Con él, puede acordarse de lo que hablaron la semana pasada.

Qué se indexa

Por defecto, ClawMem indexa:

  • ~/workspace/CLAUDE.md — la identidad y reglas del agente
  • ~/workspace/memory/**/*.md — todo lo que aprendió de vos
  • Cualquier otra cosa en ~/workspace/ que el agente tenga instrucciones de recordar

No indexa .openclaw/, node_modules/, o directorios ocultos — esos están explícitamente excluidos.

Cómo funciona la búsqueda

ClawMem corre dos métodos de retrieval complementarios:

  1. BM25 — búsqueda por keywords clásica. Rápida, sin dependencias.
  2. Embeddings de Gemini (opcional) — búsqueda semántica / vectorial. Requiere una API key gratuita de Gemini (se configura en sento init o después vía sento config).

Si te saltás Gemini, tenés sólo búsqueda por keywords. Eso igual funciona bien para la mayoría de los agentes — el workspace entero suele ser decenas o cientos de archivos Markdown chicos, no un corpus.

Escribir a memoria

El agente escribe a memoria solo cuando le decís:

"acordate que prefiero respuestas concisas"

Crea o actualiza un archivo bajo ~/workspace/memory/, categorizado por tipo (perfil de usuario, feedback, contexto de proyecto, referencia). El filesystem es la memoria — sin base de datos, sin servicio remoto.

Leer memoria

En cada turno nuevo, ClawMem corre una pasada rápida de retrieval e inyecta las entradas de memoria más relevantes en el contexto del agente. El agente las ve como ve cualquier otro tool result y las puede usar en su respuesta.

Por qué no una vector DB

Tres razones:

  1. Sin costo de setup. ClawMem son unos archivos en el workspace de tu agente. Una vector DB es un servidor.
  2. Auditable. Podés leer la memoria de tu agente con cat. No hay espacio de embeddings opaco.
  3. Portable. La memoria se mueve con el agente. Cloneás el workspace a un host nuevo, la memoria va con él.

Cuándo podrías querer más

Si tu agente termina indexando miles de archivos (ej. un codebase completo), BM25 sigue andando pero la búsqueda semántica se vuelve más valiosa. Conectá Gemini para los embeddings — es gratis dentro de rate limits razonables.

Archivos

  • ~/workspace/memory/ — el árbol de memoria completo
  • ~/workspace/memory/MEMORY.md — el índice / resumen; el agente lo mantiene solo
  • Archivos Markdown por memoria con frontmatter declarando type: user | feedback | project | reference