Configuración de skills en OpenClaw

Casi todo lo que decide qué skills ve un agente de OpenClaw y cómo se instalan vive bajo una sola clave del archivo de configuración, con la visibilidad por agente bajo las entradas de los agentes. La página de referencia es larga porque el esquema abarca la carga, la instalación, el filtrado, el Workshop y una política de instalación propiedad del host. Aquí tienes toda la superficie en orden: carga y enlaces simbólicos, preferencias de instalación, la política de instalación y cómo falla en modo cerrado, la lista de permitidos de las skills incluidas y las entradas por skill, las listas de permitidos por agente y lo que no son, los ajustes del Workshop y la trampa del entorno aislado.

Carga e instalación

• Los directorios adicionales se examinan con la precedencia más baja, por debajo de las skills incluidas y las de plugins, con expansión de la tilde; los destinos de enlaces simbólicos de confianza son los directorios reales en los que puede resolverse una carpeta de skill enlazada aunque el enlace esté fuera de la raíz configurada, y la documentación aconseja mantener esa lista acotada en lugar de apuntarla a un directorio personal; el vigilante, activado por defecto, actualiza la instantánea de skills cuando cambia un archivo de skill.
• Preferencias de instalación: preferir los instaladores de Homebrew cuando estén disponibles, un gestor de paquetes de Node entre npm, pnpm, yarn y bun que solo afecta a las instalaciones de skills, y un interruptor desactivado por defecto que permite a los clientes administradores de confianza instalar archivos zip privados preparados mediante el flujo de subida.
• La política de instalación del operador ejecuta un comando local de confianza después de que OpenClaw haya preparado la fuente y antes de que continúe una instalación o actualización, para skills de ClawHub, subidas, de Git y locales, instaladores de dependencias y fuentes de plugins; recibe un objeto JSON que describe el destino, la fuente y el origen, y responde allow, warn o block con un motivo y hallazgos opcionales. Si está activada sin un comando válido, las instalaciones fallan en modo cerrado, y lo mismo ocurre con un block, una salida distinta de cero, un tiempo de espera agotado, un JSON no válido o la falta de un motivo.
• Una advertencia detiene la instalación antes de confirmarla: los comandos interactivos piden al operador que escriba el nombre del destino y vuelven a ejecutar la política, los comandos no interactivos pueden pasar un flag de confirmación explícita, la Control UI puede revisar las advertencias de instalación de plugins, las demás instalaciones automáticas o respaldadas por el Gateway siguen bloqueadas, y force nunca aprueba una advertencia. Los hallazgos tienen un límite de cien y el aviso mostrado, de cuatro mil caracteres; la ejecución profunda de doctor lanza una sonda de instalación sintética, y las actualizaciones masivas aplican la política por destino.

Las listas de permitidos de skills por agente son un filtro de visibilidad y de carga para el descubrimiento de skills de OpenClaw, los prompts, el descubrimiento de comandos slash, la sincronización del entorno aislado y las instantáneas de skills. No son un límite de autorización en tiempo de shell.

Entradas y listas de permitidos

La lista de permitidos de las skills incluidas solo restringe las skills incluidas; las skills gestionadas, las de nivel de agente y las del espacio de trabajo no se ven afectadas. Las entradas por skill se indexan por el nombre de la skill o por su clave de skill declarada: un indicador enabled que desactiva una skill aunque esté incluida o instalada, y que es lo que activa la skill opcional coding-agent una vez que hay una CLI compatible instalada y con la sesión iniciada; un campo de comodidad para la clave de API en las skills que declaran una variable de entorno principal, como texto plano o como referencia a un secreto; variables de entorno inyectadas en la ejecución del agente solo cuando no están ya definidas en el proceso; y un espacio libre para campos personalizados. La generación de imágenes integrada usa los ajustes del modelo multimedia y la herramienta de imágenes principal en lugar de una entrada. Las listas de permitidos por agente dan a las mismas raíces de máquina y de espacio de trabajo un conjunto visible distinto por agente: una base compartida en los valores predeterminados, heredada por los agentes que omiten su propia lista, y listas explícitas que reemplazan por completo los valores predeterminados, donde una lista vacía no expone ninguna skill. La advertencia importa: si un agente puede ejecutar exec en el host, ese shell todavía puede ejecutar clientes externos y leer archivos del host visibles para el usuario de ejecución, incluidos los registros de clientes MCP, así que el aislamiento por agente requiere un entorno aislado o aislamiento por usuario del sistema operativo, un exec denegado o con una lista de permitidos estricta, y credenciales por agente en el servidor MCP.

Workshop, enlaces simbólicos, entornos aislados

• Ajustes del Workshop: un modo autónomo off, propose o auto, donde auto, el predeterminado, usa las herramientas normales del agente para el mantenimiento directo por turno y semanal sin escaneo de propuestas, mientras que propose crea propuestas pendientes a partir de correcciones y de trabajo sustancial completado; una política de aprobación auto o pending; un máximo de cincuenta propuestas pendientes y en cuarentena por agente, dentro de un rango de uno a doscientos; y un cuerpo de propuesta máximo de cuarenta mil bytes, dentro de un rango de aproximadamente mil a doscientos mil, con las descripciones limitadas de forma estricta a 160 bytes.
• Las raíces de skills del espacio de trabajo, de agente de proyecto, de directorios adicionales y de skills incluidas son límites de contención, así que una carpeta de skill enlazada que se resuelve fuera de su raíz se omite con una línea en el registro salvo que su destino sea de confianza; los directorios de skills gestionadas y personales aceptan sin condiciones los enlaces simbólicos a directorios de skills, y el Workshop usa el directorio de contención propio de cada agente, ignora la lista de destinos de confianza y rechaza los enlaces simbólicos que escapan de él.
• Los valores de entorno y de clave de API por skill solo se aplican a las ejecuciones en el host: dentro de un entorno aislado no tienen efecto, así que una skill que depende de una clave falla con un error de clave no configurada salvo que el entorno aislado reciba la variable por separado a través del env del entorno aislado de Docker, y los usuarios con acceso al daemon de Docker pueden leer esos valores en los metadatos del contenedor, así que un archivo de secreto montado o una imagen personalizada es la respuesta cuando esa exposición es inaceptable.

El autoaprendizaje de OpenClaw explica las reglas de elegibilidad y privacidad detrás del modo autónomo, y crear una skill de OpenClaw, el archivo que vigila el cargador.

Por qué importa la nota sobre el límite

El esquema mezcla controles de visibilidad con controles de seguridad, y la documentación se cuida de decir cuál es cuál: las listas de permitidos determinan lo que se le ofrece al agente, la política de instalación determina lo que se puede instalar, y solo el aislamiento o la separación por usuario del sistema operativo determinan a qué puede llegar un shell. El aislamiento de OpenClaw, explicado es esa última capa, y los plugins de OpenClaw, la superficie de instalación hermana que la política también cubre.

En Diali

En Diali, el hub de skills del panel es la fachada de este archivo: activar una skill y pegar su clave es lo que se convierte en la entrada en el asistente, y no hay ningún shell en el host para editarlo a mano. OpenClaw alojado en Diali es el asistente y la seguridad en Diali describe el límite que rodea a cada uno.

• Las listas de permitidos reemplazan; nunca se fusionan.
• La política de instalación falla en modo cerrado ante cualquier cosa que no sea un allow limpio.
• Las variables de entorno de las skills se detienen en el muro del entorno aislado.