Hay una razón por la que tu agente OpenClaw no para de olvidar cosas. No está roto. Es que no tiene memoria integrada como ChatGPT o Claude. Esos productos te recuerdan automáticamente. Conveniente. También una caja negra.
(En serio, mirá lo que ChatGPT "recordó" sobre vos. Está descontrolado.)
OpenClaw no funciona así. Es un framework de agente de código abierto que corre localmente en tu máquina. Sin memoria incorporada. Sin magia. Cuando empezás una nueva sesión, se despierta con amnesia total.
Eso suena como una desventaja hasta que te das cuenta de que vos podés construir el sistema de memoria. Decidís exactamente qué recuerda, dónde se guarda, cómo se organiza, y quién puede acceder. Sin misterios. Sin momentos de "¿por qué piensa que vivo en Denver?".
El tradeoff es que tenés que configurarlo. Pero una vez que lo hacés, no tenés un asistente de IA. Tenés un empleado de IA.
Un asistente responde preguntas. Un empleado conoce tu negocio, recuerda tus decisiones, aprende de los errores, y nunca repite el mismo error dos veces.
Así es cómo construir eso.
Tu empleado de IA necesita 5 archivos de texto plano. Eso es todo. Estos archivos reemplazan meses de onboarding. La IA los lee al inicio de cada sesión, así nunca olvida quién es ni cómo trabajás.
Este es el archivo más importante. Define la personalidad, voz y límites de tu IA.
Si viste Suits, conocés a Donna Paulsen. No es la asistente de Harvey Specter. Es la persona que hace posible a Harvey Specter. Sabe lo que él necesita antes de que lo pida. Maneja problemas antes de que lleguen a su escritorio. Le dice cuando está equivocado, y ella casi nunca se equivoca.
Eso es lo que estás construyendo acá. Tu SOUL.md es el manual operativo de Donna.
La sección "NOT" importa más que la sección "IS". Cada vez que la IA hace algo que te molesta, agregalo acá. Mi primera versión era media página. Después de una semana de correcciones, eran dos páginas. Después de un mes, los comportamientos molestos se detuvieron casi completamente.
No estás describiendo un chatbot. Estás describiendo a Donna. ¿Qué haría ella realmente? Escribilo.
También pongo límites de seguridad en SOUL.md:
Porque una gran asistente también sabe qué NO hacer.
Harvey no llama a Donna "mi asistente". Ella tiene un nombre, un título, y un rol claro. Tu IA necesita lo mismo.
Esto no es relleno. Una IA con un rol definido toma mejores decisiones. "Gerenta de Operaciones que maneja operaciones" es accionable. "Asistente útil" no lo es.
Dale un nombre. "Donna, ¿chequeaste los reportes?" crea responsabilidad que "IA, chequeame algo" nunca va a crear.
Donna sabe todo sobre Harvey. Cómo toma el café. Cuándo está blefando. Qué lo hace estallar. Tu IA necesita ese mismo contexto.
USER.md es cómo le decís al agente para quién trabaja.
Obviamente reemplazarías a Harvey con vos mismo. Pero captás la idea. Esto evita que la IA te trate como un usuario genérico. Conoce tu estilo de comunicación, tus prioridades, y qué te molesta. Deja de actuar en modo asistente genérico y empieza a trabajar de la forma que vos realmente trabajás.
Cada herramienta, API key, y capacidad que la IA puede usar. Pensalo como el recorrido del stack tecnológico que le darías a un nuevo empleado el primer día.
La parte más importante de TOOLS.md no es qué funciona. Es qué NO funciona, y cómo manejarlo correctamente.
Mi agente seguía intentando hacer scraping de links de Twitter. No funciona. Twitter lo bloquea. Le dije al agente tres veces. Seguía intentando. Así que agregué:
"Nunca volvió a pasar."
Lo mismo con videos de TikTok. El agente dijo que no podía extraerlos. Yo dije "averigualo." Construyó un pipeline: yt-dlp para descargar el video, ffmpeg para extraer el audio, Whisper para transcribir. Ahora TOOLS.md dice:
"Cinco minutos escribiendo una regla te ahorra 100 correcciones futuras. Igual que escribir documentos de capacitación para un empleado humano."
La regla al inicio de mi TOOLS.md:
"Porque la mitad de las veces que el agente dice 'no tengo acceso a X', las credenciales están ahí mismo en el archivo."
Esto es donde todo se.compulsa. MEMORY.md es el entendimiento a largo plazo de la IA sobre cómo operás. No datos sobre el mundo. Datos sobre tu negocio, tus preferencias, tus decisiones.
Ejemplo:
Cuando mencionás "el proyecto de la app", el agente ya sabe el stack tecnológico, la versión actual, y qué está bloqueando el próximo lanzamiento.
Eso es conocimiento institucional que se construye automáticamente.
La IA mantiene esto por sí misma. Revisa conversaciones, extrae lo que importa, y actualiza MEMORY.md. También mantengo notas diarias, un archivo markdown por día en una carpeta de memoria. La IA registra qué pasó, qué decisiones se tomaron, qué aprendió. Periódicamente revisa sus propias notas y distila lo importante en MEMORY.md.
Para el mes 3, tu IA tiene más contexto operacional que la mayoría de los empleados humanos en su primer año. Y nunca olvida nada de eso.
Nota de seguridad: MEMORY.md solo se carga en conversaciones directas con vos. No en grupos. No en canales compartidos. Contiene contexto personal que no debería filtrarse a extraños.
(la magia real)
Este es el manual de instrucciones. Lo primero que el agente lee cada sesión.
Cada vez que el agente comete un error, no solo lo corregís en el chat. Escribís la corrección en AGENTS.md para que nunca más vuelva a pasar.
Estás tratando con Drew Barrymore en 50 First Dates acá, no se puede confiar en que recuerde nada.
El agente decía "lo voy a recordar para la próxima." Próxima sesión: amnesia total.
Ahora cuando digo "recordá esto", el agente lo escribe en un archivo en el acto.
Sub-agentes de código clonaban repos a ~/Desktop, ~/Projects, carpetas random. La máquina se llenaba de copias obsoletas.
La solución:
"Nunca volvió a pasar."
Los procesos en segundo plano mueren cuando el sistema se reinicia. Volvía al trabajo a medio terminar sin forma de retomar.
La solución:
"Ahora los agentes largos sobreviven a reinicios."
Mandaba screenshots por iMessage. El agente decía "no puedo ver imágenes en este contexto." Yo decía "averigualo." Se disculpaba y me pedía describir la imagen. Así que dije "no, literalmente averigualo cómo ver imágenes." Investigó la integración, descubrió cómo procesarlas, y ahora maneja screenshots automáticamente.
Esa interacción me enseñó lo más importante sobre entrenar una IA: la frase "averigualo" es más valiosa que una instrucción detallada. Si le decís la respuesta a la IA, aprende la respuesta. Si le decís que averigue, aprende cómo resolver problemas.
Agentes de código seguían usando flags de comandos incorrectos. Flags que no existen o hacen lo opuesto de lo que esperaban.
La solución: documentar la sintaxis correcta exacta.
Pararon de adivinar. Empezaron a trabajar.
Acá está el patrón: cada vez que te catchás pensando "te lo dije antes", ese es la señal para agregarlo a AGENTS.md.
Los 5 archivos le dan a tu agente memoria y personalidad. Los Skills le dan habilidades.
Skills son conjuntos de instrucciones plug-and-play que le enseñan al agente cómo hacer trabajos específicos. Viven en una carpeta de skills y el agente los carga cuando los necesita.
Pensalo así: Donna sabe cómo trabaja Harvey (eso son los 5 archivos). Pero también sabe cómo manejar el calendario, redactar briefs legales, y manejar intake de clientes (esos son skills).
Acá hay un ejemplo real. Tengo un agente redactor de contenido llamado Rory. La carpeta de skills de Rory incluye:
Cada skill es solo un archivo markdown con instrucciones. Cuando la tarea matchea, el agente lee el skill y lo sigue. Cuando no matchea, el skill permanece sin cargar. Sin bloat.
Podés escribir tus propios skills o instalar community ones desde ClawdHub. Hay skills para browser automation, Google Workspace, Slack, GitHub, analytics, ad platforms, y cientos más.
Es como la escena de Matrix donde a Neo le suben kung fu directamente al cerebro. Tu agente no sabe cómo escribir secuencias de email hasta que carga el skill email-sequence, y entonces simplemente... lo hace.
Skills le dan los playbooks para ejecutar realmente. Juntos, tenés un agente que sabe lo que vos querés Y sabe cómo hacerlo.
Eso es todo. Acá está el sistema completo:
Escribí SOUL.md esta noche. Dale un nombre. Empezá con lo que te molesta. Ese es el camino más rápido a un agente que realmente te gusta usar.
Si enfrentar una SOUL.md en blanco te siente overwhelming, pegalo en Claude (o cualquier IA). Te va a entrevistar y generar tus archivos starter.
Pegalo ahí. Respondé las preguntas, andá a caminar y hacé un voice memo o usá WisprFlow. Vas a tener tus 5 archivos en unos 10 minutos.
Si querés ir más a fondo en construir tu equipo de agentes, unime en founder.codes. Es donde voy a compartir configs, skills, y qué está realmente funcionando en mi negocio.
Escribí SOUL.md esta noche. Dale un nombre. Empezá con lo que te molesta. Ese es el camino más rápido a un agente que realmente te gusta usar.