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:

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

# 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"

Para previsão detalhada:
```
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:

#!/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:

## 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:

## Quando Usar
- Quando o usuário pedir

✅ Bom:

## 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:

## 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

## 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

## 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

# 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

# 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:

# 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
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:

# 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:

## 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

# 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

# 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

# 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

Verifique se o SKILL.md existe
Confirme que os gatilhos estão claros
Reinicie o OpenClaw para recarregar Skills

Skill Executa Incorretamente

Revise as instruções no SKILL.md
Adicione mais exemplos
Seja mais específico nos passos

Scripts Não Executam

Verifique permissões: chmod +x script.sh
Confirme que o caminho está correto
Teste o script manualmente primeiro

Próximos Passos

Personalizar SOUL.md - Defina a personalidade do agente
Configurar Memória - Faça o agente lembrar contexto
Explorar Skills Prontas - 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!

Como Criar Skills para OpenClaw - Guia Completo