---
read_when:
    - Adicionando ou modificando Skills
    - Alterar controle de acesso de Skills, listas de permissões ou regras de carregamento
    - Entendendo a precedência de Skills e o comportamento de instantâneo
sidebarTitle: Skills
summary: Skills ensinam seu agente a usar ferramentas. Saiba como elas são carregadas, como a precedência funciona e como configurar gating, listas de permissões e injeção de ambiente.
title: Skills
x-i18n:
    generated_at: "2026-07-04T06:26:00Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 81b0f8dfc6522994b2dba865e236d1de3220fe265698506332d3139e38d9c929
    source_path: tools/skills.md
    workflow: 16
---

Skills são arquivos de instruções em markdown que ensinam ao agente como e quando usar
ferramentas. Cada skill fica em um diretório contendo um arquivo `SKILL.md` com
frontmatter YAML e um corpo em markdown. O OpenClaw carrega Skills empacotadas e
quaisquer substituições locais, e as filtra no momento do carregamento com base no ambiente, na configuração e na
presença de binários.

<CardGroup cols={2}>
  <Card title="Criando Skills" href="/pt-BR/tools/creating-skills" icon="hammer">
    Crie e teste uma skill personalizada do zero.
  </Card>
  <Card title="Oficina de Skills" href="/pt-BR/tools/skill-workshop" icon="flask">
    Revise e aprove propostas de skill redigidas por agentes.
  </Card>
  <Card title="Configuração de Skills" href="/pt-BR/tools/skills-config" icon="gear">
    Esquema completo de configuração `skills.*` e allowlists de agentes.
  </Card>
  <Card title="ClawHub" href="/clawhub" icon="cloud">
    Navegue e instale Skills da comunidade.
  </Card>
</CardGroup>

## Ordem de carregamento

O OpenClaw carrega a partir destas fontes, **da maior precedência para a menor**. Quando o mesmo
nome de skill aparece em vários lugares, a fonte de maior precedência vence.

| Prioridade  | Fonte                  | Caminho                                 |
| ----------- | ---------------------- | --------------------------------------- |
| 1 — maior   | Skills do workspace    | `<workspace>/skills`                    |
| 2           | Skills de agente do projeto | `<workspace>/.agents/skills`        |
| 3           | Skills de agente pessoais | `~/.agents/skills`                   |
| 4           | Skills gerenciadas / locais | `~/.openclaw/skills`                |
| 5           | Skills empacotadas     | enviadas com a instalação               |
| 6 — menor   | Diretórios extras      | `skills.load.extraDirs` + Skills de Plugin |

As raízes de Skills dão suporte a layouts agrupados. O OpenClaw descobre uma skill sempre que
`SKILL.md` aparece em qualquer lugar sob uma raiz configurada:

```text
<workspace>/skills/research/SKILL.md          ✓ found as "research"
<workspace>/skills/personal/research/SKILL.md ✓ also found as "research"
```

O caminho da pasta serve apenas para organização. O nome da skill, o comando de barra e a
chave de allowlist vêm todos do campo `name` do frontmatter (ou do nome do diretório
quando `name` está ausente).

<Note>
  O diretório nativo `$CODEX_HOME/skills` da Codex CLI **não** é uma raiz de
  Skills do OpenClaw. Use `openclaw migrate plan codex` para inventariar essas Skills e, em seguida,
  `openclaw migrate codex` para copiá-las para o seu workspace do OpenClaw.
</Note>

## Skills por agente vs compartilhadas

Em configurações multiagente, cada agente tem seu próprio workspace. Use o caminho que
corresponde à visibilidade desejada:

| Escopo        | Caminho                      | Visível para                |
| ------------- | ---------------------------- | --------------------------- |
| Por agente    | `<workspace>/skills`         | Apenas esse agente          |
| Agente do projeto | `<workspace>/.agents/skills` | Apenas o agente desse workspace |
| Agente pessoal | `~/.agents/skills`          | Todos os agentes nesta máquina |
| Gerenciada compartilhada | `~/.openclaw/skills` | Todos os agentes nesta máquina |
| Diretórios extras | `skills.load.extraDirs`  | Todos os agentes nesta máquina |

