Skills

• Omite agents.defaults.skills para dejar todas las skills sin restricciones de forma predeterminada.
• Omite agents.list[].skills para heredar agents.defaults.skills.
• Establece agents.list[].skills: [] para no exponer skills para ese agente.
• Una lista no vacía agents.list[].skills es el conjunto final: no se fusiona con los valores predeterminados.
• La lista de permitidos efectiva se aplica a la construcción de prompts, el descubrimiento de comandos slash, la sincronización de sandbox y las instantáneas de skills.
• Esto no es un límite de autorización del shell del host. Si el mismo agente puede usar exec, restringe ese shell por separado con sandboxing, aislamiento de usuario del SO, listas de denegación/permitidos de exec y credenciales por recurso.

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

Las instalaciones desde Git y locales esperan SKILL.md en la raíz de origen. El slug proviene del frontmatter name de SKILL.md cuando es válido, y luego recurre al nombre del directorio o repositorio. Usa --as <slug> para anularlo. openclaw skills update rastrea solo instalaciones de ClawHub: reinstala fuentes Git o locales para actualizarlas.

openclaw skills verify @owner/<slug> pide a ClawHub el sobre de confianza clawhub.skill.verify.v1 de la skill. Las skills de ClawHub instaladas se verifican contra la versión y el registro guardados en .clawhub/origin.json. Los slugs simples siguen aceptándose para skills existentes instaladas o inequívocas, pero las referencias calificadas por propietario evitan ambigüedad de publicador.

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

Los clientes de Gateway que necesitan entrega fuera de ClawHub pueden preparar un archivo zip de skill con skills.upload.begin, skills.upload.chunk y skills.upload.commit, y luego instalar con skills.install({ source: "upload", ... }). Esta ruta está desactivada de forma predeterminada y requiere skills.install.allowUploadedArchives: true en openclaw.json. Las instalaciones normales de ClawHub nunca necesitan esa opción.

El descubrimiento de skills de espacio de trabajo, agente de proyecto y directorio adicional solo acepta raíces de skills cuyo realpath resuelto permanezca dentro de la raíz configurada, a menos que skills.load.allowSymlinkTargets confíe explícitamente en una raíz de destino. Skill Workshop escribe mediante esos destinos confiables solo cuando skills.workshop.allowSymlinkTargetWrites está habilitado. Las skills gestionadas ~/.openclaw/skills y personales ~/.agents/skills pueden contener carpetas de skills con enlaces simbólicos, pero cada realpath de SKILL.md debe seguir permaneciendo dentro de su directorio de skill resuelto.

Configura security.installPolicy para ejecutar un comando de política local confiable antes de que continúen las instalaciones de skills. La política recibe metadatos y la ruta de origen preparada, se aplica a rutas de ClawHub, subidas, Git, locales, de actualización y de instalador de dependencias, y falla de forma cerrada 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 para ese turno del agente, no en el sandbox. Mantén los secretos fuera de prompts y logs.

• Cuando se listan varios instaladores, el Gateway elige una opción preferida (brew cuando está disponible; de lo contrario, node).
• Si todos los instaladores son download, OpenClaw lista cada entrada para que puedas 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 runtime del Gateway debe seguir siendo Node.
• Preferencia de instalador del Gateway: Homebrew → uv → gestor de node configurado → go → download.

• Homebrew: OpenClaw no instala Homebrew automáticamente ni traduce fórmulas de brew a comandos de paquetes del sistema. En contenedores Linux sin brew, los instaladores solo de brew se ocultan; usa una imagen personalizada o instala la dependencia manualmente.
• Go: OpenClaw requiere Go 1.21 o posterior para instalaciones automáticas de Skills y conserva la configuración existente de GOBIN, GOPATH y GOTOOLCHAIN. Si la cadena de herramientas configurada no puede satisfacer la versión de Go requerida por un módulo, el onboarding agrupa la Skill con los prerrequisitos manuales de Go después del intento de instalación. Si falta go y Homebrew está disponible, OpenClaw instala Go primero mediante Homebrew y define GOBIN en el bin de Homebrew. En Linux, OpenClaw puede usar en su lugar apt-get como root o mediante sudo sin contraseña cuando el candidato golang-go actualizado cumple la versión mínima.
• Download: 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 Skills. Si un agente se ejecuta en un sandbox, el binario también debe existir dentro del contenedor. Instálalo mediante agents.defaults.sandbox.docker.setupCommand o una imagen personalizada. setupCommand se ejecuta una vez después de crear el contenedor y requiere salida de red, un sistema de archivos raíz escribible y un usuario root en el sandbox.

De forma predeterminada, OpenClaw observa las carpetas de Skills e incrementa la instantánea cuando cambian los archivos SKILL.md. Configúralo bajo skills.load:

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

Usa allowSymlinkTargets para diseños intencionales con enlaces simbólicos donde un enlace simbólico de raíz de Skill apunta fuera de la raíz configurada, por ejemplo <workspace>/skills/manager -> ~/Projects/manager/skills. Habilita skills.workshop.allowSymlinkTargetWrites solo cuando Skill Workshop también deba aplicar propuestas a través de esas rutas enlazadas de confianza.

Si el Gateway se ejecuta en Linux pero hay un nodo macOS conectado con system.run permitido, OpenClaw puede tratar las Skills solo para macOS como elegibles cuando los binarios requeridos 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 solo remotas. Si un nodo deja de responder a sondeos de binarios, OpenClaw borra sus coincidencias de binarios en caché.