O que é ClawRecipes?

ClawRecipes é uma extensão poderosa para o framework OpenClaw, projetada para eliminar o processo tedioso de configurar manualmente equipes de agentes de IA. Em vez de "fazer gambiarras nos agentes" (hacking agents), os usuários podem aproveitar modelos estruturados em Markdown — chamados de receitas — para estruturar instantaneamente espaços de trabalho de agentes completos, coesos e funcionais. Este sistema impõe uma filosofia "file-first" (arquivo em primeiro lugar), garantindo que o contexto, os fluxos de trabalho e as configurações da equipe sejam controláveis por versão, revisáveis e repetíveis.

Esta solução transforma a configuração da equipe de um gerenciamento de estado frágil e oculto para uma infraestrutura transparente, amigável ao Git. Ao aplicar uma receita, você estabelece imediatamente o contexto compartilhado (como documentação e tickets), define agentes especializados no estilo de "colegas de trabalho" (Líder, Desenvolvedor, QA), define estruturas de fluxo ágil (raias/swim lanes) e integra automação recorrente via jobs cron. O resultado é uma configuração determinística e de alta qualidade que vai da estrutura inicial ao trabalho entregue com consistência todas as vezes.

Principais Recursos

• Modelos em Markdown (Blueprints): Defina estruturas completas de equipe, repositórios de contexto e fluxos de trabalho usando arquivos Markdown legíveis, tornando a configuração transparente e auditável.
• Contexto Arquivo-Primeiro (A Despensa/The Pantry): Todas as informações críticas da equipe — notas, tickets, listas de verificação e artefatos — residem em um espaço de trabalho compartilhado e controlado por versão, garantindo que os agentes nunca "esqueçam" o contexto crucial.
• Agentes Estilo Colega de Trabalho (A Linha/The Line): Estruture funções especializadas (ex: Líder, Dev, DevOps, QA) que operam com responsabilidades, ferramentas e modelos definidos, permitindo que os usuários interajam com eles como membros dedicados da equipe.
• Loops de Fluxo de Trabalho Automatizados (O Temporizador/The Timer): Implemente tarefas recorrentes como triagem diária, higiene do quadro (board hygiene) ou monitoramento de PRs usando fluxos de trabalho cron definidos dentro das receitas. Estes são opcionais (opt-in) e protegidos por prompts para maior segurança.
• Aplicação de Processo Ágil (A Passagem/The Pass): Configure automaticamente raias ágeis estruturadas (A Fazer/Backlog, Em Progresso, Testando, Concluído) com passagens limpas e listas de verificação de verificação integradas diretamente na estrutura do fluxo de trabalho.
• Estruturação Determinística: Garanta que cada nova equipe comece a partir de uma estrutura conhecida e funcional, completa com funções, modelos e convenções predefinidas, garantindo consistência entre os projetos.

Como Usar o ClawRecipes

Começar com o ClawRecipes envolve integrá-lo ao seu ambiente OpenClaw existente e, em seguida, aplicar a receita desejada para construir sua estrutura de equipe.

1. Instalação: Primeiro, instale o plugin na sua configuração do OpenClaw via terminal:

$openclaw plugins install @jiggai/recipes

Após a instalação, você deve reiniciar o gateway do OpenClaw para ativar a nova funcionalidade:

$openclaw gateway restart

2. Estruturando uma Equipe ou Agente: Uma vez instalado, você pode usar o comando scaffold-team para implantar um ambiente completo e pré-configurado baseado em uma receita. Por exemplo, para configurar uma equipe de desenvolvimento padrão:

$openclaw recipes scaffold-team development-team -t minha-equipe-dev --apply-config

Alternativamente, se você precisar apenas de um único agente especializado, você pode estruturá-lo diretamente:

$openclaw recipes scaffold researcher --agent-id meu-pesquisador --apply-config