## Allowlists de agentes

A **localização** da skill (precedência) e a **visibilidade** da skill (qual agente pode usá-la)
são controles separados. Use allowlists para restringir quais Skills um agente vê,
independentemente de onde elas foram carregadas.

```json5
{
  agents: {
    defaults: {
      skills: ["github", "weather"], // shared baseline
    },
    list: [
      { id: "writer" }, // inherits github, weather
      { id: "docs", skills: ["docs-search"] }, // replaces defaults entirely
      { id: "locked-down", skills: [] }, // no skills
    ],
  },
}
```

<AccordionGroup>
  <Accordion title="Regras de allowlist">
    - Omita `agents.defaults.skills` para deixar todas as Skills sem restrição por padrão.
    - Omita `agents.list[].skills` para herdar `agents.defaults.skills`.
    - Defina `agents.list[].skills: []` para não expor nenhuma skill a esse agente.
    - Uma lista `agents.list[].skills` não vazia é o conjunto **final** — ela não
      mescla com os padrões.
    - A allowlist efetiva se aplica à construção de prompts, descoberta de
      comandos de barra, sincronização de sandbox e snapshots de Skills.
    - Isso não é uma fronteira de autorização do shell do host. Se o mesmo agente puder
      usar `exec`, restrinja esse shell separadamente com sandboxing, isolamento de usuário do SO,
      deny/allowlists de exec e credenciais por recurso.
  </Accordion>
</AccordionGroup>

## Plugins e Skills

Plugins podem enviar suas próprias Skills listando diretórios `skills` em
`openclaw.plugin.json` (caminhos relativos à raiz do Plugin). Skills de Plugin são carregadas
quando o Plugin está habilitado — por exemplo, o Plugin de navegador envia uma skill
`browser-automation` para controle de navegador em várias etapas.

Diretórios de Skills de Plugin são mesclados no mesmo nível de baixa precedência de
`skills.load.extraDirs`, portanto uma skill empacotada, gerenciada, de agente ou de workspace
com o mesmo nome os substitui. Controle-os via `metadata.openclaw.requires.config` na
entrada de configuração do Plugin.

Veja [Plugins](/pt-BR/tools/plugin) e [Ferramentas](/pt-BR/tools) para o sistema completo de Plugins.

## Oficina de Skills

[Oficina de Skills](/pt-BR/tools/skill-workshop) é uma fila de propostas entre o agente
e seus arquivos de skill ativos. Quando o agente identifica trabalho reutilizável, ele redige uma
proposta em vez de escrever diretamente em `SKILL.md`. Você revisa e aprova
antes que qualquer coisa mude.

```bash
openclaw skills workshop list
openclaw skills workshop inspect <proposal-id>
openclaw skills workshop apply <proposal-id>
```

Veja [Oficina de Skills](/pt-BR/tools/skill-workshop) para o ciclo de vida completo, a referência da CLI
e a configuração.

## Instalando a partir do ClawHub

