Uma edição de SKILL.md é uma mudança de produção — mesmo quando nenhum código foi alterado

As habilidades do OpenClaw não são documentação passiva. Elas mudam quando ferramentas são invocadas e como o trabalho é executado. Uma habilidade local no seu workspace tem a maior precedência de carregamento, então pode substituir silenciosamente uma versão empacotada ou gerenciada — sem tocar no código da aplicação. Isso faz com que qualquer edição em um SKILL.md seja uma mudança de produção, mesmo que nenhum código tenha mudado.

Por que isso importa

A documentação de habilidades do OpenClaw observa que o observador de habilidades está habilitado por padrão. Um SKILL.md modificado pode atualizar o snapshot da sessão na próxima vez que o agente atuar. A orientação de segurança recomenda explicitamente tratar pastas de habilidades como código confiável — porque elas podem solicitar acesso ao sistema de arquivos, chamadas de rede, manipulação de credenciais ou fluxos de aprovação.

Audite antes de mudar

Antes de modificar qualquer habilidade, capture o que o agente pode realmente carregar. Execute estes comandos e salve a saída:

openclaw skills list --json
openclaw skills check --agent main --json
openclaw skills info SKILL_NAME --agent main --json

Eles fornecem as fontes efetivas e hashes — úteis como evidência de release. Mantenha as raízes das habilidades sob controle de versão e revise quaisquer novas instruções relacionadas a sistema de arquivos, rede, credenciais ou aprovação no diff.

Desative mudanças no meio da sessão

Se você não quiser que habilidades sejam trocadas no meio da sessão, a configuração documentada suporta desabilitar a observação automática:

{
  "skills": {
    "load": {
      "watch": false
    }
  }
}

Teste como se fosse produção

Quando você ativar mudanças revisadas, inicie uma nova sessão controlada e execute uma tarefa limitada. Confirme a sequência de ferramentas esperada, permissões e resultado final. Um carregamento bem-sucedido apenas prova que a habilidade é elegível — não que seu comportamento seja seguro.

A conclusão

Quais arquivos na sua configuração do OpenClaw podem atualmente alterar o comportamento do agente sem passar pelo seu processo normal de revisão de código? Trate cada SKILL.md como uma implantação de produção: audite, versione, teste e registre o que você mudou.