Skills

• Omite agents.defaults.skills para que, de forma predeterminada, ninguna Skill esté restringida.
• Omite agents.list[].skills para heredar agents.defaults.skills.
• Establece agents.list[].skills: [] para no exponer ninguna Skill a ese agente.
• Una lista agents.list[].skills no vacía es el conjunto definitivo: no se combina con los valores predeterminados.
• La lista de permitidos efectiva se aplica a la creación de prompts, la detección de comandos con barra, la sincronización del sandbox y las instantáneas de Skills.
• Esto no constituye un límite de autorización para el shell del host. Si el mismo agente puede usar exec, restringe ese shell por separado mediante sandboxing, aislamiento de usuarios del sistema operativo, listas de denegación/permitidos de ejecución y credenciales por recurso.

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

Las instalaciones desde Git y locales esperan encontrar SKILL.md en la raíz del origen. El slug se obtiene de name en el frontmatter de SKILL.md cuando es válido; de lo contrario, se usa el nombre del directorio o repositorio. Usa --as <slug> para anularlo. openclaw skills update solo realiza el seguimiento de instalaciones de ClawHub; vuelve a instalar 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 instaladas desde ClawHub se verifican con la versión y el registro guardados en .clawhub/origin.json. Se siguen aceptando slugs sin propietario para Skills ya instaladas o inequívocas, pero las referencias que incluyen el 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 termina 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 de Gateway que necesiten una entrega ajena a 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 vía está desactivada de forma predeterminada y requiere skills.install.allowUploadedArchives: true en openclaw.json. Las instalaciones normales de ClawHub nunca necesitan ese ajuste.

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 enlazadas simbólicamente, pero la ruta real de cada SKILL.md debe permanecer dentro de su directorio de Skill resuelto.

Configura security.installPolicy para ejecutar un comando de política local de confianza antes de continuar con la instalación de Skills. La política recibe metadatos y la ruta del origen preparado, se aplica a ClawHub, cargas, Git, orígenes locales, actualizaciones y rutas de instaladores de dependencias, y deniega de forma predeterminada cuando el comando no puede devolver una decisión válida.

skills.entries.*.env y skills.entries.*.apiKey inyectan secretos en el proceso del host solo durante ese turno del agente, no en el sandbox. Mantén los secretos fuera de los prompts y registros.

• Cuando se indican 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 pueda 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 instalación del Gateway: Homebrew → uv → gestor de node configurado → go → download.

• Homebrew: OpenClaw no instala automáticamente Homebrew ni convierte las fórmulas de brew en comandos de paquetes del sistema. En contenedores Linux sin brew, los instaladores que solo usan brew se ocultan; use 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 golang-go cumple la versión mínima. El comando go install real para la dependencia siempre usa como destino un directorio de binarios dedicado y administrado por OpenClaw (el directorio bin de Homebrew en una instalación nueva; de lo contrario, ~/.local/bin), en vez del GOBIN configurado; se leen sus propias variables de entorno GOBIN, GOPATH y GOTOOLCHAIN, 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 supervisa 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, // default      watchDebounceMs: 250, // default    },  },}

Use allowSymlinkTargets para estructuras intencionadas con enlaces simbólicos en las que un enlace simbólico de la raíz de una skill apunte 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 que solo están disponibles de forma remota. Si un nodo deja de responder a las comprobaciones de binarios, OpenClaw borra de la caché sus coincidencias de binarios.