3. Revisão e Iteração: Como todas as configurações são baseadas em arquivos, você pode inspecionar imediatamente a estrutura do espaço de trabalho gerada, verificar as funções dos agentes e modificar as raias ágeis ou os jobs cron no seu sistema de controle de versão antes de implantar ou executar totalmente os agentes.

Casos de Uso

1. Inícios Rápidos de Projeto: Lance instantaneamente ambientes de desenvolvimento padronizados para novos projetos. Uma receita pode impor padrões de toda a empresa para listas de verificação de revisão de código, procedimentos de implantação (função DevOps) e estrutura de documentação inicial, garantindo que nenhuma etapa crítica de configuração seja perdida.
2. Pesquisa e Relatórios Automatizados: Implante uma equipe centrada em um agente Pesquisador apoiado por um agente de QA. Use o recurso cron para agendar tarefas diárias de agregação de dados ou monitoramento de mercado, entregando relatórios consistentes e repetíveis sem intervenção manual.
3. Aplicação de Disciplina Ágil: Para equipes com dificuldades na adesão ao processo, uma ClawRecipe pode bloquear um fluxo ágil rigoroso (Despacho -> Backlog -> Em Progresso -> Testando -> Concluído). A própria estrutura guia os agentes e os contribuintes humanos para as passagens e etapas de verificação adequadas.
4. Integração de Novos Desenvolvedores: Novos membros da equipe podem clonar um repositório contendo a configuração da ClawRecipe do projeto. Isso configura imediatamente seu ambiente OpenClaw local com as mesmas funções de agente, arquivos de contexto e expectativas de fluxo de trabalho que o restante da equipe.
5. Manutenção de Fluxos de Trabalho de Infraestrutura como Código (IaC): Use receitas para definir agentes responsáveis pelo gerenciamento de infraestrutura (DevOps). Seu contexto pode incluir modelos de IaC, e seus fluxos de trabalho podem ser definidos para executar verificações de segurança automatizadas ou loops de verificação de implantação em um cronograma.

FAQ

P: O ClawRecipes é gratuito para usar com o OpenClaw? A: ClawRecipes é apresentado como um plugin aberto (@jiggai/recipes) para OpenClaw. Embora o plugin em si seja geralmente de código aberto e gratuito para instalar, os custos de uso dependem da infraestrutura subjacente do gateway OpenClaw e dos provedores de LLM que você utiliza.

P: Como eu personalizo as funções definidas em uma receita (ex: mudar as ferramentas do agente Dev)? A: Como as receitas usam modelos baseados em arquivos, você pode inspecionar os arquivos estruturados após a implantação. Você pode modificar as definições dos agentes (ferramentas, modelos, responsabilidades) diretamente nos arquivos de configuração gerados dentro do seu espaço de trabalho e confirmar essas alterações no controle de versão.

P: O que acontece se um job cron definido em uma receita for executado inesperadamente? A: O ClawRecipes prioriza a segurança. Os jobs cron sugeridos por uma receita são instalados somente após consentimento explícito do usuário via prompt. Eles não são ativados automaticamente após a estruturação, prevenindo operações em segundo plano indesejadas.

P: Posso compartilhar minhas configurações de equipe personalizadas com outras pessoas? A: Com certeza. O principal benefício da abordagem arquivo-primeiro é a capacidade de compartilhamento. Você pode confirmar seus arquivos de receita modificados ou a estrutura do espaço de trabalho estruturada resultante no Git e compartilhá-la com qualquer outro usuário do OpenClaw que tenha o plugin ClawRecipes instalado.

P: E se eu precisar de uma função não incluída nas receitas padrão (ex: um agente de Marketing dedicado)? A: Você pode estender receitas existentes ou criar novas. O sistema permite que você defina funções personalizadas, atribua-lhes ferramentas e modelos específicos e os integre nas raias ágeis existentes, garantindo que suas necessidades especializadas sejam atendidas dentro da estrutura estruturada.