skills em
~/.openclaw/openclaw.json. A visibilidade específica do agente fica em
agents.defaults.skills e agents.list[].skills.
Para geração de imagens integrada, use
agents.defaults.imageGenerationModel
mais a ferramenta central image_generate em vez de skills.entries. Entradas
de skill são apenas para fluxos de trabalho de skills personalizados ou de terceiros.Carregamento (skills.load)
Diretórios adicionais de skills a verificar, com a menor precedência (depois de skills
empacotadas e de Plugin). Os caminhos são expandidos com suporte a
~.Diretórios de destino reais confiáveis para os quais pastas de skills com symlink podem resolver,
mesmo quando o symlink fica fora da raiz configurada. Use isto para
layouts intencionais de repositórios irmãos, como
<workspace>/skills/manager -> ~/Projects/manager/skills. Mantenha esta lista
restrita — não aponte para raízes amplas como ~ ou ~/Projects.Observa pastas de skills e atualiza o snapshot de skills quando arquivos
SKILL.md
mudam. Abrange arquivos aninhados em raízes de skills agrupadas.Janela de debounce para eventos do observador de skills, em milissegundos.
Instalação (skills.install)
Prefere instaladores do Homebrew quando
brew está disponível.Preferência de gerenciador de pacotes Node para instalações de skills. Isto afeta apenas
instalações de skills — o runtime do Gateway ainda deve usar Node (Bun não é recomendado
para WhatsApp/Telegram). Use
openclaw setup --node-manager para npm, pnpm
ou bun; defina "yarn" manualmente para instalações de skills baseadas em Yarn.Permite que clientes Gateway
operator.admin confiáveis instalem arquivos zip
privados preparados por meio de skills.upload.*. Instalações normais do ClawHub não
precisam desta configuração.Política de instalação do operador (security.installPolicy)
Use security.installPolicy quando operadores precisarem de um comando local confiável para
aprovar ou bloquear instalações de skills e plugins com uma política específica do host. A política
é executada depois que o OpenClaw preparou o material de origem e antes que a instalação ou atualização
continue. Ela se aplica a skills do ClawHub, skills enviadas, skills Git/locais,
instaladores de dependências de skills e origens de instalação/atualização de plugins.
Habilita a política de instalação controlada pelo operador. Quando habilitada sem um comando
exec
válido, as instalações falham de forma fechada.Filtro de alvo opcional. Quando omitido, a política se aplica a todos os alvos compatíveis
para que novas instalações não falhem abertas inesperadamente.
Caminho absoluto para o executável de política confiável. O OpenClaw o executa sem um
shell e valida o caminho antes do uso.
Argumentos estáticos passados depois de
command.Tempo máximo de execução em relógio de parede para uma decisão de política.
Tempo máximo sem saída em stdout ou stderr antes que a política falhe de forma fechada.
Máximo de bytes combinados de stdout e stderr aceitos do processo de política.
Variáveis de ambiente literais fornecidas ao processo de política.
Nomes de variáveis de ambiente copiados do processo do OpenClaw para o processo de
política. Apenas variáveis nomeadas são passadas.
Lista de permissões opcional de diretórios que podem conter o executável de política.
Ignora verificações de propriedade e permissão do caminho do comando. Use apenas quando o caminho
estiver protegido por outro mecanismo.
Permite que o caminho de comando configurado seja um symlink. O destino resolvido ainda deve
satisfazer as outras verificações de caminho. Argumentos de scripts interpretadores devem ser
arquivos regulares diretos, não symlinks.
protocolVersion: 1,
openclawVersion, targetType, targetName, sourcePath, sourcePathKind,
source estruturado opcional, origin estruturado e request. Ela deve escrever
um objeto JSON em stdout: { "protocolVersion": 1, "decision": "allow" } ou
{ "protocolVersion": 1, "decision": "block", "reason": "..." }. Saída diferente de zero,
timeout, JSON malformado, campos ausentes ou versões de protocolo sem suporte
falham de forma fechada.
O OpenClaw não executa a política de instalação durante a inicialização normal do Gateway. Instalações
e atualizações falham de forma fechada quando a política está habilitada, mas indisponível. openclaw doctor
realiza validação estática, e openclaw doctor --deep executa uma sondagem sintética
de instalação contra o comando configurado.
Atualizações em massa aplicam a política por alvo: uma atualização de skill ou plugin bloqueada falha
nesse alvo sem desabilitar a política nem pular alvos posteriores no lote.
Exemplo de stdin:
Lista de permissões de skills empacotadas
Lista de permissões opcional apenas para skills empacotadas. Quando definida, apenas skills empacotadas
na lista ficam elegíveis. Skills gerenciadas, no nível do agente e do workspace
não são afetadas.
Entradas por skill (skills.entries)
Chaves em entries correspondem ao name da skill por padrão. Se uma skill definir
metadata.openclaw.skillKey, use essa chave em vez disso. Coloque nomes com hífen entre aspas
(JSON5 permite chaves entre aspas).
false desabilita a skill mesmo quando ela está empacotada ou instalada. A skill empacotada coding-agent
é opt-in — defina-a como true e garanta que claude,
codex, opencode ou outra CLI compatível esteja instalada e autenticada.Campo de conveniência para skills que declaram
metadata.openclaw.primaryEnv.
Aceita uma string em texto simples ou um SecretRef: { source: "env", provider: "default", id: "VAR_NAME" }.Variáveis de ambiente injetadas para a execução do agente. Injetadas apenas quando a
variável ainda não está definida no processo.
Bolsa opcional para campos personalizados de configuração por skill.
Listas de permissões de agentes (agents)
Use a configuração do agente quando quiser as mesmas raízes de skills de máquina/workspace, mas um
conjunto de skills visível diferente por agente.
Lista de permissões de linha de base compartilhada herdada por agentes que omitem
agents.list[].skills.
Omita por completo para deixar skills irrestritas por padrão.Conjunto final explícito de skills para esse agente. Listas explícitas substituem padrões
herdados — elas não são mescladas. Defina como
[] para não expor skills a esse agente.Workshop (skills.workshop)
Quando
true, agentes podem criar propostas pendentes a partir de sinais duráveis de conversa
após turnos bem-sucedidos. A criação de skills solicitada pelo usuário sempre passa
pelo Skill Workshop, independentemente desta configuração.pending exige aprovação do operador antes de aplicar, rejeitar ou colocar em
quarentena por iniciativa do agente. auto permite essas ações sem aprovação.Permite que a aplicação do Skill Workshop grave por meio de links simbólicos
de skills do workspace cujo destino real já é confiável por
skills.load.allowSymlinkTargets. Mantenha isto desabilitado, a menos que
aplicações de propostas geradas devam modificar essa raiz de skills
compartilhada.Máximo de propostas pendentes e em quarentena retidas por workspace.
Tamanho máximo do corpo da proposta em bytes. As descrições de propostas têm
limite rígido de 160 bytes porque aparecem na saída de descoberta e listagem.
Raízes de skills com links simbólicos
Por padrão, raízes de skills de workspace, agente de projeto, diretório extra e incluídas são limites de contenção. Uma pasta de skill com link simbólico em<workspace>/skills que resolve para fora da raiz é ignorada com uma mensagem
de log.
Para permitir um layout intencional com link simbólico, declare o destino
confiável:
<workspace>/skills/manager -> ~/Projects/manager/skills
é aceito após a resolução de realpath. extraDirs verifica diretamente o
repositório irmão; allowSymlinkTargets preserva o caminho com link simbólico
para layouts existentes.
Por padrão, a aplicação do Skill Workshop não grava por meio desses links
simbólicos. Para permitir que a aplicação do Workshop modifique skills em
destinos de links simbólicos já confiáveis, habilite separadamente:
~/.openclaw/skills e diretórios pessoais
~/.agents/skills já aceitam links simbólicos para diretórios de skills (a
contenção por skill de SKILL.md ainda se aplica).
Skills em sandbox e variáveis de ambiente
Passe segredos para um sandbox Docker com:Usuários com acesso ao daemon do Docker podem inspecionar valores de
sandbox.docker.env por meio dos metadados do Docker. Use um arquivo de
segredo montado, uma imagem personalizada ou outro caminho de entrega quando
essa exposição não for aceitável.Lembrete da ordem de carregamento
Relacionados
Referência de Skills
O que são skills, ordem de carregamento, controles de acesso e formato de SKILL.md.
Criando skills
Autoria de skills personalizadas de workspace.
Skill Workshop
Fila de propostas para skills rascunhadas por agentes.
Comandos de barra
Catálogo nativo de comandos de barra e diretivas de chat.