Habilidades do Clawdbot

Visão geral das habilidades do Clawdbot

O Clawdbot usa pastas de habilidades compatíveis com AgentSkills para ensinar o agente a usar ferramentas. Cada habilidade é um diretório contendo um SKILL.md com frontmatter YAML e instruções.

O Clawdbot carrega habilidades empacotadas mais substituições locais opcionais, e as filtra no momento do carregamento com base no ambiente, configuração e presença de binários.

Locais das habilidades e precedência

As habilidades são carregadas de três lugares:

Precedência (da maior para a menor):

1. <workspace>/skills
2. ~/.clawdbot/skills
3. Habilidades empacotadas

Você pode configurar pastas de habilidades extras via skills.load.extraDirs em ~/.clawdbot/clawdbot.json.

Habilidades por agente vs compartilhadas

Em configurações multi-agente:

• Habilidades por agente: Ficam em <workspace>/skills apenas para aquele agente
• Habilidades compartilhadas: Ficam em ~/.clawdbot/skills e são visíveis para todos os agentes

ClawHub (Instalar + Sincronizar)

ClawHub é o registro público de habilidades para o Clawdbot. Navegue em https://clawhub.com.

Fluxos comuns:

# Instalar uma habilidade no seu workspace
clawhub install <skill-slug>

# Atualizar todas as habilidades instaladas
clawhub update --all

# Sincronizar (escanear + publicar atualizações)
clawhub sync --all

Por padrão, clawhub instala em ./skills sob seu diretório de trabalho atual.

Formato da habilidade

SKILL.md deve incluir pelo menos:

---
name: my-skill
description: What this skill does
---

Instructions for the agent...

Chaves opcionais do frontmatter

Gating (filtros no momento do carregamento)

Filtre habilidades no momento do carregamento usando metadados:

---
name: my-skill
description: My skill description
metadata: {"openclaw": {"requires": {"bins": ["uv"], "env": ["API_KEY"], "config": ["browser.enabled"]}}}
---

Campos de gating

Substituições de configuração

Substitua configurações de habilidades em ~/.clawdbot/clawdbot.json:

{
  "skills": {
    "entries": {
      "my-skill": {
        "enabled": true,
        "env": {
          "API_KEY": "your-key"
        }
      }
    }
  }
}

Notas de segurança

• Trate habilidades de terceiros como código não confiável
• Leia as habilidades antes de habilitá-las
• Prefira execuções em sandbox para entradas não confiáveis
• Mantenha segredos fora de prompts e logs

Plugins + Habilidades

Plugins podem enviar suas próprias habilidades listando diretórios de habilidades em clawdbot.plugin.json. As habilidades do plugin são carregadas quando o plugin está habilitado.

Observador de habilidades (atualização automática)

O Clawdbot observa diretórios de habilidades em busca de alterações e atualiza automaticamente quando habilidades são adicionadas, modificadas ou removidas.

Próximos passos

• Comandos de barra do Clawdbot - Referência de comandos
• Ferramentas do Clawdbot - Configuração de ferramentas
• Gateway do Clawdbot - Configuração do gateway