Skills

ClawHub

ClawHub é o registro público para skills e plugins do OpenClaw.

Use comandos nativos do openclaw para pesquisar, instalar e atualizar skills, e para instalar plugins do ClawHub.
Use a CLI separada clawhub para fluxos de autenticação de registro, publicação, exclusão/restauração e sincronização.

Início rápido

Search

openclaw skills search "calendar"

Install

openclaw skills install <skill-slug>

Use

Inicie uma nova sessão do OpenClaw - ela detecta a nova skill.

Publish (optional)

Para fluxos autenticados no registro (publicar, sincronizar, gerenciar), instale a CLI separada clawhub:

npm i -g clawhub
# or
pnpm add -g clawhub

Fluxos nativos do OpenClaw

Skills

openclaw skills search "calendar"
openclaw skills install <skill-slug>
openclaw skills update --all

Comandos nativos do openclaw instalam no seu workspace ativo e persistem metadados de origem para que chamadas posteriores de update possam permanecer no ClawHub.

Plugins

openclaw plugins search "calendar"
openclaw plugins install clawhub:<package>
openclaw plugins update --all

plugins search consulta o catálogo de plugins do ClawHub e imprime nomes de pacotes prontos para instalação. Use clawhub:<package> quando quiser resolução pelo ClawHub. Especificações de plugin simples e seguras para npm são instaladas a partir do npm durante a transição de lançamento:

openclaw plugins install openclaw-codex-app-server

npm:<package> também é exclusivo do npm e é útil quando uma especificação poderia ser ambígua de outra forma:

openclaw plugins install npm:openclaw-codex-app-server

Instalações de plugins validam a compatibilidade anunciada de pluginApi e minGatewayVersion antes da instalação do arquivo ser executada, para que hosts incompatíveis falhem de forma fechada cedo em vez de instalar parcialmente o pacote. Quando uma versão de pacote publica um artefato ClawPack, o OpenClaw prefere o .tgz exato do pacote npm enviado, verifica o cabeçalho de digest do ClawHub e os bytes baixados, e registra o tipo de artefato, a integridade npm, o shasum npm, o nome do tarball e os metadados de digest do ClawPack para atualizações posteriores. Versões de pacote mais antigas sem metadados ClawPack ainda usam o caminho legado de verificação de arquivo de pacote.

O que é o ClawHub

Um registro público para skills e plugins do OpenClaw.
Um armazenamento versionado de pacotes de skills e metadados.
Uma superfície de descoberta para pesquisa, tags e sinais de uso.

Uma skill típica é um pacote versionado de arquivos que inclui:

Um arquivo SKILL.md com a descrição principal e o uso.
Configurações, scripts ou arquivos de suporte opcionais usados pela skill.
Metadados como tags, resumo e requisitos de instalação.

O ClawHub usa metadados para impulsionar a descoberta e expor com segurança as capacidades das skills. O registro rastreia sinais de uso (estrelas, downloads) para melhorar o ranqueamento e a visibilidade. Cada publicação cria uma nova versão semver, e o registro mantém o histórico de versões para que usuários possam auditar alterações.

Workspace e carregamento de skills

A CLI separada clawhub também instala skills em ./skills dentro do seu diretório de trabalho atual. Se um workspace do OpenClaw estiver configurado, clawhub usa esse workspace como fallback, a menos que você substitua --workdir (ou CLAWHUB_WORKDIR). O OpenClaw carrega skills do workspace de <workspace>/skills e as detecta na próxima sessão.

Se você já usa ~/.openclaw/skills ou skills incluídas, as skills do workspace têm precedência. Para mais detalhes sobre como skills são carregadas, compartilhadas e controladas, consulte Skills.

Recursos do serviço

Recurso	Observações
Navegação pública	Skills e seu conteúdo `SKILL.md` são visíveis publicamente.
Pesquisa	Alimentada por embeddings (pesquisa vetorial), não apenas palavras-chave.
Versionamento	Semver, changelogs e tags (incluindo `latest`).
Downloads	Zip por versão.
Estrelas e comentários	Feedback da comunidade.
Resumos de varredura de segurança	Páginas de detalhes mostram o estado da varredura mais recente antes da instalação ou do download.
Páginas de detalhes do scanner	Resultados do VirusTotal, ClawScan e análise estática têm links profundos.
Painel de recuperação do proprietário	Publicadores podem ver conteúdo próprio retido por varredura em `/dashboard`.
Novas varreduras solicitadas pelo proprietário	Proprietários podem solicitar novas varreduras limitadas para recuperação de falso positivo.
Moderação	Aprovações e auditorias.
API amigável para CLI	Adequada para automação e scripts.

Segurança e moderação

O ClawHub é aberto por padrão - qualquer pessoa pode enviar skills, mas uma conta do GitHub deve ter pelo menos uma semana para publicar. Isso desacelera abusos sem bloquear colaboradores legítimos.

