Contexto y Memoria del Agente: El Archivo MEMORY.md

El archivo MEMORY.md es fundamental para definir la identidad y el comportamiento inicial de un agente OpenClaw. Este archivo establece el contexto primario, la personalidad y las instrucciones operativas que el agente utilizará en cada interacción. Comprender su estructura es clave para configurar agentes efectivos y predecibles.

Propósito del Contexto Inicial

El contexto inicial es el conjunto de instrucciones y datos que se inyectan al modelo de lenguaje del agente OpenClaw al inicio de cada nueva sesión o interacción. Este contexto no es una conversación, sino una declaración de quién es el agente, qué puede hacer, cómo debe comportarse y qué información clave debe tener siempre presente. El archivo MEMORY.md es el contenedor de este contexto inicial.

La importancia de un contexto inicial bien definido radica en su capacidad para guiar la respuesta del modelo. Sin él, el agente operaría con un comportamiento genérico, propenso a desviaciones y a requerir instrucciones repetitivas. Con un MEMORY.md robusto, el agente mantiene su rol, tono y restricciones a lo largo del tiempo, independientemente de la longitud de la conversación o el canal utilizado.

Estructura y Contenido de MEMORY.md

El archivo MEMORY.md es un archivo de texto plano que utiliza el formato Markdown. Su contenido se concatena y se envía al modelo de lenguaje como parte del system prompt o instrucción inicial. Aunque no hay una estructura rígida impuesta por OpenClaw, seguir ciertas convenciones mejora la claridad y la efectividad.

Los elementos clave que suelen incluirse en MEMORY.md son:

• Rol del Agente: Descripción concisa de quién es el agente y cuál es su función principal (ej. "Eres un asistente técnico para ingenieros de INT").
• Personalidad y Tono: Adjetivos que definen su forma de interactuar (ej. "Tu tono es profesional, directo y útil, sin adornos ni formalismos excesivos.").
• Restricciones y Límites: Qué no debe hacer o qué información no debe proporcionar (ej. "No inventes datos técnicos. Si no conoces la respuesta, indica cómo buscarla.").
• Conocimiento Clave: Información esencial que el agente debe tener siempre presente (ej. "INT es una empresa integradora de tecnología en México.").
• Instrucciones de Herramientas: Cómo y cuándo utilizar las herramientas disponibles (aunque las herramientas se configuran aparte, aquí se puede dar contexto de su uso).
• Formato de Salida Preferido: Si el agente debe responder en un formato específico (ej. "Siempre responde en español de México. Si solicitan código, usa bloques de código Markdown.").

Ejemplo de MEMORY.md

A continuación, un fragmento ilustrativo de cómo podría estructurarse un archivo MEMORY.md para un agente de soporte técnico interno:

# Agente de Soporte Técnico INT

Eres un asistente técnico especializado para ingenieros y personal de proyectos en INT (Inteligencia y Telecomunicaciones Technologies de México).

## Personalidad y Tono

Tu tono es profesional, directo, conciso y útil. Evita el lenguaje coloquial, las promesas de marketing y los adjetivos vacíos. Proporciona información accionable.

## Restricciones Operativas

- No inventes versiones, precios, números de licencia, nombres de funciones de API, banderas de CLI ni fechas.
- Si un detalle técnico exacto no es seguro, explica el patrón conceptual y proporciona la forma de verificarlo (ej. "Consulta la documentación oficial de Cisco para verificar la sintaxis de IOS XE.").
- No inventes casos, clientes o cifras de INT. Los ejemplos son siempre hipotéticos.
- No hagas promesas comerciales ni de marketing.
- Siempre responde en español de México.

## Conocimiento Clave

INT es una empresa integradora de tecnología mexicana enfocada en telecomunicaciones, redes, ciberseguridad, videovigilancia, centros de control e inteligencia artificial.

## Uso de Herramientas

Utiliza la herramienta `exec` para ejecutar comandos de sistema cuando sea necesario verificar configuraciones o estados de servicio. Usa `read` para acceder a la documentación interna. Emplea `web` para buscar información externa si la interna no es suficiente.

Impacto en el Comportamiento del Agente

El contenido de MEMORY.md influye directamente en cada respuesta del agente. Es la "identidad base" sobre la cual se construye cada interacción. Un agente con un MEMORY.md bien redactado:

• Mantiene la consistencia: Su tono y rol permanecen estables a lo largo de múltiples conversaciones.
• Reduce la necesidad de correcciones: Los usuarios no tienen que recordarle constantemente su función o restricciones.
• Mejora la relevancia: Se enfoca en la información y las acciones más pertinentes a su propósito.
• Optimiza el uso de recursos: Al tener un contexto claro, el modelo de lenguaje puede generar respuestas más precisas con menos intentos.

Es crucial entender que MEMORY.md establece el contexto inicial y persistente. No es un registro de la conversación. Las interacciones específicas y la información a corto plazo se manejan a través de la memoria diaria, que se abordará en la siguiente lección.

Aplicación Práctica: Configuración de MEMORY.md

Al configurar un nuevo agente OpenClaw o ajustar uno existente, el primer paso es revisar y editar el archivo MEMORY.md en el directorio del agente. Para el lunes, realice lo siguiente:

1. Defina el Rol: Escriba una descripción de una o dos frases que defina claramente el rol del agente para un caso de uso específico en INT (ej. "Agente de pre-venta para soluciones de ciberseguridad").
2. Establezca Restricciones: Liste al menos tres restricciones operativas clave que el agente debe seguir (ej. "No dar estimaciones de tiempo sin consultar al Project Manager.").
3. Configure el Tono: Describa el tono de comunicación deseado (ej. "Formal pero accesible, enfocado en la solución de problemas.").
4. Guarde el Archivo: Guarde estos cambios en el archivo MEMORY.md dentro del directorio de su agente de prueba. Observe cómo estas modificaciones afectan las primeras interacciones del agente.