Pular para o conteúdo principal

​
Criando Skills

Skills ensinam o agent como e quando usar ferramentas. Cada Skill é um diretório que contém um arquivo SKILL.md com frontmatter YAML e instruções em markdown. Para saber como as Skills são carregadas e priorizadas, consulte Skills.

​
Crie sua primeira Skill

1

Crie o diretório da Skill

As Skills ficam no seu workspace. Crie uma nova pasta:
mkdir -p ~/.openclaw/workspace/skills/hello-world
2

Escreva o SKILL.md

Crie SKILL.md dentro desse diretório. O frontmatter define os metadados, e o corpo em markdown contém instruções para o agent.
---
name: hello_world
description: A simple skill that says hello.
---

# Hello World Skill

When the user asks for a greeting, use the `echo` tool to say
"Hello from your custom skill!".
3

Adicione ferramentas (opcional)

Você pode definir schemas de ferramentas personalizadas no frontmatter ou instruir o agent a usar ferramentas de sistema existentes (como exec ou browser). As Skills também podem ser distribuídas dentro de plugins junto com as ferramentas que documentam.
4

Carregue a Skill

Inicie uma nova sessão para que o OpenClaw detecte a Skill:
# Do chat
/new

# Ou reinicie o gateway
openclaw gateway restart
Verifique se a Skill foi carregada:
openclaw skills list
5

Teste

Envie uma mensagem que deve acionar a Skill:
openclaw agent --message "give me a greeting"
Ou simplesmente converse com o agent e peça uma saudação.

​
Referência de metadados de Skill

O frontmatter YAML oferece suporte a estes campos:
CampoObrigatórioDescrição
nameSimIdentificador único (snake_case)
descriptionSimDescrição de uma linha exibida ao agent
metadata.openclaw.osNãoFiltro de SO (["darwin"], ["linux"] etc.)
metadata.openclaw.requires.binsNãoBinários obrigatórios no PATH
metadata.openclaw.requires.configNãoChaves de config obrigatórias

​
Boas práticas

  • Seja conciso — instrua o modelo sobre o que fazer, não sobre como ser uma IA
  • Segurança em primeiro lugar — se sua Skill usar 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 o ClawHub — explore e contribua com Skills em ClawHub

​
Onde as Skills ficam

LocalPrecedênciaEscopo
\<workspace\>/skills/Mais altaPor agent
\<workspace\>/.agents/skills/AltaPor agent do workspace
~/.agents/skills/MédiaPerfil de agent compartilhado
~/.openclaw/skills/MédiaCompartilhado (todos os agents)
Empacotadas (distribuídas com o OpenClaw)BaixaGlobal
skills.load.extraDirsMais baixaPastas compartilhadas personalizadas

​
Relacionado