--- title: "Como Criar Skills para OpenClaw - Guia Completo" url: "https://openclaw.ia.br/tutoriais/criar-skills/" markdown_url: "https://openclaw.ia.br/tutoriais/criar-skills.MD" description: "Aprenda a criar, configurar e publicar Skills personalizadas para expandir as capacidades do seu agente OpenClaw. Tutorial passo a passo com exemplos práticos." date: "2026-02-01" author: "" --- # Como Criar Skills para OpenClaw - Guia Completo Aprenda a criar, configurar e publicar Skills personalizadas para expandir as capacidades do seu agente OpenClaw. Tutorial passo a passo com exemplos práticos. # Como Criar Skills para OpenClaw Skills são extensões modulares que expandem as capacidades do seu agente OpenClaw. Pense nelas como "superpoderes" que você pode adicionar, remover ou compartilhar com a comunidade. ## O Que São Skills? Uma Skill é um pacote que contém: - **SKILL.md** - Instruções que o agente segue - **Scripts** - Código auxiliar (opcional) - **Referências** - Documentação e exemplos Quando você diz "preciso enviar um email", o OpenClaw procura uma Skill relevante e segue suas instruções automaticamente. ## Estrutura Básica de uma Skill ``` minha-skill/ ├── SKILL.md # Obrigatório: instruções para o agente ├── scripts/ # Opcional: scripts auxiliares │ └── helper.sh ├── references/ # Opcional: documentação │ └── api-docs.md └── assets/ # Opcional: imagens, templates └── template.txt ``` ## Passo 1: Criar o Diretório Crie uma pasta para sua Skill no diretório `skills/` do seu workspace: ```bash mkdir -p ~/clawd/skills/minha-skill cd ~/clawd/skills/minha-skill ``` ## Passo 2: Escrever o SKILL.md O arquivo `SKILL.md` é o coração da sua Skill. Ele contém instruções em linguagem natural que o agente seguirá. ### Exemplo: Skill de Clima ```markdown # Skill: Clima ## Descrição Consulta a previsão do tempo usando o wttr.in. ## Quando Usar - Usuário pergunta sobre o clima - Usuário quer saber se vai chover - Usuário planeja atividades ao ar livre ## Como Executar 1. Identifique a cidade mencionada (padrão: São Paulo) 2. Execute o comando: ```bash curl -s "wttr.in/{cidade}?format=3&lang=pt" ``` 3. Para previsão detalhada: ```bash curl -s "wttr.in/{cidade}?lang=pt" ``` ## Exemplos de Uso **Entrada:** "Como está o tempo em Florianópolis?" **Ação:** `curl -s "wttr.in/Florianópolis?format=3&lang=pt"` **Entrada:** "Vai chover amanhã?" **Ação:** Consultar previsão detalhada da cidade atual ``` ## Passo 3: Adicionar Scripts (Opcional) Para tarefas mais complexas, adicione scripts auxiliares: ```bash mkdir scripts ``` Exemplo de script `scripts/check-weather.sh`: ```bash #!/bin/bash # Consulta clima com formatação bonita CIDADE="${1:-São Paulo}" curl -s "wttr.in/${CIDADE}?lang=pt&format=%l:+%c+%t+%h+%w" ``` No SKILL.md, referencie o script: ```markdown ## Como Executar Execute o script auxiliar: ```bash ./scripts/check-weather.sh "Nome da Cidade" ``` ``` ## Passo 4: Incluir Referências (Opcional) Para Skills que usam APIs ou têm documentação específica: ```bash mkdir references ``` Crie `references/api.md` com informações relevantes que o agente pode consultar. ## Melhores Práticas para SKILL.md ### 1. Seja Específico nos Gatilhos ❌ Ruim: ```markdown ## Quando Usar - Quando o usuário pedir ``` ✅ Bom: ```markdown ## Quando Usar - Usuário menciona "clima", "tempo", "previsão" - Usuário pergunta se vai chover ou fazer sol - Usuário planeja viagem ou atividade ao ar livre ``` ### 2. Forneça Exemplos Concretos Exemplos ajudam o agente a entender o padrão esperado: ```markdown ## Exemplos **Entrada:** "Manda um resumo do projeto pro time" **Ação:** 1. Ler MEMORY.md para contexto do projeto 2. Gerar resumo com últimas decisões 3. Enviar via Slack para canal #equipe ``` ### 3. Trate Erros ```markdown ## Tratamento de Erros Se a API retornar erro: 1. Informar o usuário sobre o problema 2. Sugerir alternativa (se houver) 3. Não inventar dados Se cidade não for encontrada: 1. Perguntar ao usuário qual cidade quis dizer 2. Sugerir cidades similares ``` ### 4. Defina Limites ```markdown ## Limitações - Não enviar mais de 5 mensagens por minuto - Não acessar dados sensíveis sem confirmação - Não fazer alterações permanentes sem backup ``` ## Skills com Integrações ### Skill de Email ```markdown # Skill: Email via Gmail ## Pré-requisitos - Integração Gmail configurada em /integracoes/gmail/ ## Quando Usar - Enviar emails - Ler caixa de entrada - Responder mensagens ## Fluxo de Envio 1. Confirmar destinatário com usuário 2. Compor mensagem 3. Pedir confirmação antes de enviar 4. Enviar e confirmar sucesso ``` ### Skill de Calendário ```markdown # Skill: Google Calendar ## Quando Usar - Agendar eventos - Verificar disponibilidade - Listar compromissos ## Verificar Agenda ```bash # Listar eventos de hoje gcalcli agenda --calendar "primary" today tomorrow ``` ## Criar Evento Sempre confirmar com usuário: - Data e hora - Título do evento - Participantes (se houver) ``` ## Testando Sua Skill ### 1. Verificar Estrutura ```bash ls -la ~/clawd/skills/minha-skill/ # Deve mostrar pelo menos SKILL.md ``` ### 2. Testar no Chat Inicie uma conversa com seu agente e teste os gatilhos: ``` Você: Como está o clima hoje? Agente: [Deve acionar a Skill de clima] ``` ### 3. Verificar Logs Se algo não funcionar, verifique se a Skill foi carregada: ```bash # No OpenClaw, use /status para ver Skills ativas ``` ## Publicando Sua Skill ### 1. Documentar no README Crie um `README.md` explicando: - O que a Skill faz - Pré-requisitos - Como instalar - Exemplos de uso ### 2. Estrutura para Publicação ``` minha-skill/ ├── README.md # Documentação para usuários ├── SKILL.md # Instruções para o agente ├── CHANGELOG.md # Histórico de versões ├── scripts/ └── references/ ``` ### 3. Compartilhar - **ClawhHub:** Publique em [clawhub.com](https://clawhub.com) - **GitHub:** Crie um repositório público - **Discord:** Compartilhe na comunidade OpenClaw ## Skills Avançadas ### Multi-Step Skills Para tarefas complexas com múltiplas etapas: ```markdown # Skill: Relatório Semanal ## Fluxo Completo ### Etapa 1: Coleta de Dados 1. Ler commits da semana no Git 2. Verificar tarefas concluídas 3. Listar métricas relevantes ### Etapa 2: Análise 1. Identificar principais conquistas 2. Listar bloqueios encontrados 3. Calcular progresso vs. metas ### Etapa 3: Geração 1. Criar relatório em Markdown 2. Incluir gráficos se disponíveis 3. Salvar em reports/YYYY-MM-DD.md ### Etapa 4: Distribuição 1. Enviar por email ao gestor 2. Postar resumo no Slack 3. Atualizar dashboard ``` ### Skills com Estado Para Skills que precisam lembrar informações: ```markdown ## Persistência Salvar estado em `~/.clawd/skills/minha-skill/state.json`: ```json { "lastRun": "2026-02-01T10:00:00Z", "counter": 42, "preferences": {} } ``` Carregar estado no início de cada execução. ``` ### Skills Condicionais ```markdown ## Comportamento Condicional ### Se horário comercial (9h-18h): - Enviar notificações normalmente - Agendar reuniões ### Se fora do horário: - Acumular notificações para manhã seguinte - Não agendar reuniões - Apenas alertas urgentes passam ``` ## Exemplos de Skills Úteis ### 1. Skill de Resumo de Artigos ```markdown # Skill: Resumo de Artigos ## Quando Usar - Usuário compartilha URL de artigo - Usuário pede resumo de texto longo ## Como Executar 1. Extrair conteúdo da URL (se aplicável) 2. Identificar pontos principais 3. Gerar resumo em 3-5 parágrafos 4. Listar principais conclusões ``` ### 2. Skill de Tradução ```markdown # Skill: Tradução ## Quando Usar - Usuário pede tradução - Texto em idioma diferente do preferido ## Idiomas Suportados - Português ↔ Inglês - Português ↔ Espanhol - Inglês ↔ Espanhol ## Comportamento - Manter tom e estilo original - Preservar formatação - Indicar termos sem tradução direta ``` ### 3. Skill de Code Review ```markdown # Skill: Code Review ## Quando Usar - Usuário compartilha código - Usuário pede revisão de PR ## Análise 1. Verificar erros de sintaxe 2. Identificar problemas de segurança 3. Sugerir melhorias de performance 4. Avaliar legibilidade ## Formato de Resposta - Pontos positivos primeiro - Problemas críticos destacados - Sugestões com exemplos de código ``` ## Solução de Problemas ### Skill Não é Acionada 1. Verifique se o SKILL.md existe 2. Confirme que os gatilhos estão claros 3. Reinicie o OpenClaw para recarregar Skills ### Skill Executa Incorretamente 1. Revise as instruções no SKILL.md 2. Adicione mais exemplos 3. Seja mais específico nos passos ### Scripts Não Executam 1. Verifique permissões: `chmod +x script.sh` 2. Confirme que o caminho está correto 3. Teste o script manualmente primeiro ## Próximos Passos - [Personalizar SOUL.md](/tutoriais/personalizar-soul/) - Defina a personalidade do agente - [Configurar Memória](/tutoriais/configurar-memoria/) - Faça o agente lembrar contexto - [Explorar Skills Prontas](/skills/) - Veja Skills da comunidade --- **Dica:** Comece com Skills simples e vá adicionando complexidade conforme aprende. A melhor Skill é aquela que resolve um problema real do seu dia a dia!