O ClawHub é o registro público de skills e plugins do OpenClaw. Use openclaw skills para descobrir, instalar e atualizar skills. Para autenticar sua conta e publicar, use a CLI separada clawhub.

Site: clawhub.ai. O endereço antigo clawhub.com redireciona para esse site.

Referência dos exemplos: OpenClaw 2026.10.2 e ClawHub CLI 0.23.3, conferidos em 12 de outubro de 2026. Os comandos de instalação também aparecem na referência dessa versão do OpenClaw. Em outra versão, confira openclaw --version e openclaw skills --help antes de continuar.

Descobrindo Skills

Abra o site e confira a página do skill antes de instalar. Verifique:

  • o autor e o repositório de origem;
  • a versão e as alterações publicadas;
  • as instruções no arquivo SKILL.md;
  • as credenciais, permissões e dependências exigidas;
  • o resultado da auditoria e os avisos apresentados.

Downloads e estrelas ajudam a conhecer o uso de um skill. Eles não comprovam segurança nem substituem a revisão das instruções.

Buscando Skills

Também é possível pesquisar pela CLI do OpenClaw:

openclaw skills search "pdf"

Escolha uma referência no formato @owner/<slug>. Nos exemplos abaixo, @autor/nome-do-skill é um marcador: substitua pelo autor e pelo nome exatos do skill escolhido.

Instalando Skills

Método 1: Via CLI

Este fluxo exige o OpenClaw instalado e um workspace configurado. Se ainda não preparou o ambiente, siga o guia de instalação.

Depois de revisar o skill e suas permissões, instale a referência escolhida:

openclaw skills install @autor/nome-do-skill
openclaw skills list
openclaw skills check

A instalação usa o workspace selecionado pelo OpenClaw. list mostra o inventário; check distingue o que existe, o que tem os pré-requisitos necessários e o que está disponível para o agente. Um skill instalado pode continuar indisponível por falta de uma dependência ou por uma regra de acesso.

Consulte a referência oficial de openclaw skills para selecionar outro agente ou entender uma falha.

Método 2: Diretório local

Para um skill que você criou ou revisou localmente, use uma pasta com um SKILL.md válido na raiz:

openclaw skills install ./meu-skill
openclaw skills check

O comando copia o diretório local. A instalação nativa de skills não aceita arquivos ZIP, caminhos de arquivo .skill ou especificações de pacote npm. Não tente instalar um arquivo compactado como se fosse uma referência do registro.

Os comandos acima tratam de skills. Plugins usam outro fluxo; consulte a visão geral oficial do ClawHub para distinguir os dois formatos.

Atualizando Skills

Atualize um skill acompanhado pelo ClawHub ou todos os skills desse tipo no workspace selecionado:

openclaw skills update @autor/nome-do-skill
openclaw skills update --all
openclaw skills check

update acompanha instalações vinculadas ao ClawHub. Ele não atualiza automaticamente todo diretório local ou repositório Git instalado. Revise a origem e as alterações antes da atualização. Se o comando recusar uma operação ou apontar mudanças locais, leia o diagnóstico antes de sobrescrever arquivos.

Publicando Seus Skills

Pré-requisitos

  1. Uma conta autorizada a publicar no ClawHub.
  2. Uma pasta local com o arquivo SKILL.md e os arquivos de apoio necessários.
  3. Instruções claras, dependências documentadas e testes do skill.
  4. Nenhuma senha, token ou chave privada nos arquivos que serão enviados.
  5. Node.js 22 ou mais recente para a CLI ClawHub 0.23.3, além do npm usado abaixo.

Esse requisito é da CLI ClawHub; o OpenClaw pode exigir uma versão diferente do Node.js. Confira os requisitos da versão que você usa.

A publicação exige a CLI separada do ClawHub, não um subcomando de publicação em openclaw skills.

Passos para Publicar

  1. Instale a CLI do ClawHub:
    npm i -g clawhub
  2. Autentique sua conta:
    clawhub login
  3. Revise a pasta e publique o skill:
    clawhub skill publish ./meu-skill --slug meu-skill --name "Meu Skill" --version 1.0.0
  4. Confira a versão e o resultado da auditoria no registro. Uma nova versão pode ficar fora das superfícies normais de instalação até o fim da análise.

A entrada da publicação é a pasta do skill, não um arquivo .skill. Consulte a documentação oficial de publicação para publicar em nome de uma organização ou definir outros metadados.

Boas Práticas para Publicação

  • Explique o que o skill faz e quais permissões ele precisa.
  • Inclua exemplos de uso e os pré-requisitos.
  • Teste as instruções no ambiente que você documenta.
  • Mantenha o SKILL.md claro e confira os arquivos enviados.
  • Não inclua segredos, dados pessoais ou dependências que você não revisou.

Segurança antes de instalar

O ClawHub apresenta auditorias e sinais de risco para ajudar na decisão. Uma auditoria não garante ausência de risco nem funcionamento correto. Leia os resultados, os arquivos e as permissões antes de conceder acesso a contas, arquivos ou serviços.

Um resultado Pass não dispensa sua revisão. Pending indica que a análise ainda não terminou; um aviso exige atenção, não uma tentativa de contornar a proteção.

Consulte a explicação oficial das auditorias e o guia de segurança de skills. Não interprete a presença no catálogo, a popularidade ou um selo como uma aprovação irrestrita.

Versionamento

O registro mantém versões, etiquetas e um histórico de alterações. Para escolher uma versão específica de um skill do ClawHub:

openclaw skills install @autor/nome-do-skill --version 1.2.0

--version seleciona uma versão do ClawHub. Não use essa opção para presumir que um diretório local terá versões do registro. Confira o histórico do autor antes de escolher ou atualizar.

Reportando Problemas

  1. Confira o inventário e os pré-requisitos:
    openclaw skills list
openclaw skills check
  2. Abra a página do skill no ClawHub e siga o vínculo para seu autor ou repositório de origem.
  3. Descreva a falha com a versão do OpenClaw, a referência e a versão do skill, e os passos para reproduzir.
  4. Remova segredos e dados pessoais de qualquer log antes de compartilhar.

Uma falha em um skill de terceiros deve chegar ao seu autor. Para uma vulnerabilidade na plataforma ClawHub, siga as instruções oficiais de segurança.

Escolhendo um Skill

Pesquise pela tarefa que você quer resolver, como leitura de PDF ou integração com uma agenda. Compare a origem, as instruções, as dependências e as permissões dos resultados.

Não escolha apenas por um número de downloads. Verifique se o skill resolve sua tarefa com o menor acesso necessário.

Próximos Passos