[ClawHub](https://clawhub.ai) é o registro público de Skills. Use comandos
`openclaw skills` para instalar e atualizar, ou a CLI `clawhub` para
publicar e sincronizar.

| Ação                               | Comando                                                |
| ---------------------------------- | ------------------------------------------------------ |
| Instalar uma skill no workspace    | `openclaw skills install @owner/<slug>`                |
| Instalar a partir de um repositório Git | `openclaw skills install git:owner/repo@ref`       |
| Instalar um diretório local de skill | `openclaw skills install ./path/to/skill --as my-tool` |
| Instalar para todos os agentes locais | `openclaw skills install @owner/<slug> --global`    |
| Atualizar todas as Skills do workspace | `openclaw skills update --all`                      |
| Atualizar uma skill gerenciada compartilhada | `openclaw skills update @owner/<slug> --global` |
| Atualizar todas as Skills gerenciadas compartilhadas | `openclaw skills update --all --global`    |
| Verificar o envelope de confiança de uma skill | `openclaw skills verify @owner/<slug>`       |
| Imprimir o Skill Card gerado       | `openclaw skills verify @owner/<slug> --card`          |
| Publicar / sincronizar via CLI do ClawHub | `clawhub sync --all`                              |

<AccordionGroup>
  <Accordion title="Detalhes de instalação">
    `openclaw skills install` instala no diretório `skills/` do workspace ativo
    por padrão. Adicione `--global` para instalar no diretório compartilhado
    `~/.openclaw/skills`, visível a todos os agentes locais, a menos que allowlists de agentes
    o restrinjam.

    Instalações via Git e locais esperam `SKILL.md` na raiz da origem. O slug vem
    do `name` do frontmatter de `SKILL.md` quando válido, depois recai para o
    nome do diretório ou repositório. Use `--as <slug>` para substituir.
    `openclaw skills update` rastreia apenas instalações do ClawHub — reinstale origens Git ou
    locais para atualizá-las.

  </Accordion>
  <Accordion title="Verificação e varredura de segurança">
    `openclaw skills verify @owner/<slug>` pede ao ClawHub o envelope de confiança
    `clawhub.skill.verify.v1` da skill. Skills do ClawHub instaladas são verificadas
    contra a versão e o registro gravados em `.clawhub/origin.json`.
    Slugs simples continuam aceitos para Skills existentes instaladas ou inequívocas, mas
    referências qualificadas por proprietário evitam ambiguidade de publicador.

    Páginas de Skills do ClawHub expõem o estado mais recente da varredura de segurança antes da instalação,
    com páginas de detalhes para VirusTotal, ClawScan e análise estática. O
    comando sai com valor diferente de zero quando o ClawHub marca a verificação como falha. Publicadores
    recuperam falsos positivos pelo painel do ClawHub ou por
    `clawhub skill rescan @owner/<slug>`.

  </Accordion>
  <Accordion title="Instalações de arquivo privado">
    Clientes Gateway que precisam de entrega fora do ClawHub podem preparar um arquivo zip de skill
    com `skills.upload.begin`, `skills.upload.chunk` e `skills.upload.commit`,
    depois instalar com `skills.install({ source: "upload", ... })`. Esse caminho fica
    desativado por padrão e requer `skills.install.allowUploadedArchives: true` em
    `openclaw.json`. Instalações normais do ClawHub nunca precisam dessa configuração.
  </Accordion>
</AccordionGroup>

## Segurança

<Warning>
  Trate Skills de terceiros como **código não confiável**. Leia-as antes de habilitar.
  Prefira execuções em sandbox para entradas não confiáveis e ferramentas arriscadas. Veja
  [Sandboxing](/pt-BR/gateway/sandboxing) para controles do lado do agente.
</Warning>

<AccordionGroup>
  <Accordion title="Contenção de caminho">
    A descoberta de Skills de workspace, agente do projeto e diretório extra aceita apenas raízes de skill
    cujo realpath resolvido permanece dentro da raiz configurada, a menos que
    `skills.load.allowSymlinkTargets` confie explicitamente em uma raiz de destino.
    A Oficina de Skills escreve por esses destinos confiáveis apenas quando
    `skills.workshop.allowSymlinkTargetWrites` está habilitado.
    `~/.openclaw/skills` gerenciadas e `~/.agents/skills` pessoais podem conter
    pastas de skill com symlink, mas todo realpath de `SKILL.md` ainda deve permanecer
    dentro de seu diretório de skill resolvido.
  </Accordion>
  <Accordion title="Política de instalação do operador">
    Configure `security.installPolicy` para executar um comando de política local confiável
    antes que instalações de skill continuem. A política recebe metadados e o caminho de origem
    preparado, aplica-se a caminhos do ClawHub, upload, Git, locais, atualização e
    instalador de dependências, e falha de modo fechado quando o comando não consegue retornar
    uma decisão válida.
  </Accordion>
  <Accordion title="Escopo de injeção de segredos">
    `skills.entries.*.env` e `skills.entries.*.apiKey` injetam segredos no
    processo **host** apenas para aquele turno do agente — não no sandbox. Mantenha
    segredos fora de prompts e logs.
  </Accordion>
</AccordionGroup>

Para o modelo de ameaças mais amplo e checklists de segurança, veja
[Segurança](/pt-BR/gateway/security).

## Formato de SKILL.md

Toda skill precisa, no mínimo, de um `name` e uma `description` no frontmatter:

```markdown
---
name: image-lab
description: Generate or edit images via a provider-backed image workflow
---

When the user asks to generate an image, use the `image_generate` tool...
```

<Note>
  O OpenClaw segue a especificação [AgentSkills](https://agentskills.io). O
  parser de frontmatter dá suporte a **chaves de linha única apenas** — `metadata` deve ser um
  objeto JSON de linha única. Use `{baseDir}` no corpo para referenciar o caminho da pasta
  da skill.
</Note>

### Chaves opcionais de frontmatter

<ParamField path="homepage" type="string">
  URL mostrada como "Site" na UI de Skills do macOS. Também compatível via
  `metadata.openclaw.homepage`.
</ParamField>

<ParamField path="user-invocable" type="boolean" default="true">
  Quando `true`, a skill é exposta como um comando de barra invocável pelo usuário.
</ParamField>

<ParamField path="disable-model-invocation" type="boolean" default="false">
  Quando `true`, o OpenClaw mantém as instruções da skill fora do prompt normal
  do agente. A skill ainda fica disponível como comando de barra quando `user-invocable`
  também é `true`.
</ParamField>

<ParamField path="command-dispatch" type='"tool"'>
  Quando definido como `tool`, o comando de barra ignora o modelo e despacha
  diretamente para uma ferramenta registrada.
</ParamField>

<ParamField path="command-tool" type="string">
  Nome da ferramenta a invocar quando `command-dispatch: tool` estiver definido.
</ParamField>

<ParamField path="command-arg-mode" type='"raw"' default="raw">
  Para despacho de ferramentas, encaminha a string bruta de argumentos para a ferramenta sem
  análise do core. A ferramenta recebe
  `{ command: "<raw args>", commandName: "<slash command>", skillName: "<skill name>" }`.
</ParamField>

## Critérios de elegibilidade

O OpenClaw filtra habilidades no momento do carregamento usando `metadata.openclaw` (JSON
de linha única no frontmatter). Uma habilidade sem bloco `metadata.openclaw` é sempre
elegível, a menos que seja desabilitada explicitamente.

```markdown
---
name: image-lab
description: Generate or edit images via a provider-backed image workflow
metadata:
  {
    "openclaw":
      {
        "requires": { "bins": ["uv"], "env": ["GEMINI_API_KEY"], "config": ["browser.enabled"] },
        "primaryEnv": "GEMINI_API_KEY",
      },
  }
---
```

<ParamField path="always" type="boolean">
  Quando `true`, sempre inclui a habilidade e ignora todos os outros critérios.
</ParamField>

<ParamField path="emoji" type="string">
  Emoji opcional mostrado na UI de Skills do macOS.
</ParamField>

<ParamField path="homepage" type="string">
  URL opcional mostrada como "Site" na UI de Skills do macOS.
</ParamField>

<ParamField path="os" type='"darwin" | "linux" | "win32"'>
  Filtro de plataforma. Quando definido, a habilidade só é elegível nos sistemas operacionais listados.
</ParamField>

<ParamField path="requires.bins" type="string[]">
  Cada binário precisa existir no `PATH`.
</ParamField>

<ParamField path="requires.anyBins" type="string[]">
  Pelo menos um binário precisa existir no `PATH`.
</ParamField>

<ParamField path="requires.env" type="string[]">
  Cada variável de ambiente precisa existir no processo ou ser fornecida via configuração.
</ParamField>

<ParamField path="requires.config" type="string[]">
  Cada caminho de `openclaw.json` precisa ser verdadeiro.
</ParamField>

<ParamField path="primaryEnv" type="string">
  Nome da variável de ambiente associada a `skills.entries.<name>.apiKey`.
</ParamField>

<ParamField path="install" type="object[]">
  Especificações opcionais de instalador usadas pela UI de Skills do macOS (brew / node / go / uv / download).
</ParamField>

<Note>
  Blocos legados `metadata.clawdbot` ainda são aceitos quando
  `metadata.openclaw` está ausente, para que habilidades instaladas antigas mantenham seus
  critérios de dependência e dicas de instalador. Novas habilidades devem usar
  `metadata.openclaw`.
</Note>

### Especificações de instalador

As especificações de instalador informam à UI de Skills do macOS como instalar uma dependência:

```markdown
---
name: gemini
description: Use Gemini CLI for coding assistance and Google search lookups.
metadata:
  {
    "openclaw":
      {
        "emoji": "♊️",
        "requires": { "bins": ["gemini"] },
        "install":
          [
            {
              "id": "brew",
              "kind": "brew",
              "formula": "gemini-cli",
              "bins": ["gemini"],
              "label": "Install Gemini CLI (brew)",
            },
          ],
      },
  }
---
```

<AccordionGroup>
  <Accordion title="Regras de seleção de instalador">
    - Quando vários instaladores são listados, o Gateway escolhe uma opção
      preferida (brew quando disponível; caso contrário, node).
    - Se todos os instaladores forem `download`, o OpenClaw lista cada entrada para que você possa
      ver todos os artefatos disponíveis.
    - As especificações podem incluir `os: ["darwin"|"linux"|"win32"]` para filtrar por plataforma.
    - Instalações de Node respeitam `skills.install.nodeManager` em `openclaw.json`
      (padrão: npm; opções: npm / pnpm / yarn / bun). Isso afeta apenas instalações de
      habilidades; o runtime do Gateway ainda deve ser Node.
    - Preferência de instalador do Gateway: Homebrew → uv → gerenciador de node configurado →
      go → download.
  </Accordion>
  <Accordion title="Detalhes por instalador">
    - **Homebrew:** O OpenClaw não instala o Homebrew automaticamente nem traduz fórmulas do brew
      em comandos de pacotes do sistema. Em contêineres Linux sem
      `brew`, instaladores apenas de brew ficam ocultos; use uma imagem personalizada ou instale
      a dependência manualmente.
    - **Go:** O OpenClaw exige Go 1.21 ou mais recente para instalações automáticas de habilidades e
      preserva as configurações existentes de `GOBIN`, `GOPATH` e `GOTOOLCHAIN`. Se a
      toolchain configurada não puder satisfazer a versão de Go exigida por um módulo,
      o onboarding agrupa a habilidade com pré-requisitos manuais de Go após a tentativa de
      instalação. Se `go` estiver ausente e Homebrew estiver disponível, o OpenClaw instala
      Go primeiro via Homebrew e define `GOBIN` como o `bin` do Homebrew. No Linux,
      o OpenClaw pode, em vez disso, usar `apt-get` como root ou por meio de `sudo` sem senha
      quando o candidato `golang-go` atualizado atende à versão mínima.
    - **Download:** `url` (obrigatório), `archive` (`tar.gz` | `tar.bz2` | `zip`),
      `extract` (padrão: automático quando um arquivo compactado é detectado), `stripComponents`,
      `targetDir` (padrão: `~/.openclaw/tools/<skillKey>`).
  </Accordion>
  <Accordion title="Notas de sandboxing">
    `requires.bins` é verificado no **host** no momento do carregamento da habilidade. Se um agente
    for executado em uma sandbox, o binário também precisa existir **dentro do contêiner**.
    Instale-o via `agents.defaults.sandbox.docker.setupCommand` ou uma imagem
    personalizada. `setupCommand` é executado uma vez após a criação do contêiner e exige
    egresso de rede, um sistema de arquivos raiz gravável e um usuário root na sandbox.
  </Accordion>
</AccordionGroup>

## Substituições de configuração

Alterne e configure habilidades incluídas ou gerenciadas em `skills.entries` em
`~/.openclaw/openclaw.json`:

```json5
{
  skills: {
    entries: {
      "image-lab": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" },
        env: { GEMINI_API_KEY: "GEMINI_KEY_HERE" },
        config: {
          endpoint: "https://example.invalid",
          model: "nano-pro",
        },
      },
      peekaboo: { enabled: true },
      sag: { enabled: false },
    },
  },
}
```

<ParamField path="enabled" type="boolean">
  `false` desabilita a habilidade mesmo quando ela está incluída ou instalada. A habilidade incluída
  `coding-agent` é opt-in — defina `skills.entries.coding-agent.enabled: true`
  e garanta que um dos CLIs `claude`, `codex`, `opencode` ou outro compatível
  esteja instalado e autenticado.
</ParamField>

<ParamField path="apiKey" type='string | { source, provider, id }'>
  Campo de conveniência para habilidades que declaram `metadata.openclaw.primaryEnv`.
  Aceita uma string em texto simples ou um objeto SecretRef.
</ParamField>

<ParamField path="env" type="Record<string, string>">
  Variáveis de ambiente injetadas para a execução do agente. Só são injetadas quando a
  variável ainda não está definida no processo.
</ParamField>

<ParamField path="config" type="object">
  Contêiner opcional para campos personalizados de configuração por habilidade.
</ParamField>

<ParamField path="allowBundled" type="string[]">
  Allowlist opcional apenas para habilidades **incluídas**. Quando definida, somente habilidades incluídas
  na lista são elegíveis. Habilidades gerenciadas e do workspace não são afetadas.
</ParamField>

<Note>
  As chaves de configuração correspondem ao **nome da habilidade** por padrão. Se uma habilidade define
  `metadata.openclaw.skillKey`, use essa chave em `skills.entries`. Coloque nomes
  hifenizados entre aspas: JSON5 permite chaves com aspas.
</Note>

## Injeção de ambiente

Quando uma execução de agente começa, o OpenClaw:

<Steps>
  <Step title="Lê metadados de habilidades">
    O OpenClaw resolve a lista efetiva de habilidades para o agente, aplicando regras de
    elegibilidade, allowlists e substituições de configuração.
  </Step>
  <Step title="Injeta ambiente e chaves de API">
    `skills.entries.<key>.env` e `skills.entries.<key>.apiKey` são aplicados a
    `process.env` pela duração da execução.
  </Step>
  <Step title="Cria o prompt do sistema">
    Habilidades elegíveis são compiladas em um bloco XML compacto e injetadas no
    prompt do sistema.
  </Step>
  <Step title="Restaura o ambiente">
    Após o término da execução, o ambiente original é restaurado.
  </Step>
</Steps>

<Warning>
  A injeção de ambiente tem escopo na execução do agente no **host**, não na sandbox. Dentro de uma
  sandbox, `env` e `apiKey` não têm efeito. Consulte
  [Configuração de Skills](/pt-BR/tools/skills-config#sandboxed-skills-and-env-vars) para saber como
  passar segredos para execuções em sandbox.
</Warning>

Para o backend incluído `claude-cli`, o OpenClaw também materializa o mesmo
snapshot de habilidades elegíveis como um Plugin temporário do Claude Code e o passa via
`--plugin-dir`. Outros backends de CLI usam apenas o catálogo do prompt.

## Snapshots e atualização

O OpenClaw gera snapshots de habilidades elegíveis **quando uma sessão começa** e reutiliza essa
lista em todos os turnos subsequentes da sessão. Alterações em habilidades ou configuração entram
em vigor na próxima nova sessão.

Skills são atualizadas no meio da sessão em dois casos:

- O observador de habilidades detecta uma alteração em `SKILL.md`.
- Um novo nó remoto elegível se conecta.

A lista atualizada é usada no próximo turno do agente. Se a allowlist efetiva do agente
mudar, o OpenClaw atualiza o snapshot para manter as habilidades visíveis
alinhadas.

<AccordionGroup>
  <Accordion title="Observador de Skills">
    Por padrão, o OpenClaw observa pastas de habilidades e incrementa o snapshot quando
    arquivos `SKILL.md` mudam. Configure em `skills.load`:

    ```json5
    {
      skills: {
        load: {
          extraDirs: ["~/Projects/agent-scripts/skills"],
          allowSymlinkTargets: ["~/Projects/manager/skills"],
          watch: true,
          watchDebounceMs: 250,
        },
      },
    }
    ```

    Use `allowSymlinkTargets` para layouts intencionalmente vinculados por symlink em que uma symlink
    da raiz de uma habilidade aponta para fora da raiz configurada, por exemplo
    `<workspace>/skills/manager -> ~/Projects/manager/skills`.
    Habilite `skills.workshop.allowSymlinkTargetWrites` apenas quando o Skill Workshop
    também deve aplicar propostas por esses caminhos confiáveis vinculados por symlink.

  </Accordion>
  <Accordion title="Nós macOS remotos (Gateway Linux)">
    Se o Gateway roda no Linux, mas um **nó macOS** está conectado com
    `system.run` permitido, o OpenClaw pode tratar habilidades exclusivas de macOS como elegíveis quando
    os binários exigidos estiverem presentes nesse nó. O agente deve executar essas
    habilidades via ferramenta `exec` com `host=node`.

    Nós offline **não** tornam habilidades apenas remotas visíveis. Se um nó para de
    responder a sondagens de binários, o OpenClaw limpa suas correspondências de binários em cache.

  </Accordion>
</AccordionGroup>

## Impacto em tokens

Quando habilidades são elegíveis, o OpenClaw injeta um bloco XML compacto no prompt do sistema.
O custo é determinístico:

```text
total = 195 + Σ (97 + len(name) + len(description) + len(filepath))
```

- **Sobrecarga base** (apenas quando ≥ 1 habilidade): ~195 caracteres
- **Por habilidade:** ~97 caracteres + os comprimentos dos campos `name`, `description` e `location`
- O escape de XML expande `& < > " '` em entidades, adicionando alguns caracteres por ocorrência
- Com ~4 caracteres/token, 97 caracteres ≈ 24 tokens por habilidade antes dos comprimentos dos campos

Mantenha as descrições curtas e descritivas para minimizar a sobrecarga do prompt.

## Relacionado

<CardGroup cols={2}>
  <Card title="Criando habilidades" href="/pt-BR/tools/creating-skills" icon="hammer">
    Guia passo a passo para criar uma habilidade personalizada.
  </Card>
  <Card title="Skill Workshop" href="/pt-BR/tools/skill-workshop" icon="flask">
    Fila de propostas para habilidades rascunhadas por agentes.
  </Card>
  <Card title="Configuração de Skills" href="/pt-BR/tools/skills-config" icon="gear">
    Esquema completo de configuração `skills.*` e allowlists de agentes.
  </Card>
  <Card title="Comandos slash" href="/pt-BR/tools/slash-commands" icon="terminal">
    Como comandos slash de habilidades são registrados e roteados.
  </Card>
  <Card title="ClawHub" href="/clawhub" icon="cloud">
    Navegue e publique habilidades no registro público.
  </Card>
  <Card title="Plugins" href="/pt-BR/tools/plugin" icon="plug">
    Plugins podem enviar habilidades junto com as ferramentas que documentam.
  </Card>
</CardGroup>