Como Escrever Prompts Eficazes para o OpenClaw

Introdução

A mesma IA pode dar uma resposta medíocre ou uma resposta excelente dependendo de como você pergunta. Esse fenômeno — que a comunidade de IA chama de “engenharia de prompts” — é uma habilidade prática que qualquer pessoa pode aprender, e é talvez o investimento de aprendizado com maior ROI quando se trata de extrair valor de ferramentas de IA.

Com o OpenClaw, os prompts aparecem em dois contextos distintos: os prompts que você escreve nas conversas do dia a dia (pedidos, comandos, perguntas), e os prompts que definem o comportamento do assistente nos arquivos de configuração (SOUL.md, HEARTBEAT.md, skills). Ambos seguem os mesmos princípios fundamentais, mas têm nuances diferentes que este guia cobre.

A diferença entre um usuário casual de IA e um usuário avançado raramente é o acesso a recursos tecnológicos mais sofisticados — geralmente é a qualidade dos prompts. Usuários avançados conseguem resultados 3-10x melhores da mesma IA simplesmente por saber como estruturar seus pedidos. Este guia vai te colocar nesse grupo.

Pré-requisitos

Para aproveitar este guia:

• OpenClaw configurado e funcionando com pelo menos um canal
• Ao menos uma semana de uso para ter contexto sobre o que tem funcionado e o que não tem
• Interesse em experimentar — a melhor forma de aprender prompts é tentando e iterando

Os Fundamentos dos Bons Prompts

Princípio 1: Seja Específico

A vagueza é o maior inimigo dos bons prompts. Quanto mais específico você for, mais útil será a resposta.

Ruim:

"Me ajude com email"

Bom:

"Escreva um email profissional para o cliente Roberto Ferreira da empresa TechCorp
pedindo adiamento de 7 dias no prazo de entrega do relatório financeiro Q1.
Tom cordial mas direto. Máximo 150 palavras."

A diferença: o segundo prompt tem destinatário, contexto, objetivo, tom e limite de tamanho. A IA não precisa adivinhar nada.

Princípio 2: Forneça Contexto Relevante

A IA não sabe o que você não diz. Contexto relevante transforma respostas genéricas em respostas personalizadas.

Ruim:

"Resuma esse artigo"

Bom:

"Resuma esse artigo técnico sobre blockchain para apresentar em reunião executiva
para pessoas sem background técnico. Foco nos benefícios de negócio, não nos
detalhes técnicos. Máximo 5 bullet points."

Princípio 3: Defina o Formato da Saída

Diga à IA como você quer a resposta, não apenas o que quer.

Ruim:

"Liste opções de ferramentas de gestão de projetos"

Bom:

"Liste 5 ferramentas de gestão de projetos para equipes de 3-10 pessoas.
Formato: tabela com colunas: Nome | Custo/mês | Melhor para | Limitação principal"

Princípio 4: Defina a Persona

Quando relevante, diga à IA que papel ela deve assumir. Isso ativa diferentes “modos” de resposta.

"Você é um advogado especialista em direito do trabalho brasileiro.
Analise este contrato de prestação de serviços e aponte os 3 principais
riscos trabalhistas."

"Você é um desenvolvedor sênior fazendo code review. Revise este código Python
com foco em: performance, segurança e legibilidade."

Princípio 5: Itere e Refine

Raramente o primeiro prompt dá o resultado ideal. Itere:

Prompt 1: "Escreva proposta de valor para nosso software"
Resposta: genérica

Prompt 2: "A proposta está genérica. Adicione dados concretos:
- Redução de 40% no tempo de processamento (dado real nosso)
- Empresa média economiza R$15.000/mês
- Clientes relatam ROI em 3 meses
Reescreva com essas informações."

Templates Práticos

Template para Escrita

Escreva [tipo de conteúdo] sobre [tema].
Objetivo: [o que esse conteúdo deve alcançar].
Público-alvo: [quem vai ler/ouvir].
Tom: [formal/casual/técnico/persuasivo/educativo].
Tamanho: [número de palavras/parágrafos/slides].
Inclua: [elementos específicos que devem estar presentes].
Evite: [o que não deve aparecer].

Exemplo preenchido:

Escreva email de prospecção sobre nosso software de gestão financeira.
Objetivo: agendar uma demo de 30 minutos.
Público-alvo: CFO de PMEs com 20-100 funcionários.
Tom: profissional mas humano, sem jargão excessivo.
Tamanho: máximo 180 palavras.
Inclua: uma pergunta de engajamento no final.
Evite: promessas vagas como "transformar seu negócio".

Template para Análise

Analise [o quê] com foco em [aspecto principal].
Contexto: [informação de background relevante].
Objetivo da análise: [para que vai ser usada].
Formato de saída: [bullets/tabela/texto corrido/seções].
Nível de detalhe: [superficial/moderado/profundo].

Template para Código

