Skills e Plugins

A pergunta mais comum de novos usuários do OpenClaw é: "Qual a diferença entre Skill, Plugin e Tool?" Parecem intercambiáveis, mas operam em camadas completamente diferentes. Entender essa distinção é a chave para estender seu agente de forma eficaz.

As Três Camadas

A extensibilidade do OpenClaw é construída em três camadas que trabalham juntas em uma cadeia clara:

A cadeia funciona assim:

Plugin → pode trazer seus próprios Skills → Skills ensinam o agente a usar Tools → Tools executam ações

Tools: A Base

Tools são as 26 capacidades embutidas que permitem ao seu agente interagir com o mundo. Cada tool é classificada por nível de risco:

• Safe — Operações somente leitura como read, web_search, list_directory
• Medium — Operações de escrita como write, edit, browser
• High — Execução irrestrita como exec, shell

Você controla quais tools seu agente pode acessar via a configuração tools.allow no openclaw.json. Se você só precisa que seu agente faça buscas na web e leia arquivos, não dê acesso ao exec.

Skills: A Camada de Inteligência

Skills são a parte mais mal compreendida. Uma skill não é código. É um documento estruturado (SKILL.md) com front-matter YAML que é carregado no system prompt do agente. Ele ensina ao agente como realizar uma tarefa usando as ferramentas que ele já possui.

Por exemplo, a skill github não contém nenhum código da API do GitHub. Em vez disso, contém instruções detalhadas dizendo ao agente como usar a tool exec para executar comandos gh CLI para criar PRs, revisar código e gerenciar issues.

Skills usam progressive disclosure — o agente só carrega as instruções relevantes de skills quando elas correspondem à conversa atual, mantendo as janelas de contexto eficientes.

Plugins: A Camada da Plataforma

Plugins são código runtime real que estende o OpenClaw no nível do sistema. Existem quatro tipos:

• Channel plugins — Conectam novas plataformas de mensagens (Telegram, Discord, Slack, WhatsApp)
• Memory plugins — Adicionam backends de memória persistente (armazenamentos vetoriais, bancos de dados)
• Tool plugins — Registram capacidades de ferramentas totalmente novas além das 26 embutidas
• Provider plugins — Adicionam provedores de LLM customizados

A maioria dos usuários nunca precisa escrever um plugin. Skills e as tools embutidas cobrem a grande maioria dos casos de uso.

Skills Embutidas que Vale a Pena Conhecer

O OpenClaw vem com 53 skills de fábrica. Aqui estão as que as pessoas realmente usam:

Desenvolvimento

IA e Geração

Comunicação

Produtividade

Casa Inteligente e Mídia

Utilitários

O Ecossistema ClawHub

Além das 53 skills embutidas, o ClawHub é o marketplace da comunidade com mais de 13.700 skills. As mais populares têm adoção massiva:

• Navegação web — 180.000+ instalações
• Integração com Telegram — 145.000+ instalações

As skills no ClawHub são organizadas em categorias: AI/ML, Utilitários, Desenvolvimento, Produtividade, Web, Ciência, Mídia, Social e Finanças.

Encontrando Skills de Qualidade

Com mais de 13.700 skills, a qualidade varia drasticamente. Veja como encontrar boas opções:

MCP Tools

O OpenClaw tem suporte nativo ao Model Context Protocol (MCP), que permite conectar servidores de ferramentas externas ao seu agente. Isso é particularmente útil para integração com serviços que não têm uma skill dedicada do OpenClaw.

A configuração vai na seção mcpServers do openclaw.json:

{
  "mcpServers": {
    "google-drive": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-google-drive"]
    }
  }
}

Existem mais de 1.000 servidores MCP da comunidade disponíveis, cobrindo Google Drive, Slack, bancos de dados (PostgreSQL, MongoDB), plataformas de nuvem (AWS, GCP, Azure), e mais. Cada servidor MCP expõe seu próprio conjunto de ferramentas que seu agente pode chamar diretamente.

Segurança: O Incidente ClawHavoc

Entre janeiro e fevereiro de 2026, a comunidade OpenClaw enfrentou o ClawHavoc — um ataque coordenado à cadeia de suprimentos por meio de skills maliciosas no ClawHub. Isso não é teórico; aconteceu de verdade.

O que Aconteceu

Em 12 contas de publicadores, atacantes enviaram 1.184 skills maliciosas contendo:

• Reverse shells — dando aos atacantes acesso remoto à máquina host
• Exfiltração de dados — fazendo upload silencioso de arquivos, credenciais e variáveis de ambiente
• AMOS stealer — malware específico para macOS que visa senhas de navegadores e carteiras de criptomoedas
• Infecção persistente via MEMORY.md — injetando instruções na memória persistente do agente para que o comportamento malicioso sobrevivesse à remoção da skill

A Resposta

O OpenClaw fez parceria com o VirusTotal e removeu mais de 2.400 skills suspeitas. A verificação de publicadores foi introduzida para que os usuários pudessem distinguir publicadores verificados de uploads anônimos.

No entanto, uma auditoria posterior da Snyk descobriu que 36% das skills do ClawHub ainda contêm alguma forma de prompt injection. O VirusTotal detecta malware binário e padrões de ataque conhecidos, mas não consegue detectar prompt injection em linguagem natural — instruções escondidas dentro de uma skill que manipulam sutilmente o comportamento do agente.

Como se Proteger

Estas práticas não são opcionais se você usa skills da comunidade:

1. Audite toda skill não verificada antes de instalar. Leia o arquivo SKILL.md. É um documento de texto — leva minutos, não horas.
2. Use allowBundled para permitir apenas as skills que você precisa. Não carregue todas as 53 skills embutidas se você só usa 5.
3. Fixe versões de skills. Não atualize automaticamente skills da comunidade. Revise changelogs antes de atualizar.
4. Execute openclaw security audit regularmente. Isso escaneia skills instaladas em busca de padrões maliciosos conhecidos.
5. Minimize tools.allow. Se seu agente não precisa de acesso ao shell, não conceda exec. O raio de impacto de uma skill comprometida é limitado às ferramentas que o agente pode acessar.

Gerenciando Skills no Claw Buff

No Claw Buff, o gerenciamento de skills é feito pelo Console, em vez de editar o openclaw.json manualmente.

Ativar e desativar skills — Cada skill instalada tem um toggle na seção Agent do Console. Skills desativadas não são carregadas no contexto do agente.

Configurar API keys — Skills que precisam de credenciais de serviços externos (como spotify-player ou notion) têm campos de configuração inline onde você pode definir as variáveis de ambiente necessárias.

Buscar e instalar do ClawHub — Você pode pesquisar e instalar skills do ClawHub diretamente pelo Console sem acesso SSH ao container.

Dependências binárias — Algumas skills requerem binários externos (como ffmpeg para processamento de mídia ou gh para GitHub). Se uma skill precisa de um binário que não está pré-instalado no container, você verá um aviso de dependência durante a instalação. Entre em contato com o suporte se precisar de pacotes de sistema adicionais.