--- title: "Como Criar Skills Personalizadas no OpenClaw" url: "https://openclaw.ia.br/blog/criar-skills-openclaw-guia/" markdown_url: "https://openclaw.ia.br/blog/criar-skills-openclaw-guia.MD" description: "Guia completo para criar skills personalizadas no OpenClaw. Aprenda a estender as capacidades do seu assistente com automações, integrações e ferramentas próprias." date: "2026-01-31" author: "" --- # Como Criar Skills Personalizadas no OpenClaw Guia completo para criar skills personalizadas no OpenClaw. Aprenda a estender as capacidades do seu assistente com automações, integrações e ferramentas próprias. Skills são o superpoder do OpenClaw. Elas permitem ensinar novas capacidades ao seu assistente — desde automações simples até integrações complexas. ## O Que São Skills? Uma skill é um **pacote de instruções e ferramentas** que o Claude pode usar. Cada skill contém: - `SKILL.md`: Instruções de como e quando usar - Scripts opcionais: Código que a skill pode executar - Assets: Arquivos de referência, templates, etc. Quando você pede algo que uma skill resolve, o Claude **lê as instruções e executa**. ## Anatomia de uma Skill ``` minha-skill/ ├── SKILL.md # Obrigatório: instruções ├── scripts/ # Opcional: código executável │ └── run.sh ├── templates/ # Opcional: templates reutilizáveis │ └── output.md └── examples/ # Opcional: exemplos de uso └── demo.md ``` ## Criando Sua Primeira Skill Vamos criar uma skill simples: **resumir páginas web**. ### Passo 1: Criar a Estrutura ```bash mkdir -p ~/clawd/skills/web-summary cd ~/clawd/skills/web-summary ``` ### Passo 2: Escrever o SKILL.md ```markdown # Web Summary Skill ## Descrição Resumo inteligente de páginas web em português. ## Quando Usar - Usuário compartilha um link e pede resumo - Usuário quer os pontos principais de um artigo - Usuário pede "resumo de [URL]" ## Como Usar 1. Use `web_fetch` para obter o conteúdo da URL 2. Analise o conteúdo extraído 3. Crie um resumo estruturado: - **Título**: Nome do artigo - **Fonte**: Domínio - **Resumo**: 2-3 parágrafos - **Pontos-chave**: Lista com 3-5 itens - **Para quem**: Público-alvo ideal ## Formato da Resposta ``` **[Título]** Fonte: [domínio] **Resumo:** [2-3 parágrafos concisos] **Pontos-chave:** • [ponto 1] • [ponto 2] • [ponto 3] **Ideal para:** [público] ``` ## Exemplos Input: "resume https://exemplo.com/artigo-sobre-go" Output: [resumo formatado conforme template] ## Notas - Se a página não carregar, informe o erro - Para paywalls, explique a limitação - Mantenha o resumo objetivo, sem opinião ``` ### Passo 3: Testar Agora você pode pedir: ``` Resume este artigo: https://go.dev/blog/go1.22 ``` O Claude vai encontrar sua skill e seguir as instruções. ## Skills com Scripts Para tarefas que precisam de código, adicione scripts. ### Exemplo: Skill de Backup ```bash # scripts/backup.sh #!/bin/bash SOURCE="${1:-$HOME/Documents}" DEST="${2:-$HOME/backups}" DATE=$(date +%Y%m%d_%H%M%S) mkdir -p "$DEST" tar -czf "$DEST/backup_$DATE.tar.gz" "$SOURCE" echo "Backup criado: $DEST/backup_$DATE.tar.gz" ``` ```markdown # SKILL.md # Backup Skill ## Descrição Cria backups compactados de diretórios. ## Quando Usar - "faz backup de [pasta]" - "backup dos documentos" - "salva uma cópia de [diretório]" ## Como Usar Execute o script: ```bash ./scripts/backup.sh [origem] [destino] ``` Parâmetros: - origem: Diretório a copiar (padrão: ~/Documents) - destino: Onde salvar (padrão: ~/backups) ## Resposta Confirme o backup criado com: - Caminho do arquivo - Tamanho - Conteúdo incluído ``` ## Skills com APIs Para integrações externas, documente a API e variáveis de ambiente. ### Exemplo: Skill de Clima ```markdown # Weather Skill ## Descrição Consulta previsão do tempo. ## Dependências - API: wttr.in (gratuita, sem key) ## Quando Usar - "como está o tempo em [cidade]" - "vai chover amanhã" - "previsão para [local]" ## Como Usar Faça requisição HTTP: ```bash curl -s "wttr.in/[cidade]?format=j1&lang=pt" ``` Ou para versão simples: ```bash curl -s "wttr.in/[cidade]?format=3" ``` ## Resposta Formate com emojis: - Sol - Chuva - Parcialmente nublado - Temperatura Inclua: - Condição atual - Temperatura (°C) - Sensação térmica - Previsão para as próximas horas ``` ## Boas Práticas ### 1. Seja Específico no "Quando Usar" Não Ruim: ```markdown ## Quando Usar Use quando o usuário precisar. ``` Sim Bom: ```markdown ## Quando Usar - Comando explícito: "traduza para inglês" - Texto em português + contexto internacional - Usuário menciona "tradução" ou "traduzir" ``` ### 2. Dê Exemplos Concretos O Claude aprende melhor com exemplos: ```markdown ## Exemplos ### Exemplo 1 **Input:** "quanto é 150 dólares em reais" **Output:** USD 150.00 = R$ 742.50 (cotação: 4.95) ### Exemplo 2 **Input:** "converter 1000 euros" **Output:** EUR 1000.00 = R$ 5,320.00 (cotação: 5.32) ``` ### 3. Documente Erros ```markdown ## Tratamento de Erros ### API indisponível Responda: "Não consegui consultar a cotação agora. Tente novamente em alguns minutos." ### Moeda não suportada Responda: "Não encontrei essa moeda. Moedas suportadas: USD, EUR, GBP, BTC." ``` ### 4. Defina Limites ```markdown ## Limites - Máximo 5 consultas por minuto - Apenas moedas com volume > $1M/dia - Histórico limitado a 30 dias ``` ## Publicando Skills ### ClawdHub O [ClawdHub](https://clawdhub.com) é o marketplace de skills: ```bash # Instalar CLI npm install -g clawdhub # Publicar clawdhub publish ./minha-skill ``` ### Compartilhando Manualmente 1. Zip a pasta da skill 2. Compartilhe o arquivo 3. O usuário extrai em `~/clawd/skills/` ## Skills Avançadas ### Multi-Step Skills Para workflows complexos: ```markdown ## Fluxo ### Passo 1: Coleta Pergunte ao usuário: - Qual o objetivo? - Quais restrições? ### Passo 2: Análise Com as respostas, analise viabilidade. ### Passo 3: Execução Se viável, execute. Senão, explique por quê. ### Passo 4: Confirmação Mostre resultado e peça confirmação antes de finalizar. ``` ### Skills com Estado Use arquivos para persistir dados: ```markdown ## Estado Salve configurações do usuário em: `~/.config/minha-skill/preferences.json` Estrutura: ```json { "defaultLanguage": "pt-BR", "notifications": true, "lastRun": "2026-01-31T12:00:00Z" } ``` ``` ### Skills com Aprovação Para ações sensíveis: ```markdown ## Segurança Antes de executar ações destrutivas: 1. Liste exatamente o que será feito 2. Peça confirmação explícita: "Confirma? (sim/não)" 3. Só execute com "sim" explícito ``` ## Debugging Skills ### A skill não é encontrada Verifique: - Está em `~/clawd/skills/`? - Tem `SKILL.md` na raiz? - Nome da pasta não tem espaços? ### Claude não segue as instruções - Seja mais explícito no SKILL.md - Adicione mais exemplos - Reduza ambiguidade ### Scripts não executam - Verifique permissões: `chmod +x script.sh` - Teste manualmente primeiro - Confira paths absolutos vs relativos ## Conclusão Skills transformam o OpenClaw de um chatbot em uma **plataforma de automação personalizada**. Comece simples, itere com base no uso real, e compartilhe suas criações. --- Pronto para criar? Confira mais exemplos no [ClawdHub](https://clawdhub.com) ou [entre na comunidade](https://discord.com/invite/clawd) para trocar ideias.