Publicação

A publicação envia uma pasta de skill ou um pacote de plugin ao ClawHub sob o proprietário que você escolher. O ClawHub verifica se seu token pode publicar para esse proprietário, valida os metadados, o nome, a versão, os arquivos e as informações de origem, armazena a versão e inicia verificações de segurança automatizadas.

Se a validação falhar, nada será publicado. Novas versões também podem permanecer fora das áreas normais de instalação e download até a conclusão da análise.

Skills

A forma mais simples de publicar é pela CLI. Autentique-se e publique uma pasta de skill local:

clawhub loginclawhub skill publish ./my-skill \  --slug my-skill \  --name "My Skill" \  --owner <owner>

Use --owner <handle> ao publicar para o proprietário de uma organização. Omita essa opção para publicar como o usuário autenticado. A publicação ignora conteúdo que não foi alterado. Uma nova skill começa na versão 1.0.0, e alterações posteriores publicam automaticamente a próxima versão de correção. Passe --version somente quando precisar de uma versão explícita.

Para repositórios de catálogo, use o fluxo de trabalho reutilizável skill-publish.yml do ClawHub. Ele chama skill publish para cada pasta de skill diretamente abaixo de root (padrão: skills) ou somente para a pasta fornecida como skill_path.

jobs:  publish:    uses: openclaw/clawhub/.github/workflows/skill-publish.yml@main    with:      owner: <owner>      dry_run: false    secrets:      clawhub_token: ${{ secrets.CLAWHUB_TOKEN }}

Use dry_run: true para visualizar skills novas e alteradas sem publicá-las.

Plugins

Plugins usam nomes de pacote no estilo do npm. Nomes de pacote com escopo incluem o proprietário na primeira parte do nome:

@owner/package-name

O escopo deve corresponder ao proprietário selecionado para a publicação. Se o pacote se chamar @openclaw/dronzer, ele só poderá ser publicado como @openclaw. Se você publicar como @vintageayu, renomeie o pacote para @vintageayu/dronzer.

Isso impede que um pacote reivindique o namespace de uma organização que o publicador não controla.

Se você for o proprietário legítimo de uma organização, marca, escopo de pacote, identificador de proprietário ou namespace que já esteja reivindicado ou reservado no ClawHub, abra uma issue de reivindicação de organização/namespace com comprovação pública e não confidencial. Consulte Reivindicações de organizações e namespaces para saber o que incluir e o que não divulgar em issues públicas.

Antes de publicar um Plugin

• Escolha um proprietário que corresponda ao escopo do pacote.
• Inclua openclaw.plugin.json. Plugins com código também precisam de package.json com openclaw.compat.pluginApi e openclaw.build.openclawVersion.
• Para exibir um ícone personalizado no cartão do plugin, adicione icon a openclaw.plugin.json com qualquer URL de imagem HTTPS.
• Inclua o repositório de origem e os metadados exatos do commit ou use a CLI em um checkout vinculado ao GitHub para que ela possa detectá-los.
• Execute clawhub package validate <source> antes de publicar. Para problemas relacionados ao pacote, manifesto, importação do SDK ou artefato, consulte Correções de validação de plugins.
• Execute clawhub package publish <source> --dry-run antes de criar uma versão.
• Espere que novas versões permaneçam fora das áreas públicas de instalação até a conclusão das verificações de segurança automatizadas e da verificação.

Publicação confiável de pacotes

A configuração da publicação confiável de pacotes tem duas etapas:

1. Publique o pacote uma vez por meio da publicação manual normal ou autenticada por token com clawhub package publish. Isso cria o registro do pacote e define os gerentes do pacote que podem alterar sua configuração de publicador confiável.
2. Um gerente do pacote define a configuração de publicador confiável do GitHub Actions:

clawhub package trusted-publisher set @owner/package-name \  --repository owner/repo \  --workflow-filename package-publish.yml

Depois que a configuração for definida, as futuras publicações compatíveis do GitHub Actions poderão usar OIDC/publicação confiável sem armazenar um token de longa duração do ClawHub no repositório. O repositório e o nome do arquivo de fluxo de trabalho configurados devem corresponder à declaração OIDC do GitHub Actions. Se você também passar --environment <name>, a declaração de ambiente do GitHub Actions deverá corresponder exatamente a esse nome.

O ClawHub verifica o repositório GitHub configurado quando a configuração de publicador confiável é definida. Repositórios públicos podem ser verificados por meio dos metadados públicos do GitHub. Repositórios privados exigem que o ClawHub tenha acesso do GitHub a esse repositório, por exemplo, por meio de uma futura instalação do GitHub App do ClawHub ou de outra integração autorizada com o GitHub.

O fluxo de trabalho reutilizável atual para publicação de pacotes permite publicação confiável sem segredos em publicações por workflow_dispatch quando id-token: write está disponível. Publicações reais por envio de tag ainda precisam de clawhub_token; portanto, mantenha CLAWHUB_TOKEN disponível para lançamentos por tag, primeiras publicações, pacotes não confiáveis ou publicações emergenciais.

Inspecione ou remova a configuração com:

clawhub package trusted-publisher get @owner/package-nameclawhub package trusted-publisher delete @owner/package-name

Excluir a configuração de publicador confiável é o procedimento de reversão. Isso desativa a emissão futura de tokens de publicação confiável até que um gerente do pacote defina a configuração novamente.

Perguntas frequentes

O escopo do pacote deve corresponder ao proprietário selecionado

Se o escopo do pacote e o proprietário selecionado não corresponderem, o ClawHub rejeitará a publicação:

O escopo do pacote "@openclaw" deve corresponder ao proprietário selecionado "@vintageayu".Publique como "@openclaw" ou renomeie este pacote para "@vintageayu/dronzer".

Para corrigir, escolha o proprietário indicado pelo escopo do pacote ou renomeie o pacote para que o escopo corresponda ao proprietário em cujo nome você pode publicar.

Se o nome do pacote já tiver o escopo correto, mas o pacote pertencer ao publicador errado, transfira a propriedade:

clawhub package transfer @opik/opik-openclaw --to opik

Use a transferência de pacote ou skill somente quando tiver acesso administrativo tanto ao proprietário atual quanto ao publicador de destino. A transferência de pacote não permite publicar em um escopo que você não pode gerenciar.

Se você não tiver acesso ao proprietário atual, mas acreditar que sua organização, projeto ou marca é o proprietário legítimo do namespace, abra uma issue de reivindicação de organização/namespace com comprovação pública e não confidencial para análise da equipe. Consulte Reivindicações de organizações e namespaces antes de enviar.

Isso protege os namespaces das organizações. Um pacote chamado @openclaw/dronzer reivindica o namespace @openclaw; portanto, somente publicadores com acesso ao proprietário @openclaw podem publicá-lo.