Skills

• Omita agents.defaults.skills para deixar todas as Skills sem restrição 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 mescla com os padrões.
• A allowlist efetiva se aplica à construção de prompts, descoberta de comandos de barra, sincronização de sandbox e snapshots de Skills.
• Isso não é uma fronteira 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 SO, deny/allowlists de exec e credenciais por recurso.

openclaw skills install instala no diretório skills/ do workspace ativo por padrão. Adicione --global para instalar no diretório compartilhado ~/.openclaw/skills, visível a todos os agentes locais, a menos que allowlists de agentes o restrinjam.

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

openclaw skills verify @owner/<slug> pede ao ClawHub o envelope de confiança clawhub.skill.verify.v1 da skill. Skills do ClawHub instaladas são verificadas contra a versão e o registro gravados em .clawhub/origin.json. Slugs simples continuam aceitos para Skills existentes instaladas ou inequívocas, mas referências qualificadas por proprietário evitam ambiguidade de publicador.

Páginas de Skills do ClawHub expõem o estado mais recente da varredura de segurança antes da instalação, com páginas de detalhes para VirusTotal, ClawScan e análise estática. O comando sai com valor diferente de zero quando o ClawHub marca a verificação como falha. Publicadores recuperam falsos positivos pelo painel do ClawHub ou por clawhub skill rescan @owner/<slug>.

Clientes Gateway que precisam de entrega fora do ClawHub podem preparar um arquivo zip de skill com skills.upload.begin, skills.upload.chunk e skills.upload.commit, depois instalar com skills.install({ source: "upload", ... }). Esse caminho fica desativado por padrão e requer skills.install.allowUploadedArchives: true em openclaw.json. Instalações normais do ClawHub nunca precisam dessa configuração.

A descoberta de Skills de workspace, agente do projeto e diretório extra aceita apenas raízes de skill cujo realpath resolvido permanece dentro da raiz configurada, a menos que skills.load.allowSymlinkTargets confie explicitamente em uma raiz de destino. A Oficina de Skills escreve por esses destinos confiáveis apenas quando skills.workshop.allowSymlinkTargetWrites está habilitado. ~/.openclaw/skills gerenciadas e ~/.agents/skills pessoais podem conter pastas de skill com symlink, mas todo realpath de SKILL.md ainda deve permanecer dentro de seu diretório de skill resolvido.

Configure security.installPolicy para executar um comando de política local confiável antes que instalações de skill continuem. A política recebe metadados e o caminho de origem preparado, aplica-se a caminhos do ClawHub, upload, Git, locais, atualização e instalador de dependências, e falha de modo fechado quando o comando não consegue retornar uma decisão válida.

skills.entries.*.env e skills.entries.*.apiKey injetam segredos no processo host apenas para aquele 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 preferida (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 de Node respeitam skills.install.nodeManager em openclaw.json (padrão: npm; opções: npm / pnpm / yarn / bun). Isso afeta apenas instalações de habilidades; o runtime 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 traduz fórmulas do brew em comandos de pacotes do sistema. Em contêineres Linux sem brew, instaladores apenas de 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 habilidades e preserva as configurações existentes de GOBIN, GOPATH e GOTOOLCHAIN. Se a toolchain configurada não puder satisfazer a versão de Go exigida por um módulo, o onboarding agrupa a habilidade com pré-requisitos manuais de Go após a tentativa de instalação. Se go estiver ausente e Homebrew estiver disponível, o OpenClaw instala Go primeiro via Homebrew e define GOBIN como o bin do Homebrew. No Linux, o OpenClaw pode, em vez disso, usar apt-get como root ou por meio de sudo sem senha quando o candidato golang-go atualizado atende à versão mínima.
• 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 habilidade. Se um agente for executado em uma sandbox, o binário também precisa existir dentro do contêiner. Instale-o via agents.defaults.sandbox.docker.setupCommand ou uma imagem personalizada. setupCommand é executado uma vez após a criação do contêiner e exige egresso de rede, um sistema de arquivos raiz gravável e um usuário root na sandbox.

Por padrão, o OpenClaw observa pastas de habilidades e incrementa o snapshot quando arquivos SKILL.md mudam. Configure em skills.load:

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

Use allowSymlinkTargets para layouts intencionalmente vinculados por symlink em que uma symlink da raiz de uma habilidade aponta para fora da raiz configurada, por exemplo <workspace>/skills/manager -> ~/Projects/manager/skills. Habilite skills.workshop.allowSymlinkTargetWrites apenas quando o Skill Workshop também deve aplicar propostas por esses caminhos confiáveis vinculados por symlink.

Se o Gateway roda no Linux, mas um nó macOS está conectado com system.run permitido, o OpenClaw pode tratar habilidades exclusivas de macOS como elegíveis quando os binários exigidos estiverem presentes nesse nó. O agente deve executar essas habilidades via ferramenta exec com host=node.

Nós offline não tornam habilidades apenas remotas visíveis. Se um nó para de responder a sondagens de binários, o OpenClaw limpa suas correspondências de binários em cache.