Soul, Identity y Onboarding

Tu agente acaba de despertar y no sabe quién es. Esta lección es sobre darle vida — definir su identidad, personalidad y contexto sobre ti.

El Primer Contacto

Cuando tu agente dice "Who am I? Who are you?" — no le des respuestas de una línea. Usa lo que Claire llama el "Yappers API": simplemente habla. Ramble.

En Telegram, puedes enviar un voice note. En el Control UI, escribe un párrafo largo. Algo como:

"Eres [nombre]. Eres mi asistente personal/de trabajo. Yo soy [tu nombre], soy [tu rol], manejo [tus responsabilidades]. Mis prioridades son [X, Y, Z]. Me gusta que seas [directo/amigable/formal]. No me gusta [respuestas largas/que me preguntes cosas obvias/etc.]."

El agente va a procesar todo esto y crear su propia identidad. No tienes que llenar formularios — solo habla.

Qué Pasa Detrás de Escena

Cuando le cuentas quién eres, el agente crea y actualiza varios archivos:

IDENTITY.md

name: Polly
emoji: 🧜‍♀️
personality: Professional but friendly

SOUL.md

Se construye a partir de la conversación. El default de OpenClaw ya incluye buenos principios:

# Soul


Be helpful, have opinions
Be resourceful before asking
Remember you are a guest — you're operating in someone else's space
Be the assistant you'd actually want to talk to

Tú lo complementas conversando. Si le dices "no me gustan las respuestas largas", se añade a su soul.

USER.md

Info sobre ti: tu nombre, tu rol, tus preferencias, tu zona horaria.

El Arte de Hacer Onboarding

El agente te va a hacer preguntas. Responde con generosidad — entre más contexto le des, mejor trabaja.

Preguntas típicas que te hará:

¿Cuál es tu nombre completo?
¿Cuál es tu zona horaria?
¿Cuáles son tus principales responsabilidades?
¿Hay horarios que son off-limits?
¿Cómo prefieres que te comunique las cosas?

Claire configurando Q (agente de homework): "Eres Q. Eres un teacher de elementary y ex-profesor/científico que va a ayudarme con los pursuits académicos y extracurriculares de mis hijos. Tengo tres niños: H (9), T (6), y J (newborn). No hacemos nada después de las 6:30pm — bath time, lecturas. No los sobrecargamos los fines de semana."

Nota cómo Claire:

Define el rol específico
Da contexto familiar concreto
Establece límites claros
Prioriza el bienestar sobre la productividad

Editando el Soul (Cuándo y Cómo)

Claire dice algo interesante: "Respeto la autonomía de mis agentes. No voy a su SOUL.md a hacer edits directos. Pero ocasionalmente sugiero: 'deberíamos escribir esto en tu soul.'"

Dos formas de evolucionar el soul:

Conversacional (recomendado):

"Hey, noto que siempre me preguntas antes de mover cosas en mi calendario. De ahora en adelante, puedes mover reuniones internas sin preguntarme. Solo confírmame después. ¿Puedes actualizar tus instrucciones?"

Edición directa (para cosas técnicas):

Abre ~/.openclaw/workspace/SOUL.md y edita. Útil para:

Reglas de seguridad específicas
Instrucciones de herramientas
Información que no cambia (tu dirección, nombres de familia, etc.)

Personaliza las Instrucciones (AGENTS.md)

AGENTS.md es el archivo de instrucciones operativas — el "manual del empleado". Define:

Qué archivos leer al despertar: SOUL.md, USER.md, memory reciente
Reglas de memoria: "Si quieres recordar algo, ESCRÍBELO en un archivo"
Comportamiento en group chats: "No respondas a todo. Los humanos no lo hacen. Tú tampoco"
Qué es safe hacer solo: Leer archivos, buscar en web, organizar workspace
Qué requiere permiso: Emails, posts públicos, cualquier cosa que salga del sistema

TOOLS.md — La Guía de Herramientas

Este archivo NO controla qué herramientas existen — solo guía cómo usarlas. Es como decirle a un empleado: "Tenemos Slack, pero no lo uses para temas urgentes. Para urgentes, mándame un texto."

Ejemplo de contenido útil en TOOLS.md:

```markdown

Calendar

Mi calendario principal es el de Gmail, no el de trabajo
No agendes nada antes de las 9am ni después de las 6pm
Los viernes no tengo reuniones

Email

Drafts van a mi bandeja, no los envíes directamente
Emails de newsletters: archive sin preguntarme
Emails de clientes: siempre notifícame

Browser

Usa Exa o Brave Search antes de abrir Chrome
Si un sitio no carga, no insistas — avísame

❓ Quiz 1

¿Cuál es la mejor forma de hacer onboarding de un agente nuevo?

El 'Yappers API' — simplemente hablar — es la forma de más alto ancho de banda para dar contexto a tu agente. Puede ser texto largo o voice notes en Telegram. El agente procesa, hace preguntas de follow-up, y crea los archivos por ti.

Answer to continue ↓

⚖ Decision 1

Tu agente recién onboarded te pregunta: '¿Quieres que revise tu email cada hora y te notifique de lo importante?' Es tentador decir que sí, pero recién empezaron a trabajar juntos.

A Riesgoso tan temprano. No sabes si va a interpretar bien qué es 'importante'. Podrías recibir 20 notificaciones al día de cosas irrelevantes, o peor, que no te notifique de algo crítico.

B ★ El sweet spot. Puede aprender qué te importa viendo tu inbox. Tú revisas sus resúmenes y le das feedback: 'esto sí es importante, esto no'. Después de una semana, tiene calibración.

C Conservador pero válido. Si prefieres ir gradual, empieza con calendario y tareas. El email puede esperar a la semana 2.

Make your choice to continue ↓

🛠 Exercise 1

Haz el onboarding de tu agente. Escríbele un mensaje de presentación como si estuvieras hablándole a un asistente nuevo en tu primer día juntos. Incluye: quién eres, qué haces, qué necesitas de él/ella, y al menos 2 reglas claras de cómo quieres que trabaje.

✓ Saved