Security scans

O ClawHub executa verificações de segurança automatizadas em skills e lançamentos de plugins publicados. Páginas públicas de detalhes resumem o resultado atual, e linhas de scanner apontam para páginas de detalhes dedicadas para VirusTotal, ClawScan e análise estática.

Lançamentos retidos por varredura ou bloqueados podem ficar indisponíveis no catálogo público e nas superfícies de instalação, enquanto ainda permanecem visíveis para seu proprietário em /dashboard.

Reporting

Qualquer usuário conectado pode denunciar uma skill.
Motivos de denúncia são obrigatórios e registrados.
Cada usuário pode ter até 20 denúncias ativas por vez.
Skills com mais de 3 denúncias únicas são ocultadas automaticamente por padrão.

Moderation

Moderadores podem ver skills ocultas, reexibi-las, excluí-las ou banir usuários.
Abusar do recurso de denúncia pode resultar em banimentos de conta.
Tem interesse em se tornar moderador? Pergunte no Discord do OpenClaw e entre em contato com um moderador ou mantenedor.

CLI do ClawHub

Você só precisa disso para fluxos autenticados no registro, como publicação/sincronização.

Opções globais

"--workdir

"--dir

"--site

"--registry

--no-inputboolean

Desabilita prompts (não interativo).

-V, --cli-versionboolean

Imprime a versão da CLI.

Comandos

Auth (login / logout / whoami)

clawhub login              # browser flow
clawhub login --token <token>
clawhub logout
clawhub whoami

Opções de login:

--token <token> - cole um token de API.
--label <label> - rótulo armazenado para tokens de login pelo navegador (padrão: CLI token).
--no-browser - não abrir um navegador (requer --token).

clawhub search "query"

Pesquisa skills. Para descoberta de plugins/pacotes, use clawhub package explore.

--limit <n> - máximo de resultados.

Browse / inspect plugins

clawhub package explore --family code-plugin
clawhub package explore "episodic-claw" --family code-plugin
clawhub package inspect episodic-claw

package explore e package inspect são as superfícies da CLI do ClawHub para descoberta de plugins/pacotes e inspeção de metadados. Instalações nativas do OpenClaw ainda usam openclaw plugins install clawhub:<package>.

Opções:

--family skill|code-plugin|bundle-plugin - filtrar família de pacote.
--official - mostrar apenas pacotes oficiais.
--executes-code - mostrar apenas pacotes que executam código.
--version <version> / --tag <tag> - inspecionar uma versão específica do pacote.
--versions, --files, --file <path> - inspecionar histórico e arquivos do pacote.
--json - saída legível por máquina.

Install / update / list

clawhub install <slug>
clawhub update <slug>
clawhub update --all
clawhub list

Opções:

--version <version> - instalar ou atualizar para uma versão específica (apenas um único slug em update).
--force - sobrescrever se a pasta já existir, ou quando arquivos locais não corresponderem a nenhuma versão publicada.
clawhub list lê .clawhub/lock.json.

Publish skills

clawhub skill publish <path>

Opções:

--slug <slug> - slug da skill.
--name <name> - nome de exibição.
--version <version> - versão semver.
--changelog <text> - texto do changelog (pode ficar vazio).
--tags <tags> - tags separadas por vírgula (padrão: latest).

Publish plugins

clawhub package publish <source>

<source> pode ser uma pasta local, owner/repo, owner/repo@ref ou uma URL do GitHub.

Opções:

--dry-run - criar o plano exato de publicação sem enviar nada.
--json - emitir saída legível por máquina para CI.
--source-repo, --source-commit, --source-ref - substituições opcionais quando a detecção automática não for suficiente.

Request rescans

clawhub skill rescan <slug>
clawhub skill rescan <slug> --yes --json

clawhub package rescan <name>
clawhub package rescan <name> --yes --json

Comandos de nova varredura exigem um token de proprietário conectado e têm como alvo a versão publicada mais recente da skill ou o lançamento do plugin. Em execuções não interativas, passe --yes.

Respostas JSON incluem o tipo de alvo, nome, versão, status da nova varredura e contagens restantes/máximas de solicitações para essa versão ou lançamento.

Delete / undelete (owner or admin)

clawhub delete <slug> --yes
clawhub undelete <slug> --yes

Sync (scan local + publish new or updated)

clawhub sync

Opções:

--root <dir...> - raízes extras de varredura.
--all - enviar tudo sem prompts.
--dry-run - mostrar o que seria enviado.
--bump <type> - patch|minor|major para atualizações (padrão: patch).
--changelog <text> - changelog para atualizações não interativas.
--tags <tags> - tags separadas por vírgula (padrão: latest).
--concurrency <n> - verificações de registro (padrão: 4).

Fluxos de trabalho comuns

Search

clawhub search "postgres backups"

Find a plugin

