Una edición de SKILL.md es un cambio de producción, incluso cuando no cambió ningún código.

Las habilidades de OpenClaw no son documentación pasiva. Cambian la forma en que se invocan las herramientas y cómo se realiza el trabajo. Una habilidad local en tu workspace tiene la mayor precedencia de carga, por lo que puede reemplazar silenciosamente una versión incluida o gestionada, sin tocar el código de la aplicación. Esto hace que cualquier edición a un SKILL.md sea un cambio de producción, incluso si no cambia ningún código.

Por qué importa

La documentación de habilidades de OpenClaw señala que el observador de habilidades está habilitado por defecto. Un SKILL.md modificado puede refrescar la instantánea de la sesión en el siguiente turno del agente. La guía de seguridad recomienda explícitamente tratar las carpetas de habilidades como código confiable, porque pueden solicitar acceso al sistema de archivos, llamadas de red, manejo de credenciales o flujos de aprobación.

Audita antes de cambiar

Antes de modificar cualquier habilidad, captura lo que el agente puede cargar realmente. Ejecuta estos comandos y guarda la salida:

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

Te dan las fuentes y hashes efectivos, útiles como evidencia de lanzamiento. Mantén las raíces de habilidades bajo control de versiones y revisa cualquier instrucción nueva relacionada con sistema de archivos, red, credenciales o aprobación en el diff.

Deshabilita cambios a mitad de sesión

Si no quieres que las habilidades se intercambien a mitad de sesión, la configuración documentada permite deshabilitar la observación automática:

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

Pruébalo como si fuera producción

Cuando actives cambios revisados, inicia una sesión controlada nueva y ejecuta una tarea acotada. Confirma la secuencia de herramientas esperada, los permisos y el resultado final. Una carga exitosa solo demuestra que la habilidad es elegible, no que su comportamiento sea seguro.

La conclusión

¿Qué archivos en tu configuración de OpenClaw pueden cambiar actualmente el comportamiento del agente sin pasar por tu proceso normal de revisión de código? Trata cada SKILL.md como un despliegue de producción: audita, versiona, prueba y registra lo que cambiaste.