Pular para o conteúdo principal
Skills ensinam ao agente como e quando usar ferramentas. Cada habilidade é um diretório contendo um arquivo SKILL.md com frontmatter YAML e instruções em markdown. O OpenClaw carrega Skills de várias raízes em uma ordem de precedência definida.

​
Crie sua primeira habilidade

1

Crie o diretório da habilidade

Skills ficam na pasta skills/ do seu workspace. Crie um diretório para sua nova habilidade:
mkdir -p ~/.openclaw/workspace/skills/hello-world
Você pode agrupar Skills em subpastas para organização — a habilidade ainda é nomeada pelo frontmatter do SKILL.md, não pelo caminho da pasta:
mkdir -p ~/.openclaw/workspace/skills/personal/hello-world
# skill name is still "hello-world", invoked as /hello-world
2

Escreva o SKILL.md

Crie SKILL.md dentro do diretório. O frontmatter define metadados; o corpo fornece instruções ao agente.
---
name: hello-world
description: A simple skill that prints a greeting.
---

# Hello World

When the user asks for a greeting, use the `exec` tool to run:

```bash
echo "Hello from your custom skill!"


Regras de nomenclatura:
- Use letras minúsculas, dígitos e hífens para `name`.
- Mantenha o nome do diretório e o `name` do frontmatter alinhados.
- `description` é exibido para o agente e na descoberta de comandos de barra —
  mantenha em uma linha e com menos de 160 caracteres.

</Step>

<Step title="Verifique se a habilidade foi carregada">
```bash
openclaw skills list
Por padrão, o OpenClaw monitora arquivos SKILL.md nas raízes de Skills. Se o monitor estiver desativado ou você estiver continuando uma sessão existente, inicie uma nova para que o agente receba a lista atualizada:
# From chat — archive current session and start fresh
/new

# Or restart the gateway
openclaw gateway restart
3

Teste

Envie uma mensagem que deve acionar a habilidade:
openclaw agent --message "give me a greeting"
Ou abra um chat e pergunte diretamente ao agente. Use /skill hello-world para invocá-la explicitamente pelo nome.

​
Referência do SKILL.md

​
Campos obrigatórios

CampoDescrição
nameSlug único usando letras minúsculas, dígitos e hífens
descriptionDescrição em uma linha exibida ao agente e na saída de descoberta

​
Chaves opcionais do frontmatter

CampoPadrãoDescrição
user-invocabletrueExpõe a habilidade como um comando de barra do usuário
disable-model-invocationfalseMantém a habilidade fora do prompt de sistema do agente (ainda executa via /skill)
command-dispatch—Defina como tool para rotear o comando de barra diretamente para uma ferramenta, ignorando o modelo
command-tool—Nome da ferramenta a invocar quando command-dispatch: tool estiver definido
command-arg-moderawPara despacho de ferramenta, encaminha a string de argumentos bruta para a ferramenta
homepage—URL exibida como “Site” na UI de Skills do macOS
Para campos de controle de acesso (requires.bins, requires.env etc.), veja Skills — Controle de acesso.

​
Usando {baseDir}

Use {baseDir} no corpo da habilidade para referenciar arquivos dentro do diretório da habilidade sem codificar caminhos fixos: 
Run the helper script at `{baseDir}/scripts/run.sh`.

​
Adicionando ativação condicional

Restrinja sua habilidade para que ela só carregue quando suas dependências estiverem disponíveis: 
---
name: gemini-search
description: Search using Gemini CLI.
metadata: { "openclaw": { "requires": { "bins": ["gemini"] }, "primaryEnv": "GEMINI_API_KEY" } }
---
ChaveDescrição
requires.binsTodos os binários devem existir no PATH
requires.anyBinsPelo menos um binário deve existir no PATH
requires.envCada variável de ambiente deve existir no processo ou na configuração
requires.configCada caminho de openclaw.json deve ser verdadeiro
osFiltro de plataforma: ["darwin"], ["linux"], ["win32"]
alwaysDefina como true para ignorar todos os controles e sempre incluir a habilidade
Referência completa: Skills — Controle de acesso.
Vincule uma chave de API a uma entrada de habilidade em openclaw.json:
{
  skills: {
    entries: {
      "gemini-search": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" },
      },
    },
  },
}
A chave é injetada no processo host apenas para aquela rodada do agente. Ela não chega ao sandbox — veja variáveis de ambiente em sandbox.

​
Proponha via Workshop de Habilidades

Para Skills redigidas pelo agente ou quando você quiser revisão do operador antes de uma habilidade entrar em produção, use propostas do Workshop de Habilidades em vez de escrever SKILL.md diretamente. 
# Propose a brand-new skill
openclaw skills workshop propose-create \
  --name "hello-world" \
  --description "A simple skill that prints a greeting." \
  --proposal ./PROPOSAL.md

# Propose an update to an existing skill
openclaw skills workshop propose-update hello-world \
  --proposal ./PROPOSAL.md \
  --description "Updated greeting skill"
Use --proposal-dir quando a proposta incluir arquivos de suporte: 
openclaw skills workshop propose-create \
  --name "hello-world" \
  --description "A simple skill that prints a greeting." \
  --proposal-dir ./hello-world-proposal/
O diretório deve conter PROPOSAL.md. Arquivos de suporte podem ficar em assets/, examples/, references/, scripts/ ou templates/. Após a revisão: 
openclaw skills workshop inspect <proposal-id>
openclaw skills workshop apply <proposal-id>
Veja Workshop de Habilidades para o ciclo de vida completo da proposta.

​
Publicando no ClawHub

1

Garanta que seu SKILL.md esteja completo

Certifique-se de que name, description e quaisquer campos de controle metadata.openclaw estejam definidos. Adicione uma URL homepage se você tiver uma página do projeto.
2

Instale a habilidade do ClawHub

A habilidade do ClawHub documenta o formato atual do comando de publicação e os metadados obrigatórios:
openclaw skills install @openclaw/clawhub-publish
3

Publique

clawhub publish
Veja ClawHub — Publicação para o fluxo completo.

​
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 habilidade 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 "..." antes de compartilhar.
  • Use o ClawHub — navegue pelas Skills da comunidade em clawhub.ai antes de criar do zero.

​
Relacionados

Referência de Skills

Ordem de carregamento, controle de acesso, allowlists e formato do SKILL.md.

Workshop de Habilidades

Fila de propostas para Skills redigidas pelo agente.

Configuração de Skills

Esquema completo de configuração skills.*.

ClawHub

Navegue e publique Skills no registro público.

Criando plugins

Plugins podem distribuir Skills junto com as ferramentas que documentam.