Skills ensinam ao agente como e quando usar ferramentas. Cada Skill é um diretório contendo um arquivoDocumentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
SKILL.md com frontmatter YAML e instruções em markdown.
Para saber como Skills são carregadas e priorizadas, consulte Skills.
Crie sua primeira Skill
Escreva SKILL.md
Crie Use formato com hífens, letras minúsculas, dígitos e hífens para o
SKILL.md dentro desse diretório. O frontmatter define os metadados,
e o corpo em markdown contém instruções para o agente.name
da Skill. Mantenha o nome da pasta alinhado ao name do frontmatter.Adicione ferramentas (opcional)
Você pode definir esquemas de ferramentas personalizados no frontmatter ou instruir o agente
a usar ferramentas do sistema existentes (como
exec ou browser). Skills também podem
ser distribuídas dentro de plugins junto com as ferramentas que documentam.Carregue a Skill
Inicie uma nova sessão para que o OpenClaw detecte a Skill:Verifique se a Skill foi carregada:
Referência de metadados da Skill
O frontmatter YAML aceita estes campos:| Campo | Obrigatório | Descrição |
|---|---|---|
name | Sim | Identificador único usando letras minúsculas, dígitos e hífens |
description | Sim | Descrição de uma linha mostrada ao agente |
metadata.openclaw.os | Não | Filtro de SO (["darwin"], ["linux"], etc.) |
metadata.openclaw.requires.bins | Não | Binários obrigatórios no PATH |
metadata.openclaw.requires.config | Não | Chaves de configuração obrigatórias |
Práticas recomendadas
- Seja conciso — instrua o modelo sobre o que fazer, não sobre como ser uma IA
- Segurança em primeiro lugar — se sua Skill usa
exec, garanta que os prompts não permitam injeção arbitrária de comandos a partir de entrada não confiável - Teste localmente — use
openclaw agent --message "..."para testar antes de compartilhar - Use ClawHub — navegue e contribua com Skills em ClawHub
Onde Skills ficam
| Localização | Precedência | Escopo |
|---|---|---|
\<workspace\>/skills/ | Mais alta | Por agente |
\<workspace\>/.agents/skills/ | Alta | Agente por workspace |
~/.agents/skills/ | Média | Perfil de agente compartilhado |
~/.openclaw/skills/ | Média | Compartilhado (todos os agentes) |
| Incluído (distribuído com o OpenClaw) | Baixa | Global |
skills.load.extraDirs | Mais baixa | Pastas compartilhadas personalizadas |
Relacionado
- Referência de Skills — regras de carregamento, precedência e controle
- Configuração de Skills — esquema de configuração
skills.* - ClawHub — registro público de Skills
- Criação de Plugins — plugins podem distribuir Skills