Implemente [funcionalidade] em [linguagem/framework].
Requisitos funcionais:
- [requisito 1]
- [requisito 2]
Requisitos não funcionais: [performance, segurança, manutenibilidade].
Contexto: [sistema existente, versões, constraints].
Inclua: comentários explicativos, tratamento de erros, testes básicos.

Template para Decisões

Me ajude a decidir [decisão].
Opções que estou considerando: [A], [B], [C].
Critérios importantes para mim: [critério 1], [critério 2].
Meu contexto específico: [situação atual].
Prefiro resposta em formato: [matriz de decisão/pros e contras/recomendação direta].

Template para Revisão

Revise o seguinte [texto/código/documento].
Tipo de revisão: [gramática/clareza/lógica/style/performance].
Público final: [quem vai consumir].
Nível de intervenção: [corrija erros só/melhore fluidez/reestruture se necessário].
Formato de saída: [versão corrigida/lista de sugestões/ambos].

Escrevendo Prompts para Configuração (SOUL.md e HEARTBEAT.md)

Prompts de configuração são diferentes dos prompts de conversa. Eles definem comportamento permanente do assistente e precisam ser mais precisos e abrangentes.

SOUL.md — Boas Práticas

O SOUL.md é o prompt mais importante de todos. Algumas diretrizes:

# SOUL.md — Exemplo Bem Estruturado

## Identidade
Nome: Aurora
Papel: Assistente pessoal e de produtividade para [Nome]
Contexto: [Nome] é gerente de projetos em empresa de tecnologia

## Tom e Estilo de Comunicação
- Direto e objetivo — a pessoa valoriza eficiência
- Use listas quando há múltiplos pontos
- Humor sutil quando o contexto permite, nunca forçado
- Português brasileiro, linguagem acessível mas profissional

## Prioridades ao Receber uma Mensagem
1. Entender o objetivo real por trás do pedido
2. Verificar se há informação no MEMORY.md relevante
3. Responder com a informação mais útil possível
4. Sugerir próximos passos quando apropriado

## Comportamentos Específicos
- Quando receber tarefa sem prazo: pergunte o prazo
- Quando houver ambiguidade: peça clareza antes de executar
- Quando algo der errado: explique o que aconteceu e sugira alternativa
- Quando receber documento longo: peça confirmação do que deve ser extraído

## Limites Claros
- NÃO forneça informações médicas ou jurídicas como se fossem definitivas
- NÃO execute ações externas (envio de email, mensagens) sem confirmação
- NÃO invente informações — prefira dizer "não sei" ou "não encontrei nos dados disponíveis"
- NÃO ignore contexto do MEMORY.md quando ele é relevante

O que NÃO fazer no SOUL.md:

# SOUL.md — Exemplo Ruim

Você é um assistente útil e prestativo. Responda sempre com educação.
Seja amigável e ajude com tudo que o usuário precisar.

Isso é vago demais. O assistente não sabe seu contexto específico, suas prioridades, seu tom preferido ou seus limites.

HEARTBEAT.md — Prompts de Automação

Prompts de heartbeat precisam ser altamente específicos sobre quando agir e quando não agir:

# HEARTBEAT.md — Bem Estruturado

## Verificações a Cada Heartbeat

### Email (se configurado)
1. Verifique inbox
2. Classifique emails por urgência:
   - URGENTE: cliente com problema, prazo hoje, pedido de CEO
   - NORMAL: perguntas, atualizações de projeto
   - BAIXA: newsletters, notificações automáticas
3. Envie alerta APENAS para emails URGENTES

### Agenda
1. Verifique eventos nas próximas 2 horas
2. Alerte SE: reunião em menos de 30 min e ainda não há "lembrete enviado" no contexto
3. NÃO alerte para eventos já notificados

### Sistemas (apenas se configurado)
1. Ping no endpoint de saúde
2. Se status != 200: alerte imediatamente com mensagem: "ALERTA: Sistema offline às [hora]"

## Quando NÃO Enviar Mensagem
- Se não há nada urgente ou acionável
- Entre 23h e 7h (exceto erros de sistema)
- Se enviou mensagem nos últimos 15 minutos
- Finais de semana (exceto erros de sistema)

## Formato das Mensagens
Seja brevíssimo. Máximo 3 linhas.
Use prefixos: [URGENTE], [LEMBRETE], [ALERTA]

Técnicas Avançadas

Chain-of-Thought (Raciocínio Passo a Passo)

Para problemas complexos, peça ao assistente para raciocinar em etapas:

Analise este problema de otimização de banco de dados passo a passo:
1. Primeiro, identifique os gargalos prováveis
2. Para cada gargalo, avalie o impacto potencial
3. Proponha soluções em ordem de prioridade
4. Estime o esforço de implementação de cada solução

[Descreva o problema aqui]

Few-Shot Learning (Exemplos como Guia)

Fornecer exemplos do que você quer é muito mais eficaz que descrever:

