Skills

• Omita agents.defaults.skills para deixar todas as Skills irrestritas por padrão.
• Omita agents.list[].skills para herdar agents.defaults.skills.
• Defina agents.list[].skills: [] para não expor nenhuma Skill a esse agente.
• Uma lista agents.list[].skills não vazia é o conjunto final — ela não é combinada com os padrões.
• A lista de permissões efetiva se aplica à criação de prompts, à descoberta de comandos com barra, à sincronização do sandbox e aos snapshots de Skills.
• Isso não constitui um limite de autorização do shell do host. Se o mesmo agente puder usar exec, restrinja esse shell separadamente com sandboxing, isolamento de usuário do sistema operacional, listas de bloqueio/permissão do exec e credenciais por recurso.

Por padrão, openclaw skills install instala no diretório skills/ do espaço de trabalho ativo. Adicione --global para instalar no diretório compartilhado ~/.openclaw/skills, visível para todos os agentes locais, a menos que as listas de permissões dos agentes restrinjam esse acesso.

Instalações via Git e locais esperam encontrar SKILL.md na raiz da origem. O slug vem do campo name do frontmatter de SKILL.md quando válido e, caso contrário, usa o nome do diretório ou do repositório. Use --as <slug> para substituí-lo. openclaw skills update rastreia apenas instalações do ClawHub — reinstale origens Git ou locais para atualizá-las.

openclaw skills verify @owner/<slug> solicita ao ClawHub o envelope de confiança clawhub.skill.verify.v1 da Skill. As Skills instaladas pelo ClawHub são verificadas em relação à versão e ao registro gravados em .clawhub/origin.json. Slugs sem proprietário continuam aceitos para Skills já instaladas ou não ambíguas, mas referências qualificadas pelo proprietário evitam ambiguidades quanto ao publicador.

As páginas de Skills do ClawHub exibem o estado da análise de segurança mais recente antes da instalação, com páginas de detalhes para VirusTotal, ClawScan e análise estática. O comando retorna um código diferente de zero quando o ClawHub marca a verificação como falha. Publicadores podem corrigir falsos positivos pelo painel do ClawHub ou com clawhub skill rescan @owner/<slug>.

Clientes do Gateway que precisam de distribuição fora do ClawHub podem preparar um arquivo ZIP de Skill com skills.upload.begin, skills.upload.chunk e skills.upload.commit e, em seguida, instalá-lo com skills.install({ source: "upload", ... }). Esse caminho fica desativado por padrão e exige skills.install.allowUploadedArchives: true em openclaw.json. Instalações normais pelo ClawHub nunca precisam dessa configuração.

A descoberta de Skills no espaço de trabalho, no agente do projeto e em diretórios adicionais aceita apenas raízes de Skills cujo caminho real resolvido permaneça dentro da raiz configurada, a menos que skills.load.allowSymlinkTargets confie explicitamente em uma raiz de destino. A Oficina de Skills grava por meio desses destinos confiáveis somente quando skills.workshop.allowSymlinkTargetWrites está habilitado. Os diretórios gerenciado ~/.openclaw/skills e pessoal ~/.agents/skills podem conter pastas de Skills vinculadas simbolicamente, mas o caminho real de cada SKILL.md ainda deve permanecer dentro do diretório resolvido da respectiva Skill.

Configure security.installPolicy para executar um comando de política local confiável antes que as instalações de Skills prossigam. A política recebe metadados e o caminho da origem preparada, aplica-se ao ClawHub, a uploads, ao Git, a origens locais, a atualizações e aos caminhos do instalador de dependências, e falha de forma segura quando o comando não consegue retornar uma decisão válida.

skills.entries.*.env e skills.entries.*.apiKey injetam segredos no processo do host somente durante esse turno do agente — não no sandbox. Mantenha segredos fora de prompts e logs.

• Quando vários instaladores são listados, o Gateway escolhe uma opção preferencial (brew quando disponível; caso contrário, node).
• Se todos os instaladores forem download, o OpenClaw lista cada entrada para que você possa ver todos os artefatos disponíveis.
• As especificações podem incluir os: ["darwin"|"linux"|"win32"] para filtrar por plataforma.
• Instalações com Node respeitam skills.install.nodeManager em openclaw.json (padrão: npm; opções: npm / pnpm / yarn / bun). Isso afeta apenas instalações de skills; o ambiente de execução do Gateway ainda deve ser Node.
• Preferência de instalador do Gateway: Homebrew → uv → gerenciador de node configurado → go → download.

• Homebrew: o OpenClaw não instala o Homebrew automaticamente nem converte fórmulas do brew em comandos do gerenciador de pacotes do sistema. Em contêineres Linux sem brew, instaladores exclusivos do brew ficam ocultos; use uma imagem personalizada ou instale a dependência manualmente.
• Go: o OpenClaw exige Go 1.21 ou mais recente para instalações automáticas de skills. Se go estiver ausente e o Homebrew estiver disponível, o OpenClaw primeiro instalará o Go por meio do Homebrew; no Linux sem Homebrew, ele poderá usar apt-get como root ou por meio de sudo sem senha quando o candidato atualizado golang-go atender à versão mínima. O go install efetivo da dependência sempre usa como destino um diretório de binários dedicado e gerenciado pelo OpenClaw (o bin do Homebrew em uma instalação nova; caso contrário, ~/.local/bin), em vez do GOBIN configurado — suas próprias variáveis de ambiente GOBIN, GOPATH e GOTOOLCHAIN são lidas, mas nunca sobrescritas.
• Download: url (obrigatório), archive (tar.gz | tar.bz2 | zip), extract (padrão: automático quando um arquivo compactado é detectado), stripComponents, targetDir (padrão: ~/.openclaw/tools/<skillKey>).

requires.bins é verificado no host no momento do carregamento da skill. Se um agente for executado em um ambiente isolado, o binário também deverá existir dentro do contêiner. Instale-o por meio de agents.defaults.sandbox.docker.setupCommand ou de uma imagem personalizada. setupCommand é executado uma vez após a criação do contêiner e exige acesso de saída à rede, um sistema de arquivos raiz gravável e um usuário root no ambiente isolado.

Por padrão, o OpenClaw monitora as pastas de skills e atualiza o snapshot quando arquivos SKILL.md são alterados. Configure em skills.load:

{  skills: {    load: {      extraDirs: ["~/Projects/agent-scripts/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],      watch: true, // default      watchDebounceMs: 250, // default    },  },}

Use allowSymlinkTargets para estruturas intencionais com links simbólicos em que o link simbólico da raiz de uma skill aponta para fora da raiz configurada, por exemplo, <workspace>/skills/manager -> ~/Projects/manager/skills. Ative skills.workshop.allowSymlinkTargetWrites somente quando o Skill Workshop também precisar aplicar propostas por meio desses caminhos confiáveis com links simbólicos.

Se o Gateway for executado no Linux, mas um node macOS estiver conectado com system.run permitido, o OpenClaw poderá considerar elegíveis as skills exclusivas do macOS quando os binários necessários estiverem presentes nesse node. O agente deve executar essas skills por meio da ferramenta exec com host=node.

Nodes offline não tornam visíveis skills exclusivamente remotas. Se um node parar de responder às sondagens de binários, o OpenClaw removerá as correspondências de binários armazenadas em cache.