Configuración del Espacio de Trabajo de OpenClaw: Lecciones de Dos Meses de Uso

Un usuario de OpenClaw compartió lecciones detalladas después de dos meses de usar el agente de programación con IA, enfatizando que la configuración del espacio de trabajo importa más que la herramienta en sí. El desarrollador descubrió que un espacio de trabajo bien construido mejora la experiencia entre 5 y 10 veces en comparación con una configuración estándar.

Configuración de SOUL.md

Las instrucciones genéricas como "sé útil y profesional" tienen un impacto mínimo. Los archivos SOUL.md efectivos deben:

• Incluir comportamientos específicos como "comienza con la respuesta, el contexto después" o "si no lo sabes, dilo, no inventes cosas"
• Mantenerse entre 50 y 150 líneas máximo, ya que cada línea consume tokens de la ventana de contexto
• Enfocarse en casos límite en lugar de escenarios normales: qué debe hacer el agente cuando no sabe algo, cuando las solicitudes están fuera de alcance o cuando hay conflictos de prioridades
• Probar cada línea preguntando: si se elimina, ¿cambia el comportamiento del agente? Si no, elimínala

AGENTS.md como Procedimiento Operativo Estándar

Este archivo debe responder "¿cómo trabajas?" en lugar de "¿quién eres?" (que es el rol de SOUL.md). Ideas clave:

• La regla más valiosa añadida: "antes de cualquier tarea no trivial, ejecuta memory_search primero" para evitar adivinar
• Cuando el agente comete errores, añade reglas para prevenir su recurrencia, con instrucciones negativas ("nunca hagas X sin verificar Y") que a menudo funcionan mejor que las positivas
• Las reglas en los archivos de arranque son solo consultivas: el modelo las sigue porque se le pide, no porque se hagan cumplir
• Para reglas que realmente no pueden romperse, usa la política de herramientas y la configuración del entorno aislado en lugar de confiar en markdown con palabras fuertes

Gestión de MEMORY.md

Este archivo se carga en cada sesión, por lo que debe contener solo información que necesite retención permanente:

• Incluye decisiones clave, preferencias del usuario, lecciones operativas y reglas aprendidas de errores
• La información diaria va en archivos memory/AAAA-MM-DD.md que el agente busca cuando es necesario
• Límites estrictos: 20,000 caracteres por archivo, 150,000 en total entre todos los archivos de arranque; excederlos causa truncamiento silencioso
• Las instrucciones escritas en el chat NO persisten una vez que ocurre la compactación del contexto
• Conecta tu espacio de trabajo a git para recuperar archivos MEMORY sobrescritos accidentalmente del historial de commits

USER.md y Optimización de Habilidades

El archivo USER.md está subestimado: incluir antecedentes, preferencias, zona horaria y contexto de trabajo reduce la repetición y ahorra tokens. Para las habilidades:

• Tener 30 habilidades instaladas no inyecta 30 archivos completos de habilidades en cada indicación, pero la lista de habilidades en sí consume contexto
• Reducir de 15+ habilidades a 5 mejoró notablemente la calidad de la salida
• Prueba: si una habilidad desapareciera mañana, ¿lo notarías? Si no, desinstálala

Problemas Comunes con Configuración Deficiente

Cuando la configuración de la persona no es sólida, estos problemas surgen rápidamente:

• El agente sigue desviándose, requiriendo corrección constante en un bucle sin fin
• Tokens desperdiciados en acciones ineficientes como abrir un navegador cuando un script funcionaría
• Demasiadas habilidades cargadas, inflando el contexto e impidiendo el funcionamiento adecuado
• Salida inconsistente para la misma tarea en diferentes sesiones

El desarrollador, que trabaja en comercio electrónico, creó personas de abastecimiento de productos y operaciones de Shopify después de encontrar que la mayoría de las personas disponibles eran inadecuadas. Señaló que, aunque cada industria tiene flujos de trabajo que podrían empaquetarse en personas, los buenos recursos están dispersos en plataformas de pago, GitHub, blogs aleatorios y publicaciones antiguas, y muchas "personas" son solo archivos SOUL únicos que no son utilizables directamente.