Cómo personalizar tu agente con identity, soul y agents

Platzi DayPlatzi Day

Todos los cursos GRATIS

Se acaba en:
:::

Resumen

Configurar la identidad de tu agente de AI es lo que transforma un asistente genérico en uno que trabaja exactamente como tú necesitas. Aquí aprendes a ajustar el comportamiento, el tono y la memoria de tu agente en OpenClaw a través de cuatro archivos clave: identity, user, soul y agents. Es ideal si ya tienes tu agente corriendo y quieres personalizarlo.

Dónde viven los archivos que definen a tu agente

Antes de personalizar nada, necesitas encontrar los archivos. Y aquí hay un detalle según tu sistema operativo.

Tanto en Linux, Windows como Mac, los archivos están en tu carpeta de usuario. La diferencia es que en Mac y Linux están ocultos.

  • En Mac presionas Command-Shift-Punto para mostrarlos.
  • En Linux vas a las opciones del navegador de archivos y eliges mostrar archivos ocultos.
  • En Windows la carpeta está siempre visible.

Una vez visibles, busca la carpeta .openclaw. Dentro, todo lo relativo a tu agente vive en la carpeta workspace, que es el espacio donde tu agente guarda archivos y almacena todo lo que define su identidad y comportamiento [00:55].

¿Qué es la carpeta workspace en OpenClaw? Es el espacio dentro de .openclaw donde tu agente guarda archivos y almacena todos los documentos que definen su identidad y su comportamiento.

Qué hace el archivo identity y por qué debe ser ligero

El primer archivo es identity.md, escrito en Markdown, un formato que básicamente es texto plano [01:32]. Piénsalo como la tarjeta de presentación de tu agente.

Aquí es clave mantenerlo muy ligero, solo un par de líneas. Dentro encuentras:

  • Name: el nombre del asistente, en el ejemplo Moneta.
  • Creature: una descripción breve de qué tipo de asistente es, como un compañero para un second brain.
  • Vibe: define el tono de comunicación, por ejemplo thoughtful, organized, proactive, but not pushy.
  • Emoji: funciona como la firma de tu agente.

Si quieres asignarle un avatar, lo colocas en la carpeta avatars/ con el nombre indicado. En el ejemplo se agregó una línea simple: "Responde siempre en español" [02:22].

Cómo darle contexto sobre ti en user.md

El archivo user.md se trata de ti, no del agente [02:32]. Aquí defines cómo quieres que te hable y qué debe saber sobre tu vida.

Incluye tu nombre, cómo quieres que te diga, tus pronombres, tu zona horaria y notas de contexto sobre tus objetivos. En el ejemplo se agregó ser director del departamento de data de Platzi, además de pasatiempos como correr y el objetivo de fabricar un tambor a mano [02:55].

Mismo consejo que antes: mantenlo lo más ligero posible.

Cómo definir los principios de tu agente con soul

Si identity define quién es, soul define sus principios y reglas de operación principales [03:16]. Este archivo es superimportante y vale la pena leerlo con detenimiento, porque puedes modificar lo que no te convenza.

Viene bastante genérico de OpenClaw y siempre tiene las mismas secciones:

  • Core truths: principios fundamentales, como ser genuinamente útil y no solo performativo, tener permiso de opinar y resolver antes de preguntar.
  • Boundaries: límites que ajustas a lo que te deje más tranquilo, por ejemplo evitar que toque ciertos archivos.
  • Vibe y estilo: detalla el tono, qué tan proactivo debe ser y el lenguaje.
  • Communication: indica qué canales están activos para que los use.

Hay una nota crítica sobre continuidad: cada sesión empieza completamente en blanco y estos archivos son la única memoria del agente [04:47]. Si algo no está escrito, no lo va a recordar.

¿Por qué mi agente de AI olvida las conversaciones? Porque cada sesión arranca en blanco. Los archivos como soul, identity y user son su única memoria, así que todo lo que no escribas ahí se pierde.

Un tip valioso: escribe instrucciones directas, no genéricas. En lugar de "sé asertivo", el ejemplo dice "avísame si estoy por hacer algo tonto, como saltarme el ejercicio tres días seguidos" [05:20].

Por qué conviene revisar el soul.md con el tiempo

La intención del creador de OpenClaw era que el agente fuera modificando su propio soul.md conforme pasa el tiempo [05:41]. Es una forma de que aprenda de la interacción contigo.

De vez en cuando pregúntale directamente: "¿Has modificado tu soul.md con algún aprendizaje que hayas tenido?" Esa simple conversación ayuda a que tu agente se adapte a tu forma de trabajar.

Qué contiene agents.md y cómo usa la memoria tu agente

Si el soul son los principios generales, agents.md es el manual que le dice cómo comportarse exactamente [05:58]. Trae instrucciones de fábrica que conviene no eliminar salvo que estés seguro.

Por ejemplo, la instrucción session startup le indica que cada vez que arranca una sesión debe leer estos archivos. Más adelante este archivo servirá para explicarle a tu agente cómo usar el second brain.

Para que los cambios tomen efecto, necesitas iniciar una nueva sesión con el comando /new [06:47]. Después puedes verificar preguntándole qué sabe sobre ti, y responderá con los datos que registraste, como ser director de data en Platzi.

¿Qué es una sesión en OpenClaw? Es cada conversación con tu agente. Al iniciarla, lee sus archivos y los envía al proveedor de LLM como Claude u OpenAI, lo que modifica su comportamiento durante toda esa conversación.

Aquí viene lo interesante del ciclo de memoria: cada día, alrededor de las 3:00 a.m., tu agente cierra la sesión actual e inicia una fresca partiendo de esos archivos [07:34]. Por eso todo lo que quieras que recuerde de forma consistente debe vivir en identity, user, soul y agents.

¿Cómo has configurado la personalidad de tu agente? Cuéntame en los comentarios qué instrucciones directas le diste en su soul.