Como Criar Skills Personalizadas no OpenClaw
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
mkdir -p ~/clawd/skills/web-summary
cd ~/clawd/skills/web-summary
Passo 2: Escrever o SKILL.md
# 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
# 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"
# 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:
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:
## 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:
## 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
## 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
## Limites
- Máximo 5 consultas por minuto
- Apenas moedas com volume > $1M/dia
- Histórico limitado a 30 dias
Publicando Skills
ClawdHub
O ClawdHub é o marketplace de skills:
# Instalar CLI
npm install -g clawdhub
# Publicar
clawdhub publish ./minha-skill
Compartilhando Manualmente
- Zip a pasta da skill
- Compartilhe o arquivo
- O usuário extrai em
~/clawd/skills/
Skills Avançadas
Multi-Step Skills
Para workflows complexos:
## 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:
## 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.mdna 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 ou entre na comunidade para trocar ideias.