¿Qué es ClawRecipes?

ClawRecipes es una potente extensión para el framework OpenClaw diseñada para eliminar el tedioso proceso de configurar manualmente equipos de agentes de IA. En lugar de "hackear agentes", los usuarios pueden aprovechar planos estructurados en Markdown —llamados recetas— para estructurar instantáneamente espacios de trabajo de agentes completos, cohesivos y funcionales. Este sistema impone una filosofía de "archivo primero" (file-first), asegurando que el contexto, los flujos de trabajo y las configuraciones del equipo estén controlados por versiones, sean revisables y repetibles.

Esta solución traslada la configuración del equipo de una gestión de estado frágil y oculta a una infraestructura transparente y amigable con Git. Al aplicar una receta, se establece inmediatamente un contexto compartido (como documentación y tickets), se definen agentes especializados estilo "compañero de trabajo" (Líder, Desarrollador, QA), se fijan estructuras de flujo ágil (carriles o swim lanes) y se integra la automatización recurrente a través de trabajos cron. El resultado es una configuración determinista y de alta calidad que pasa de la estructura inicial al trabajo entregado con consistencia cada vez.

Características Clave

• Planos en Markdown: Defina estructuras completas de equipo, repositorios de contexto y flujos de trabajo utilizando archivos Markdown legibles, haciendo que la configuración sea transparente y auditable.
• Contexto Basado en Archivos (La Despensa): Toda la información crítica del equipo —notas, tickets, listas de verificación y artefactos— reside en un espacio de trabajo compartido y controlado por versiones, asegurando que los agentes nunca "olviden" el contexto crucial.
• Agentes Estilo Compañero de Trabajo (La Línea): Estructure roles especializados (ej. Líder, Desarrollador, DevOps, QA) que operan con responsabilidades, herramientas y plantillas definidas, permitiendo a los usuarios interactuar con ellos como miembros dedicados del equipo.
• Bucles de Flujo de Trabajo Automatizados (El Temporizador): Implemente tareas recurrentes como triaje diario, higiene del tablero o vigilancia de PR utilizando flujos de trabajo cron definidos dentro de las recetas. Estos son opcionales y controlados por indicaciones (prompt-gated) por seguridad.
• Aplicación de Procesos Ágiles (El Pase): Configure automáticamente carriles ágiles estructurados (Pendiente, En Progreso, Pruebas, Hecho) con traspasos limpios y listas de verificación de verificación integradas directamente en la estructura del flujo de trabajo.
• Estructuración Determinista: Asegure que cada nuevo equipo comience desde una estructura conocida y funcional, completa con roles, plantillas y convenciones predefinidas, garantizando consistencia en todos los proyectos.

Cómo Usar ClawRecipes

Comenzar con ClawRecipes implica integrarlo en su entorno OpenClaw existente y luego aplicar la receta deseada para construir la estructura de su equipo.

1. Instalación: Primero, instale el complemento en su configuración de OpenClaw a través de la terminal:

$openclaw plugins install @jiggai/recipes

Después de la instalación, debe reiniciar la pasarela (gateway) de OpenClaw para activar la nueva funcionalidad:

$openclaw gateway restart

2. Estructuración de un Equipo o Agente: Una vez instalado, puede usar el comando scaffold-team para implementar un entorno completo y preconfigurado basado en una receta. Por ejemplo, para configurar un equipo de desarrollo estándar:

$openclaw recipes scaffold-team development-team -t mi-equipo-dev --apply-config

Alternativamente, si solo necesita un agente especializado, puede estructurarlo directamente:

$openclaw recipes scaffold researcher --agent-id mi-investigador --apply-config

3. Revisión e Iteración: Debido a que todas las configuraciones se basan en archivos, puede inspeccionar inmediatamente la estructura del espacio de trabajo generado, revisar los roles de los agentes y modificar los carriles ágiles o los trabajos cron en su sistema de control de versiones antes de implementar o ejecutar completamente los agentes.

Casos de Uso

1. Lanzamientos Rápidos de Proyectos: Inicie instantáneamente entornos de desarrollo estandarizados para nuevos proyectos. Una receta puede imponer estándares de toda la empresa para listas de verificación de revisión de código, procedimientos de implementación (rol DevOps) y estructura de documentación inicial, asegurando que no se omita ningún paso de configuración crítico.
2. Investigación y Reportes Automatizados: Implemente un equipo centrado en un agente Investigador respaldado por un agente de QA. Utilice la función cron para programar tareas diarias de agregación de datos o monitoreo de mercado, entregando informes consistentes y repetibles sin intervención manual.
3. Imposición de Disciplina Ágil: Para equipos con dificultades para adherirse a los procesos, una ClawRecipe puede fijar un flujo ágil estricto (Despacho -> Pendiente -> En Progreso -> Pruebas -> Hecho). La estructura guía a los agentes y a los colaboradores humanos hacia traspasos adecuados y pasos de verificación integrados en la estructura.
4. Incorporación de Nuevos Desarrolladores: Los nuevos miembros del equipo pueden clonar un repositorio que contenga la configuración ClawRecipe del proyecto. Esto configura inmediatamente su entorno OpenClaw local con los mismos roles de agente, archivos de contexto y expectativas de flujo de trabajo que el resto del equipo.
5. Mantenimiento de Flujos de Trabajo de Infraestructura como Código (IaC): Use recetas para definir agentes responsables de la gestión de infraestructura (DevOps). Su contexto puede incluir plantillas de IaC, y sus flujos de trabajo pueden configurarse para ejecutar verificaciones de seguridad automatizadas o bucles de verificación de implementación de forma programada.

Preguntas Frecuentes (FAQ)

P: ¿Es ClawRecipes de uso gratuito con OpenClaw? A: ClawRecipes se presenta como un complemento abierto (@jiggai/recipes) para OpenClaw. Si bien el complemento en sí es generalmente de código abierto y gratuito de instalar, los costos de uso dependen de la infraestructura de la pasarela OpenClaw subyacente y de los proveedores de LLM que utilice.

P: ¿Cómo personalizo los roles definidos en una receta (ej. cambiar las herramientas del agente Dev)? A: Dado que las recetas utilizan planos basados en archivos, puede inspeccionar los archivos estructurados después de la implementación. Puede modificar las definiciones de los agentes (herramientas, plantillas, responsabilidades) directamente en los archivos de configuración generados dentro de su espacio de trabajo y confirmar esos cambios en el control de versiones.

P: ¿Qué sucede si un trabajo cron definido en una receta se ejecuta inesperadamente? A: ClawRecipes prioriza la seguridad. Los trabajos cron sugeridos por una receta solo se instalan después del consentimiento explícito del usuario a través de una indicación. No se activan automáticamente al estructurar, lo que previene operaciones en segundo plano no deseadas.

P: ¿Puedo compartir mis configuraciones de equipo personalizadas con otros? A: Absolutamente. El beneficio principal del enfoque basado en archivos es la capacidad de compartir. Puede confirmar sus archivos de receta modificados o la estructura del espacio de trabajo resultante en Git y compartirla con cualquier otro usuario de OpenClaw que tenga instalado el complemento ClawRecipes.

P: ¿Qué pasa si necesito un rol que no está incluido en las recetas estándar (ej. un agente de Marketing dedicado)? A: Puede extender recetas existentes o crear nuevas. El sistema le permite definir roles personalizados, asignarles herramientas y plantillas específicas e integrarlos en los carriles ágiles existentes, asegurando que sus necesidades especializadas se satisfagan dentro del marco estructurado.