Vou te dar 3 exemplos de como eu quero que você categorize emails.
Depois, aplique o mesmo critério para os próximos emails.

Exemplos:
- "Reunião amanhã às 14h" → AGENDA
- "Seu relatório foi aprovado" → INFORMAÇÃO
- "URGENTE: sistema fora do ar" → CRÍTICO

Agora categorize: "Aprovação necessária para o PR #234"

Personas para Diferentes Contextos

Configure personas diferentes para diferentes tipos de tarefa:

# SOUL.md — Personas por Contexto

## Quando receber pedidos de código:
Assuma persona de "Desenvolvedor Sênior com 10 anos de experiência".
Foco em: boas práticas, performance, segurança, legibilidade.
Sempre explique o "porquê" das decisões técnicas.

## Quando receber pedidos de comunicação:
Assuma persona de "Comunicador Corporativo Experiente".
Foco em: clareza, persuasão, adequação ao público.

## Quando receber pedidos de análise:
Assuma persona de "Consultor de Negócios".
Foco em: dados, tendências, impacto prático, recomendações acionáveis.

Erros Comuns e Soluções

Boas Práticas

• Trate a IA como um colaborador talentoso que não conhece seu contexto: Um colaborador talentoso novo na empresa entrega excelente resultado quando briefado corretamente. Você precisaria explicar: o que é a empresa, qual o objetivo, quem é o público, qual o prazo. O mesmo vale para a IA.

• Itere sem vergonha: Se a primeira resposta não foi boa, não desista — refine o prompt. “Isso está bom, mas [específica melhoria que quer]” é sempre uma interação válida.

• Salve prompts que funcionam bem: Quando você encontrar um prompt que entrega resultados excelentes para uma tarefa recorrente, salve no MEMORY.md ou em um arquivo de templates. Você vai reutilizá-lo dezenas de vezes.

• Menos é mais para perguntas simples: Para perguntas factuais diretas, um prompt simples funciona melhor. Não complique o que não precisa ser complicado: “Qual é a capital da Tailândia?” não precisa de 10 linhas de contexto.

• Use exemplos em vez de regras longas: Ao invés de escrever 5 linhas descrevendo o formato que você quer, escreva 2 exemplos. “Exemplos como guia” (few-shot) é uma das técnicas mais eficazes de prompting.

• Calibre pela tarefa: Tarefas criativas (brainstorming, escrita criativa) se beneficiam de prompts mais abertos. Tarefas precisas (código, análise de dados, formatação) se beneficiam de prompts altamente específicos.

• Teste variações: Para tarefas importantes que você vai executar muitas vezes, experimente 2-3 versões do prompt e veja qual entrega resultados mais consistentes.

• Dê feedback explícito: “Isso está errado porque [razão]” é mais eficaz que “tente de novo”. A IA usa seu feedback para corrigir especificamente o problema.

Perguntas Frequentes

Existe um limite de tamanho para os prompts? Tecnicamente, o limite é a context window do modelo (200.000 tokens para Claude). Na prática, prompts muito longos podem fazer o modelo perder partes do conteúdo. Para prompts acima de 1.000 palavras, estruture com cabeçalhos claros e coloque o mais importante no início e no final.

Quanto contexto adicional devo incluir? A regra prática: inclua todo contexto que uma pessoa inteligente mas sem conhecimento do seu domínio específico precisaria para entregar o resultado que você quer. Não mais que isso (torna o prompt pesado), não menos (resulta em resposta genérica).

Por que às vezes a IA ignora parte do meu prompt? Geralmente acontece quando o prompt tem conflitos internos, é muito longo sem estrutura, ou pede muitas coisas ao mesmo tempo. Solução: simplifique, estruture com bullet points, e separe pedidos complexos em múltiplas mensagens.

Como fazer a IA manter um estilo consistente ao longo de uma conversa? Defina o estilo no SOUL.md (para consistência permanente) ou no início da conversa com uma instrução explícita: “Para toda esta conversa, mantenha o tom de [especifique]”. Se perceber que o estilo está variando, reforce: “Lembre-se: estamos usando [tom/formato específico]”.

Existe diferença entre prompts para Claude vs. GPT-4? Sim, pequenas diferenças. Claude tende a seguir instruções de formato mais rigorosamente. GPT-4 pode ser ligeiramente mais “criativo” em como interpreta pedidos. Na prática, bons prompts funcionam bem em ambos. Se você treinou prompts para um modelo e vai mudar para outro, teste antes de assumir que o comportamento será idêntico.

Próximos Passos

• Personalizando SOUL.md — Guia completo de personalização do assistente
• Automação Avançada — Use prompts em pipelines automatizados
• Glossário: Prompt Engineering — Terminologia e técnicas avançadas
• Guia de Modelos — Como diferentes modelos respondem a prompts
• Primeiro Dia — Exemplos práticos de prompts para começar
• Blog — Guia Completo de Prompts — Exemplos por setor e caso de uso