Skills

• Omita agents.defaults.skills para dejar todas las skills sin restricciones de forma predeterminada.
• Omita agents.entries.*.skills para heredar agents.defaults.skills.
• Establezca agents.entries.*.skills: [] para no exponer ninguna skill a ese agente.
• Una lista no vacía de agents.entries.*.skills es el conjunto definitivo; no se combina con los valores predeterminados.
• La lista de permitidas efectiva se aplica a la creación de prompts, la detección de comandos con barra, la sincronización del entorno aislado y las instantáneas de skills.
• Esto no constituye un límite de autorización del shell del host. Si el mismo agente puede usar exec, restrinja ese shell por separado mediante aislamiento, separación por usuario del sistema operativo, listas de ejecución denegada/permitida y credenciales por recurso.

openclaw skills install instala de forma predeterminada en el directorio skills/ del espacio de trabajo activo. Añada --global para instalar en el directorio compartido ~/.openclaw/skills, visible para todos los agentes locales salvo que las listas de permitidas de los agentes lo restrinjan.

Las instalaciones desde Git y locales requieren SKILL.md en la raíz del origen. El identificador legible proviene del name del frontmatter SKILL.md cuando es válido; de lo contrario, se usa el nombre del directorio o repositorio. Use --as <slug> para sobrescribirlo. openclaw skills update solo realiza el seguimiento de instalaciones de ClawHub; reinstale los orígenes Git o locales para actualizarlos.

openclaw skills verify @owner/<slug> solicita a ClawHub el perímetro de confianza clawhub.skill.verify.v1 de la skill. Las skills de ClawHub instaladas se verifican con la versión y el registro guardados en .clawhub/origin.json. Se siguen aceptando identificadores sin propietario para skills ya instaladas o no ambiguas, pero las referencias calificadas por propietario evitan ambigüedades sobre el publicador.

Las páginas de skills de ClawHub muestran el estado del análisis de seguridad más reciente antes de la instalación, con páginas detalladas para VirusTotal, ClawScan y el análisis estático. El comando finaliza con un código distinto de cero cuando ClawHub marca la verificación como fallida. Los publicadores pueden resolver falsos positivos mediante el panel de ClawHub o clawhub skill rescan @owner/<slug>.

Los clientes del Gateway que necesiten un método de entrega distinto de ClawHub pueden preparar un archivo ZIP de una skill con skills.upload.begin, skills.upload.chunk y skills.upload.commit, y después instalarlo con skills.install({ source: "upload", ... }). Esta ruta está desactivada de forma predeterminada y requiere skills.install.allowUploadedArchives: true en openclaw.json. Las instalaciones normales desde ClawHub nunca necesitan esa opción.

La detección de skills del espacio de trabajo, del agente del proyecto y de directorios adicionales solo acepta raíces de skills cuya ruta real resuelta permanezca dentro de la raíz configurada, salvo que skills.load.allowSymlinkTargets confíe explícitamente en una raíz de destino. El Taller de skills solo escribe a través de esos destinos de confianza cuando skills.workshop.allowSymlinkTargetWrites está habilitado. Los directorios gestionados ~/.openclaw/skills y personales ~/.agents/skills pueden contener carpetas de skills con enlaces simbólicos, pero la ruta real de cada SKILL.md debe permanecer dentro del directorio resuelto de la skill.

Configure security.installPolicy para ejecutar un comando de política local de confianza antes de que continúen las instalaciones de skills. La política recibe metadatos y la ruta del origen preparado, se aplica a las rutas de ClawHub, carga, Git, local, actualización e instalador de dependencias, y aplica un cierre seguro cuando el comando no puede devolver una decisión válida.

skills.entries.*.env y skills.entries.*.apiKey inyectan secretos en el proceso host solo durante ese turno del agente, no en el entorno aislado. Mantenga los secretos fuera de los prompts y registros.

• Cuando se enumeran varios instaladores, el Gateway elige una opción preferida (brew cuando está disponible; de lo contrario, node).
• Si todos los instaladores son download, OpenClaw enumera cada entrada para que se puedan ver todos los artefactos disponibles.
• Las especificaciones pueden incluir os: ["darwin"|"linux"|"win32"] para filtrar por plataforma.
• Las instalaciones de Node respetan skills.install.nodeManager en openclaw.json (valor predeterminado: npm; opciones: npm / pnpm / yarn / bun). Esto solo afecta a las instalaciones de skills; el entorno de ejecución del Gateway debe seguir siendo Node.
• Preferencia de instaladores del Gateway: Homebrew → uv → gestor de node configurado → go → descarga.

• Homebrew: OpenClaw no instala Homebrew automáticamente ni traduce las fórmulas de brew a comandos de paquetes del sistema. En contenedores Linux sin brew, los instaladores que solo usan brew se ocultan; utilice una imagen personalizada o instale la dependencia manualmente.
• Go: OpenClaw requiere Go 1.21 o una versión posterior para las instalaciones automáticas de skills. Si falta go y Homebrew está disponible, OpenClaw instala primero Go mediante Homebrew; en Linux sin Homebrew, puede usar en su lugar apt-get como root o mediante sudo sin contraseña cuando el candidato actualizado de golang-go cumple la versión mínima. El go install real de la dependencia siempre apunta a un directorio de binarios dedicado y administrado por OpenClaw (bin de Homebrew en una instalación nueva; de lo contrario, ~/.local/bin), en lugar de su GOBIN configurado; sus propias variables de entorno GOBIN, GOPATH y GOTOOLCHAIN se leen, pero nunca se sobrescriben.
• Descarga: url (obligatorio), archive (tar.gz | tar.bz2 | zip), extract (valor predeterminado: automático cuando se detecta un archivo), stripComponents, targetDir (valor predeterminado: ~/.openclaw/tools/<skillKey>).

requires.bins se comprueba en el host durante la carga de la skill. Si un agente se ejecuta en un entorno aislado, el binario también debe existir dentro del contenedor. Instálelo mediante agents.defaults.sandbox.docker.setupCommand o una imagen personalizada. setupCommand se ejecuta una vez después de crear el contenedor y requiere acceso de salida a la red, un sistema de archivos raíz con permisos de escritura y un usuario root en el entorno aislado.

De forma predeterminada, OpenClaw observa las carpetas de skills y actualiza la instantánea cuando cambian los archivos SKILL.md. Configúrelo en skills.load:

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

Los eventos del observador utilizan una estabilización integrada de 250 ms. Utilice allowSymlinkTargets para estructuras intencionales con enlaces simbólicos en las que un enlace simbólico de la raíz de una skill apunta fuera de la raíz configurada, por ejemplo, <workspace>/skills/manager -> ~/Projects/manager/skills. Habilite skills.workshop.allowSymlinkTargetWrites solo cuando Skill Workshop también deba aplicar propuestas mediante esas rutas de enlaces simbólicos de confianza.

Si el Gateway se ejecuta en Linux, pero hay conectado un nodo macOS con system.run permitido, OpenClaw puede considerar aptas las skills exclusivas de macOS cuando los binarios necesarios están presentes en ese nodo. El agente debe ejecutar esas skills mediante la herramienta exec con host=node.

Los nodos sin conexión no hacen visibles las skills exclusivas de acceso remoto. Si un nodo deja de responder a los sondeos de binarios, OpenClaw borra sus coincidencias de binarios almacenadas en caché.