Contribuir com Skills — Publicar no ClawdHub
Como criar e compartilhar skills para OpenClaw. Guia para desenvolvedores de skills.
⏱️ 3 min de leitura
Contribuir com Skills
Crie skills e compartilhe com a comunidade no ClawdHub.
Skills são extensões que adicionam funcionalidades ao OpenClaw:
- Novas integrações
- Comandos especializados
- Automações prontas
- Workflows complexos
minha-skill/
├── SKILL.md # Obrigatório: documentação
├── package.json # Metadata
├── index.js # Código principal (opcional)
├── config.yaml # Config padrão (opcional)
└── README.md # Docs para GitHub
---
name: minha-skill
description: O que a skill faz
version: 1.0.0
author: seu-nome
tags:
- categoria
- keywords
---
# Minha Skill
## O Que Faz
Descrição do que a skill faz...
## Instalação
\`\`\`bash
clawdhub install minha-skill
\`\`\`
## Uso
Como usar a skill...
## Comandos
- "comando 1" - descrição
- "comando 2" - descrição
## Configuração
\`\`\`yaml
# config exemplo
\`\`\`
A forma mais simples - só documentação:
---
name: pomodoro
description: Técnica Pomodoro para produtividade
---
# Skill: Pomodoro
## Comandos
Quando eu disser "pomodoro":
1. Inicie timer de 25 minutos
2. Me avise quando acabar
3. Pergunte se quero pausa de 5min
Quando eu disser "pausa":
1. Timer de 5 minutos
2. Avise quando acabar
Para lógica mais complexa:
// index.js
module.exports = {
name: 'minha-skill',
// Comandos que a skill responde
commands: {
async 'meu-comando'(args, context) {
// Sua lógica aqui
return {
message: 'Resultado do comando',
data: { ... }
};
}
},
// Hooks
async onLoad(config) {
// Inicialização
},
async onMessage(message, context) {
// Interceptar mensagens
}
};
clawdhub login
cd minha-skill/
clawdhub validate
clawdhub publish
# Incremente versão no SKILL.md
clawdhub publish --update
- ✅ Explique claramente o que faz
- ✅ Dê exemplos de uso
- ✅ Documente configurações
- ✅ Liste dependências
- ✅ Trate erros graciosamente
- ✅ Valide inputs
- ✅ Use async/await
- ✅ Evite dependências desnecessárias
- ✅ Não armazene credenciais
- ✅ Valide dados externos
- ✅ Documente permissões necessárias
# Copie para skills locais
cp -r minha-skill ~/clawd/skills/
# Reinicie gateway
openclaw gateway restart
# Teste
openclaw chat "teste meu comando"
// Integra com API externa
const axios = require('axios');
module.exports = {
commands: {
async 'cotacao-dolar'() {
const res = await axios.get('https://api.exchangerate.host/latest');
return { message: `Dólar: R$ ${res.data.rates.BRL}` };
}
}
};
# Backup Semanal
Todo domingo às 3h:
1. Comprima ~/clawd/ em backup.tar.gz
2. Envie para Google Drive
3. Me confirme por Telegram
Atualmente skills são gratuitas. Modelo de monetização em discussão.