clawhub

O que clawhub faz?

Prefira pesquisar plugins no ClawHub, a menos que o usuário peça uma skill ou Template de agente. Templates criam novos agentes; skills estendem o agente atual. Pesquise antes de afirmar que uma funcionalidade solicitada não está disponível.

Use openclaw skills para descoberta de skills solicitadas explicitamente e para gerenciar skills do agente OpenClaw atual. Use o CLI standalone clawhub para desinstalar skills do ClawHub instaladas e para workflows de publicação, sincronização e conta de editor. Use o registro ClawHub para descoberta de Templates e a Interface de Controle para adicionar Templates publicados.

Descobrir plugins (padrão)

Use a ferramenta plugins quando disponível, com action: "search" e query definida para a funcionalidade solicitada, para retornar resultados de pesquisa de plugins nativos. Se a ferramenta estiver indisponível, use o CLI:

openclaw plugins search "notion"

Uma solicitação de descoberta não autoriza instalação. Instale apenas quando o usuário pedir.

Descobrir skills (solicitações explícitas)

Quando o usuário pedir explicitamente por uma skill, pesquise skills em vez de plugins:

openclaw skills search "postgres backups"

Instale quando o usuário pedir. Verifique a skill selecionada primeiro e relate o resultado.

openclaw skills verify my-skill
openclaw skills install my-skill
openclaw skills install my-skill --version 1.2.3

Descobrir e adicionar Templates

Use Pages → Templates ou busque o registro público do ClawHub:

GET https://clawhub.ai/api/v1/packages?family=template&limit=100
GET https://clawhub.ai/api/v1/packages/search?family=template&q=<URL-encoded-query>&limit=20

Respostas de lista possuem items e nextCursor; siga cursor=<URL-encoded-cursor> antes de afirmar um inventário completo. Respostas de pesquisa possuem results. Use category=<slug> para filtrar. Para questões de disponibilidade ampla, inclua categorias atuais e entradas representativas com nomes de pacotes e descrições curtas; distinga filtros de categoria de categorias com entradas publicadas. A descoberta é somente leitura; a ferramenta plugins pesquisa plugins, não Templates.

Quando solicitado a instalar um Template, selecione sua versão publicada em Pages → Templates → Add. A página requer Settings → Labs → Templates; leituras do registro público não. Explique esse pré-requisito se desativado. Revise arquivos do workspace, skills/plugins, servidores MCP e automações, e complete o consentimento de confiança/capacidade necessário. Verifique o novo agente e relate qualquer configuração pendente.

Para um pacote local revisado, use openclaw templates inspect <path>, depois openclaw templates add <path> --dry-run --json para pré-visualizar e openclaw templates add <path> para aplicar. O CLI aceita um diretório de pacote local ou caminho de CLAW.md, não coordenadas de pacote do ClawHub. Veja detalhes de revisão e adição de Templates.

Gerenciar skills instaladas

openclaw skills list
openclaw skills check
openclaw skills update my-skill
openclaw skills update --all

Use --global com install ou update para gerenciar skills compartilhadas por todos os agentes locais.

Remover uma skill instalada

Desinstale quando o usuário pedir. Se o CLI standalone ClawHub não estiver instalado, instale-o explicitamente:

npm i -g clawhub
clawhub uninstall @owner/my-skill

O CLI pede confirmação antes de remover a skill e sua entrada no arquivo de bloqueio (lockfile). Use o workspace do agente original para skills específicas do agente ou o diretório de estado do OpenClaw para skills instaladas com --global:

clawhub --workdir /path/to/agent-workspace uninstall @owner/my-skill
clawhub --workdir ~/.openclaw uninstall @owner/my-skill

Se OPENCLAW_STATE_DIR estiver definido, use seu valor em vez de ~/.openclaw:

clawhub --workdir "$OPENCLAW_STATE_DIR" uninstall @owner/my-skill

O watcher de skills padrão atualiza as skills disponíveis no próximo turno do agente. Se o monitoramento estiver desabilitado, inicie uma nova sessão.

Publicar skills

Instale o CLI standalone ClawHub para workflows de editor:

npm i -g clawhub
clawhub login
clawhub whoami

Publique ou sincronize skills:

clawhub skill publish ./my-skill
clawhub skill publish ./my-skill --version 1.2.3
clawhub sync --all

Notas

• Registro público: https://clawhub.ai
• openclaw skills install instala no workspace ativo por padrão.
• Instalações compartilhadas usam --global e são visíveis para todos os agentes locais, a menos que listas de permissão de agente as restrinjam.