clawhub package explore --family code-plugin
clawhub package explore "memory" --family code-plugin
clawhub package inspect episodic-claw

Install

clawhub install my-skill-pack

Update all

clawhub update --all

Publish a single skill

clawhub skill publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest

Sync many skills

clawhub sync --all

Publish a plugin from GitHub

clawhub package publish your-org/your-plugin --dry-run
clawhub package publish your-org/your-plugin
clawhub package publish your-org/[email protected]
clawhub package publish https://github.com/your-org/your-plugin

Metadados de pacote de Plugin

Plugins de código devem incluir os metadados obrigatórios do OpenClaw em package.json:

{
  "name": "@myorg/openclaw-my-plugin",
  "version": "1.0.0",
  "type": "module",
  "openclaw": {
    "extensions": ["./src/index.ts"],
    "runtimeExtensions": ["./dist/index.js"],
    "compat": {
      "pluginApi": ">=2026.3.24-beta.2",
      "minGatewayVersion": "2026.3.24-beta.2"
    },
    "build": {
      "openclawVersion": "2026.3.24-beta.2",
      "pluginSdkVersion": "2026.3.24-beta.2"
    }
  }
}

Pacotes publicados devem enviar JavaScript compilado e apontar runtimeExtensions para essa saída. Instalações por checkout do Git ainda podem recorrer ao código-fonte TypeScript quando não houver arquivos compilados, mas entradas de runtime compiladas evitam a compilação de TypeScript em tempo de execução nos caminhos de inicialização, doctor e carregamento de plugins.

Versionamento, lockfile e telemetria

Versioning and tags

Cada publicação cria uma nova SkillVersion semver.
Tags (como latest) apontam para uma versão; mover tags permite reverter.
Changelogs são anexados por versão e podem ficar vazios ao sincronizar ou publicar atualizações.

Local changes vs registry versions

Atualizações comparam o conteúdo local da skill com versões do registry usando um hash de conteúdo. Se os arquivos locais não corresponderem a nenhuma versão publicada, a CLI pergunta antes de substituir (ou exige --force em execuções não interativas).

Sync scanning and fallback roots

clawhub sync examina primeiro o diretório de trabalho atual. Se nenhuma skill for encontrada, ele recorre a locais legados conhecidos (por exemplo, ~/openclaw/skills e ~/.openclaw/skills). Isso foi projetado para encontrar instalações antigas de skills sem flags adicionais.

Storage and lockfile

Skills instaladas são registradas em .clawhub/lock.json no seu diretório de trabalho.
Tokens de autenticação são armazenados no arquivo de configuração da CLI do ClawHub (substitua via CLAWHUB_CONFIG_PATH).

Telemetry (install counts)

Ao executar clawhub sync estando conectado, a CLI envia um snapshot mínimo para calcular contagens de instalação. Você pode desativar isso completamente:

export CLAWHUB_DISABLE_TELEMETRY=1

Variáveis de ambiente

Variável	Efeito
`CLAWHUB_SITE`	Substitui a URL do site.
`CLAWHUB_REGISTRY`	Substitui a URL da API do registry.
`CLAWHUB_CONFIG_PATH`	Substitui onde a CLI armazena o token/configuração.
`CLAWHUB_WORKDIR`	Substitui o diretório de trabalho padrão.
`CLAWHUB_DISABLE_TELEMETRY=1`	Desativa a telemetria em `sync`.

ClawHub

Início rápido

Search

Install

Use

Publish (optional)

Fluxos nativos do OpenClaw

Skills

Plugins

O que é o ClawHub

Workspace e carregamento de skills

Recursos do serviço

Segurança e moderação

CLI do ClawHub

Opções globais

Comandos

Fluxos de trabalho comuns

Search

Find a plugin

Install

Update all

Publish a single skill

Sync many skills

Publish a plugin from GitHub

Metadados de pacote de Plugin

Versionamento, lockfile e telemetria

Variáveis de ambiente

Relacionado

Ask OpenClaw

# Início rápido

Search

Install

Use

Publish (optional)

# Fluxos nativos do OpenClaw

Skills

Plugins

# O que é o ClawHub

# Workspace e carregamento de skills

# Recursos do serviço

# Segurança e moderação

# CLI do ClawHub

# Opções globais

# Comandos

# Fluxos de trabalho comuns

Search

Find a plugin

Install

Update all

Publish a single skill

Sync many skills

Publish a plugin from GitHub

# Metadados de pacote de Plugin

# Versionamento, lockfile e telemetria

# Variáveis de ambiente

# Relacionado

Início rápido

Fluxos nativos do OpenClaw

O que é o ClawHub

Workspace e carregamento de skills

Recursos do serviço

Segurança e moderação

CLI do ClawHub

Opções globais

Comandos

Fluxos de trabalho comuns

Metadados de pacote de Plugin

Versionamento, lockfile e telemetria

Variáveis de ambiente

Relacionado