Qu'est-ce que ClawRecipes ?

ClawRecipes est une extension puissante pour le framework OpenClaw conçue pour éliminer le processus fastidieux de configuration manuelle des équipes d'agents IA. Au lieu de « pirater des agents », les utilisateurs peuvent tirer parti de modèles Markdown structurés — appelés recettes — pour créer instantanément des espaces de travail d'agents complets, cohérents et fonctionnels. Ce système applique une philosophie « file-first » (le fichier d'abord), garantissant que le contexte, les flux de travail et les configurations d'équipe sont versionnés, examinables et reproductibles.

Cette solution fait passer la configuration de l'équipe de la gestion d'état fragile et cachée à une infrastructure transparente, compatible avec Git. En appliquant une recette, vous établissez immédiatement un contexte partagé (comme la documentation et les tickets), définissez des agents spécialisés de type « collègue » (Lead, Dev, QA), verrouillez les structures de flux agiles (couloirs de nage) et intégrez une automatisation récurrente via des tâches cron. Le résultat est une configuration déterministe et de haute qualité qui passe de l'échafaudage initial au travail livré avec cohérence à chaque fois.

Fonctionnalités Clés

• Modèles Markdown : Définissez des structures d'équipe entières, des référentiels de contexte et des flux de travail à l'aide de fichiers Markdown lisibles, rendant la configuration transparente et auditable.
• Contexte Fichier d'Abord (Le Garde-Manger) : Toutes les informations critiques de l'équipe — notes, tickets, listes de contrôle et artefacts — résident dans un espace de travail partagé et versionné, garantissant que les agents n'« oublient » jamais le contexte crucial.
• Agents de Type Collègue (La Ligne) : Structurez des rôles spécialisés (par exemple, Lead, Dev, DevOps, QA) qui opèrent avec des responsabilités, des outils et des modèles définis, permettant aux utilisateurs d'interagir avec eux comme des membres d'équipe dédiés.
• Boucles de Flux de Travail Automatisées (La Minuterie) : Implémentez des tâches récurrentes comme le triage quotidien, l'hygiène du tableau ou la surveillance des PR à l'aide de flux de travail cron définis dans les recettes. Ceux-ci sont opt-in et contrôlés par des invites pour des raisons de sécurité.
• Application du Processus Agile (Le Passage) : Configurez automatiquement des couloirs agiles structurés (Backlog, En Cours, Test, Terminé) avec des transferts clairs et des listes de contrôle de vérification intégrées directement dans la structure du flux de travail.
• Échafaudage Déterministe : Assurez-vous que chaque nouvelle équipe commence à partir d'une structure connue et bonne, complète avec des rôles, des modèles et des conventions prédéfinis, garantissant la cohérence entre les projets.

Comment Utiliser ClawRecipes

Commencer avec ClawRecipes implique de l'intégrer à votre environnement OpenClaw existant, puis d'appliquer la recette souhaitée pour construire votre structure d'équipe.

1. Installation : D'abord, installez le plugin dans votre configuration OpenClaw via le terminal :

$openclaw plugins install @jiggai/recipes

Après l'installation, vous devez redémarrer la passerelle OpenClaw pour activer la nouvelle fonctionnalité :

$openclaw gateway restart

2. Échafaudage d'une Équipe ou d'un Agent : Une fois installé, vous pouvez utiliser la commande scaffold-team pour déployer un environnement complet et préconfiguré basé sur une recette. Par exemple, pour configurer une équipe de développement standard :

$openclaw recipes scaffold-team development-team -t my-dev-team --apply-config

Alternativement, si vous n'avez besoin que d'un seul agent spécialisé, vous pouvez l'échafauder directement :

$openclaw recipes scaffold researcher --agent-id my-researcher --apply-config

3. Revue et Itération : Étant donné que toutes les configurations sont basées sur des fichiers, vous pouvez immédiatement examiner la structure de l'espace de travail générée, inspecter les rôles des agents et modifier les couloirs agiles ou les tâches cron dans votre système de contrôle de version avant de déployer ou d'exécuter entièrement les agents.

Cas d'Utilisation

1. Lancements Rapides de Projets : Lancez instantanément des environnements de développement standardisés pour de nouveaux projets. Une recette peut appliquer les normes de l'entreprise pour les listes de contrôle d'examen de code, les procédures de déploiement (rôle DevOps) et la structure de documentation initiale, garantissant qu'aucune étape de configuration critique n'est manquée.
2. Recherche et Rapports Automatisés : Déployez une équipe centrée autour d'un agent Chercheur soutenu par un agent QA. Utilisez la fonctionnalité cron pour planifier l'agrégation quotidienne de données ou les tâches de surveillance du marché, fournissant des rapports cohérents et répétables sans intervention manuelle.
3. Application de la Discipline Agile : Pour les équipes ayant des difficultés avec l'adhésion aux processus, une ClawRecipe peut verrouiller un flux agile strict (Dispatch -> Backlog -> En Cours -> Test -> Terminé). La structure guide les agents et les contributeurs humains vers les transferts appropriés et les étapes de vérification.
4. Intégration des Nouveaux Développeurs : Les nouveaux membres de l'équipe peuvent cloner un référentiel contenant la configuration ClawRecipe du projet. Cela configure immédiatement leur environnement OpenClaw local avec les rôles d'agent, les fichiers de contexte et les attentes de flux de travail exacts de l'équipe.
5. Maintien des Flux de Travail d'Infrastructure as Code (IaC) : Utilisez des recettes pour définir des agents responsables de la gestion de l'infrastructure (DevOps). Leur contexte peut inclure des modèles IaC, et leurs flux de travail peuvent être configurés pour exécuter des vérifications de sécurité automatisées ou des boucles de vérification de déploiement selon un calendrier.

FAQ

Q : ClawRecipes est-il gratuit à utiliser avec OpenClaw ? A : ClawRecipes est présenté comme un plugin ouvert (@jiggai/recipes) pour OpenClaw. Bien que le plugin lui-même soit généralement open-source et gratuit à installer, les coûts d'utilisation dépendent de l'infrastructure de passerelle OpenClaw sous-jacente et des fournisseurs de LLM que vous utilisez.

Q : Comment puis-je personnaliser les rôles définis dans une recette (par exemple, changer les outils de l'agent Dev) ? A : Étant donné que les recettes utilisent des modèles basés sur des fichiers, vous pouvez inspecter les fichiers générés après le déploiement. Vous pouvez modifier les définitions d'agent (outils, modèles, responsabilités) directement dans les fichiers de configuration générés au sein de votre espace de travail et valider ces modifications dans le contrôle de version.

Q : Que se passe-t-il si une tâche cron définie dans une recette s'exécute de manière inattendue ? A : ClawRecipes privilégie la sécurité. Les tâches cron suggérées par une recette ne sont installées qu'après un consentement explicite de l'utilisateur via une invite. Elles ne sont pas activées automatiquement lors de l'échafaudage, ce qui empêche les opérations d'arrière-plan non désirées.

Q : Puis-je partager mes configurations d'équipe personnalisées avec d'autres ? A : Absolument. L'avantage principal de l'approche fichier d'abord est la partageabilité. Vous pouvez valider vos fichiers de recette modifiés ou la structure d'espace de travail échafaudée résultante dans Git et la partager avec tout autre utilisateur OpenClaw ayant installé le plugin ClawRecipes.

Q : Que faire si j'ai besoin d'un rôle non inclus dans les recettes standard (par exemple, un agent Marketing dédié) ? A : Vous pouvez étendre les recettes existantes ou en créer de nouvelles. Le système vous permet de définir des rôles personnalisés, de leur attribuer des outils et des modèles spécifiques, et de les intégrer dans les couloirs agiles existants, garantissant que vos besoins spécialisés sont satisfaits dans le cadre structuré.