CLI commands
Skills
openclaw skills
Inspecione Skills locais, pesquise no ClawHub, instale Skills do ClawHub/Git/diretórios locais, verifique Skills do ClawHub e atualize instalações rastreadas pelo ClawHub.
Relacionado:
- Sistema de Skills: Skills
- Oficina de Skills: Oficina de Skills
- Configuração de Skills: Configuração de Skills
- Instalações do ClawHub: ClawHub
Comandos
openclaw skills search "calendar"openclaw skills search --limit 20 --jsonopenclaw skills install @owner/<slug>openclaw skills install @owner/<slug> --version <version>openclaw skills install git:owner/repoopenclaw skills install git:owner/repo@mainopenclaw skills install ./path/to/skill --as custom-nameopenclaw skills install @owner/<slug> --forceopenclaw skills install @owner/<slug> --force-installopenclaw skills install @owner/<slug> --acknowledge-clawhub-riskopenclaw skills install @owner/<slug> --agent <id>openclaw skills install @owner/<slug> --globalopenclaw skills update @owner/<slug>openclaw skills update @owner/<slug> --force-installopenclaw skills update @owner/<slug> --acknowledge-clawhub-riskopenclaw skills update @owner/<slug> --globalopenclaw skills update --allopenclaw skills update --all --agent <id>openclaw skills update --all --globalopenclaw skills verify @owner/<slug>openclaw skills verify @owner/<slug> --version <version>openclaw skills verify @owner/<slug> --tag <tag>openclaw skills verify @owner/<slug> --cardopenclaw skills verify @owner/<slug> --globalopenclaw skills listopenclaw skills list --eligibleopenclaw skills list --jsonopenclaw skills list --verboseopenclaw skills list --agent <id>openclaw skills info <name>openclaw skills info <name> --jsonopenclaw skills info <name> --agent <id>openclaw skills checkopenclaw skills check --agent <id>openclaw skills check --jsonopenclaw skills workshop propose-create --name "qa-check" --description "QA checklist" --proposal ./PROPOSAL.mdopenclaw skills workshop propose-update qa-check --proposal ./PROPOSAL.mdopenclaw skills workshop listopenclaw skills workshop inspect <proposal-id>openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.mdopenclaw skills workshop apply <proposal-id>openclaw skills workshop reject <proposal-id> --reason "Not reusable"openclaw skills workshop quarantine <proposal-id> --reason "Needs security review"search, update e verify usam o ClawHub diretamente. install @owner/<slug>
instala uma Skill do ClawHub, install git:owner/repo[@ref] clona uma Skill do Git
e install ./path copia um diretório local de Skill. Por padrão, install,
update e verify usam como destino o diretório skills/ do espaço de trabalho ativo;
com --global, usam como destino o diretório compartilhado de Skills gerenciadas.
list/info/check ainda inspecionam as Skills locais visíveis para o espaço de
trabalho e a configuração atuais. Os comandos vinculados ao espaço de trabalho
resolvem o espaço de trabalho de destino a partir de --agent <id>, depois pelo
diretório de trabalho atual quando ele está dentro do espaço de trabalho de um agente
configurado e, por fim, pelo agente padrão.
Instalações do Git e de diretórios locais esperam encontrar SKILL.md na raiz da
origem. O slug da instalação vem do campo name do frontmatter de SKILL.md quando
ele é válido e, em seguida, do nome do diretório de origem ou do repositório; use
--as <slug> para substituí-lo. --version é exclusivo do ClawHub. Instalações de
Skills não oferecem suporte a especificações de pacotes npm nem a caminhos de
arquivos zip/compactados, e openclaw skills update atualiza apenas instalações
rastreadas pelo ClawHub.
As instalações de dependências de Skills apoiadas pelo Gateway e acionadas pela
integração inicial ou pelas configurações de Skills usam o caminho de solicitação
separado skills.install.
Observações:
| Opção/comportamento | Descrição |
|---|---|
search [query...] |
Consulta opcional; omita-a para navegar pelo feed de pesquisa padrão do ClawHub. |
search --limit <n> |
Limita os resultados retornados. |
install git:owner/repo[@ref] |
Instala uma Skill do Git. Referências de branches podem conter barras, como git:owner/repo@feature/foo. |
install ./path/to/skill |
Instala um diretório local cuja raiz contém SKILL.md. |
install --as <slug> |
Substitui o slug inferido para instalações do Git e de diretórios locais. |
install --version <version> |
Aplica-se somente a referências de Skills do ClawHub. |
install --force |
Sobrescreve uma pasta de Skill existente no espaço de trabalho para o mesmo slug. |
install/update --force-install |
Instala uma Skill pendente do ClawHub apoiada pelo GitHub antes que a verificação do ClawHub seja concluída. |
--global |
Usa como destino o diretório compartilhado de Skills gerenciadas; não pode ser combinado com --agent <id>. |
--agent <id> |
Usa como destino o espaço de trabalho de um agente configurado; substitui a inferência pelo diretório de trabalho atual. |
update @owner/<slug> |
Atualiza uma única Skill rastreada. Adicione --global para usar como destino o diretório compartilhado de Skills gerenciadas em vez do espaço de trabalho. |
update --all |
Atualiza as instalações rastreadas pelo ClawHub no espaço de trabalho selecionado ou, com --global, no diretório compartilhado de Skills gerenciadas. |
verify @owner/<slug> |
Imprime o envelope JSON clawhub.skill.verify.v1 do ClawHub por padrão. Não há uma opção --json, pois JSON já é o padrão. Slugs sem proprietário são aceitos para compatibilidade quando a Skill já está instalada ou não há ambiguidade; referências qualificadas pelo proprietário evitam ambiguidade quanto ao publicador. |
Proveniência de verify |
Quando o ClawHub retorna a proveniência da origem resolvida pelo servidor, o JSON de verificação também inclui um openclaw.verifiedSourceUrl fixado em um commit. URLs de origem indisponíveis ou autodeclaradas permanecem apenas no envelope bruto de proveniência e não são promovidas. |
Seletor de versão de verify |
verify usa .clawhub/origin.json para Skills instaladas do ClawHub, portanto verifica a versão instalada no registro de onde ela veio. --version e --tag substituem o seletor de versão, mas mantêm esse registro instalado quando existem metadados de origem. |
verify --card |
Imprime o Markdown gerado do Cartão da Skill em vez de JSON. Encerra com código diferente de zero quando o ClawHub retorna ok: false ou decision: "fail"; assinaturas não assinadas são apenas informativas, a menos que a política do ClawHub seja alterada. |
| Impressão digital do Cartão da Skill | Pacotes instalados do ClawHub podem incluir um skill-card.md gerado. O OpenClaw trata a verificação como uma decisão do servidor do ClawHub e não rejeita uma Skill instalada apenas porque esse cartão gerado altera a impressão digital do pacote. |
check --agent <id> |
Verifica o espaço de trabalho do agente selecionado e informa quais Skills prontas estão realmente visíveis para o prompt ou a superfície de comandos desse agente. |
list |
Ação padrão quando nenhum subcomando é fornecido. |
Saída de list/info/check |
A saída renderizada vai para stdout. Com --json, a carga útil legível por máquina permanece em stdout para pipes e scripts. |
As instalações e atualizações de Skills da comunidade do ClawHub verificam a
confiabilidade antes do download. Versões de arquivos compactados da comunidade
com versão definida usam metadados de confiabilidade da versão exata. Skills do
GitHub apoiadas por um resolvedor dependem do resolvedor de instalação do ClawHub
para aplicar a política de verificação e instalação forçada antes de retornar um
commit fixado; use --force-install para instalar uma Skill pendente apoiada pelo
GitHub antes que essa verificação seja concluída. Versões maliciosas ou bloqueadas
da comunidade são recusadas. Versões arriscadas da comunidade exigem análise e
--acknowledge-clawhub-risk quando um comando não interativo deve continuar após
essa análise. Publicadores oficiais de Skills do ClawHub e origens de Skills
incluídas no OpenClaw ignoram essa solicitação de confiabilidade da versão.
Oficina de Skills
openclaw skills workshop gerencia propostas de Skills pendentes no espaço de
trabalho selecionado. As propostas não são Skills ativas até serem aplicadas.
Para saber mais sobre o armazenamento de propostas, as proteções para arquivos
de suporte, os métodos do Gateway e a política de aprovação, consulte
Oficina de Skills.
openclaw skills workshop propose-create \ --name "qa-check" \ --description "Lista de verificação de QA reproduzível" \ --proposal ./PROPOSAL.mdopenclaw skills workshop propose-create \ --name "qa-check" \ --description "Lista de verificação de QA reproduzível" \ --proposal-dir ./qa-check-proposalopenclaw skills workshop propose-update qa-check --proposal ./PROPOSAL.mdopenclaw skills workshop listopenclaw skills workshop inspect <proposal-id>openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.mdopenclaw skills workshop apply <proposal-id>openclaw skills workshop reject <proposal-id> --reason "Duplicada"openclaw skills workshop quarantine <proposal-id> --reason "Requer análise de segurança"propose-create, propose-update e revise também aceitam --goal <text>
e --evidence <text> para registrar a motivação da proposta e as observações
complementares junto ao conteúdo de --proposal/--proposal-dir.
