Cos'è ClawRecipes?

ClawRecipes è una potente estensione per il framework OpenClaw progettata per eliminare il tedioso processo di configurazione manuale dei team di agenti AI. Invece di "hackerare gli agenti", gli utenti possono sfruttare progetti Markdown strutturati — chiamati ricette — per creare istantaneamente spazi di lavoro per agenti completi, coesi e funzionali. Questo sistema impone una filosofia "file-first", garantendo che il contesto, i flussi di lavoro e le configurazioni del team siano versionabili, verificabili e ripetibili.

Questa soluzione sposta l'impostazione del team dalla gestione fragile dello stato nascosto a un'infrastruttura trasparente, adatta a Git. Applicando una ricetta, si stabilisce immediatamente un contesto condiviso (come documentazione e ticket), si definiscono agenti specializzati in stile "collega" (Lead, Dev, QA), si bloccano strutture di flusso agili (corsie di nuoto) e si integrano automazioni ricorrenti tramite lavori cron. Il risultato è una configurazione deterministica e di alta qualità che passa dall'impalcatura iniziale al lavoro completato con coerenza ogni singola volta.

Caratteristiche Principali

• Progetti Markdown: Definisci intere strutture di team, repository di contesto e flussi di lavoro utilizzando file Markdown leggibili, rendendo la configurazione trasparente e verificabile.
• Contesto File-First (La Dispensa): Tutte le informazioni critiche del team — note, ticket, liste di controllo e artefatti — risiedono in uno spazio di lavoro condiviso e versionato, assicurando che gli agenti non "dimentichino" mai il contesto cruciale.
• Agenti in Stile Collega (La Linea): Crea ruoli specializzati (es. Lead, Dev, DevOps, QA) che operano con responsabilità, strumenti e modelli definiti, consentendo agli utenti di interagire con loro come membri del team dedicati.
• Cicli di Flusso di Lavoro Automatizzati (Il Timer): Implementa attività ricorrenti come triage giornaliero, igiene della bacheca o monitoraggio delle PR utilizzando flussi di lavoro cron definiti all'interno delle ricette. Questi sono opt-in e controllati da prompt per sicurezza.
• Applicazione del Processo Agile (Il Passaggio): Imposta automaticamente corsie agili strutturate (Backlog, In Progress, Testing, Done) con passaggi puliti e liste di controllo di verifica integrate direttamente nella struttura del flusso di lavoro.
• Creazione di Strutture Deterministica: Assicura che ogni nuovo team parta da una struttura nota e funzionante, completa di ruoli, modelli e convenzioni predefiniti, garantendo coerenza tra i progetti.

Come Usare ClawRecipes

Iniziare con ClawRecipes comporta l'integrazione nel tuo ambiente OpenClaw esistente e quindi l'applicazione della ricetta desiderata per costruire la struttura del tuo team.

1. Installazione: Per prima cosa, installa il plugin nella tua configurazione OpenClaw tramite il terminale:

$openclaw plugins install @jiggai/recipes

Dopo l'installazione, devi riavviare il gateway OpenClaw per attivare la nuova funzionalità:

$openclaw gateway restart

2. Creazione di un Team o di un Agente: Una volta installato, puoi utilizzare il comando scaffold-team per distribuire un ambiente completo e preconfigurato basato su una ricetta. Ad esempio, per impostare un team di sviluppo standard:

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

In alternativa, se hai bisogno solo di un singolo agente specializzato, puoi crearlo direttamente:

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

3. Revisione e Iterazione: Poiché tutte le configurazioni sono basate su file, puoi immediatamente rivedere la struttura dello spazio di lavoro generato, ispezionare i ruoli degli agenti e modificare le corsie agili o i lavori cron nel tuo sistema di controllo versione prima di distribuire o eseguire completamente gli agenti.

Casi d'Uso

1. Avvii Rapidi di Progetto: Lancia istantaneamente ambienti di sviluppo standardizzati per nuovi progetti. Una ricetta può imporre standard aziendali per le liste di controllo delle revisioni del codice, le procedure di distribuzione (ruolo DevOps) e la struttura della documentazione iniziale, assicurando che nessun passaggio di configurazione critico venga omesso.
2. Ricerca e Reportistica Automatizzata: Distribuisci un team incentrato su un Agente Ricercatore supportato da un Agente QA. Utilizza la funzione cron per pianificare l'aggregazione giornaliera dei dati o le attività di monitoraggio del mercato, fornendo report coerenti e ripetibili senza intervento manuale.
3. Applicazione della Disciplina Agile: Per i team che faticano ad aderire ai processi, una ClawRecipe può bloccare un flusso agile rigoroso (Dispatch -> Backlog -> In Progress -> Testing -> Done). La struttura stessa guida gli agenti e i contributori umani verso passaggi di consegna e verifica appropriati.
4. Onboarding di Nuovi Sviluppatori: I nuovi membri del team possono clonare un repository contenente la configurazione ClawRecipe del progetto. Questo imposta immediatamente il loro ambiente OpenClaw locale con gli stessi ruoli degli agenti, i file di contesto e le aspettative di flusso di lavoro del resto del team.
5. Manutenzione dei Flussi di Lavoro Infrastructure as Code (IaC): Utilizza le ricette per definire agenti responsabili della gestione dell'infrastruttura (DevOps). Il loro contesto può includere modelli IaC e i loro flussi di lavoro possono essere impostati per eseguire controlli di sicurezza automatizzati o cicli di verifica della distribuzione su base programmata.

FAQ

D: ClawRecipes è gratuito da usare con OpenClaw? A: ClawRecipes è presentato come un plugin aperto (@jiggai/recipes) per OpenClaw. Sebbene il plugin stesso sia generalmente open-source e gratuito da installare, i costi di utilizzo dipendono dall'infrastruttura del gateway OpenClaw sottostante e dai provider LLM che utilizzi.

D: Come posso personalizzare i ruoli definiti in una ricetta (ad esempio, cambiare gli strumenti dell'agente Dev)? A: Poiché le ricette utilizzano progetti basati su file, puoi ispezionare i file generati dopo la distribuzione. Puoi modificare le definizioni degli agenti (strumenti, modelli, responsabilità) direttamente nei file di configurazione generati all'interno del tuo spazio di lavoro e sottoporre tali modifiche al controllo versione.

D: Cosa succede se un lavoro cron definito in una ricetta viene eseguito inaspettatamente? A: ClawRecipes privilegia la sicurezza. I lavori cron suggeriti da una ricetta vengono installati solo dopo un esplicito consenso dell'utente tramite un prompt. Non vengono attivati automaticamente al momento della creazione della struttura, prevenendo operazioni in background indesiderate.

D: Posso condividere le mie configurazioni di team personalizzate con altri? A: Assolutamente. Il vantaggio principale dell'approccio file-first è la possibilità di condivisione. Puoi sottoporre i tuoi file di ricetta modificati o la struttura dello spazio di lavoro generata a Git e condividerla con qualsiasi altro utente OpenClaw che abbia installato il plugin ClawRecipes.

D: Cosa succede se ho bisogno di un ruolo non incluso nelle ricette standard (ad esempio, un agente Marketing dedicato)? A: Puoi estendere le ricette esistenti o crearne di nuove. Il sistema ti consente di definire ruoli personalizzati, assegnare loro strumenti e modelli specifici e integrarli nelle corsie agili esistenti, assicurando che le tue esigenze specializzate siano soddisfatte all'interno del framework strutturato.