Skills
Autoaprendizaje
El autoaprendizaje permite que OpenClaw convierta la evidencia útil de las conversaciones en propuestas pendientes de Skill Workshop. No entrena los pesos del modelo, edita Skills activas ni cambia silenciosamente el comportamiento del agente. Cada procedimiento aprendido permanece pendiente hasta que un operador lo revisa y aplica.
El autoaprendizaje está desactivado de forma predeterminada. Actívelo únicamente cuando una ejecución adicional del modelo en segundo plano y la revisión de la transcripción sean apropiadas para el espacio de trabajo.
Activar el autoaprendizaje
En la interfaz de control, abra Plugins → Workshop y active Self-learning. El cambio surte efecto inmediatamente; cuando otro proceso de escritura de configuración haya actualizado el archivo, la interfaz de control actualiza la instantánea de configuración y vuelve a intentar el cambio sin recargar la página ni el Gateway.
Use la CLI:
openclaw config set skills.workshop.autonomous.enabled true --strict-jsonO edite ~/.openclaw/openclaw.json:
{ skills: { workshop: { autonomous: { enabled: true, }, }, },}Vuelva a desactivarlo con:
openclaw config set skills.workshop.autonomous.enabled false --strict-jsonLa creación de Skills solicitada por el usuario, /learn y las operaciones manuales de Skill Workshop
siguen funcionando mientras el autoaprendizaje está desactivado.
Revisar manualmente sesiones anteriores
La revisión manual del historial es la alternativa conservadora a la captura autónoma.
Abra Plugins → Workshop en la interfaz de control y seleccione Find skill ideas.
Esto no cambia skills.workshop.autonomous.enabled.
Cada análisis:
- comienza con las sesiones sin revisar más recientes y retrocede;
- revisa hasta 20 sesiones sustanciales con al menos seis turnos del modelo;
- omite sesiones de Cron, Heartbeat, enlaces, subagentes, ACP, propiedad de plugins y revisión interna;
- oculta los secretos reconocidos y limita el paquete de transcripciones antes de enviarlo al modelo configurado del agente seleccionado;
- aplica el mismo criterio estricto que la revisión autónoma de experiencias; y
- puede crear o revisar como máximo tres propuestas pendientes, nunca Skills activas.
Workshop informa del recuento acumulado de sesiones, la cobertura de fechas y las ideas encontradas. Seleccione Scan earlier work para consultar el siguiente intervalo más antiguo. Cuando el cursor alcanza el principio del historial apto, la acción cambia a Scan new work. OpenClaw solo conserva los metadatos del cursor y la cobertura en la base de datos de estado compartida; no crea un segundo archivo de transcripciones.
Las sesiones solo se analizan cuando OpenClaw puede demostrar su propiedad y excluir el contenido de enlaces externos. Después de una actualización, la transcripción actual anterior a la actualización puede clasificarse localmente, pero se omiten las transcripciones rotadas anteriores a la actualización que no tengan procedencia por ejecución. Las transcripciones nuevas conservan esta procedencia tras la rotación.
Los análisis manuales siguen generando costes del proveedor del modelo y envían el contenido apto de la conversación al proveedor configurado. Úselos únicamente cuando esa revisión se ajuste a los requisitos de privacidad y tratamiento de datos del espacio de trabajo.
Qué puede aprender OpenClaw
El autoaprendizaje tiene dos vías conservadoras:
- Instrucciones directas y correcciones. OpenClaw detecta expresiones duraderas como «a partir de ahora», «la próxima vez» y correcciones de un enfoque fallido. Con el autoaprendizaje activado, puede convertir esas señales en propuestas pendientes sin esperar a otra solicitud. Esta vía determinista puede agrupar instrucciones relacionadas en hasta tres propuestas, dirigirse a una Skill modificable del espacio de trabajo o revisar su propia propuesta pendiente relacionada. También se ejecuta después de turnos fallidos porque captura las instrucciones del usuario en lugar de evaluar su finalización.
- Revisión de experiencias. Después de un turno en primer plano sustancial y completado correctamente, OpenClaw puede revisar el trabajo terminado en busca de una técnica de recuperación reutilizable o un procedimiento estable que elimine al menos dos futuras rondas de interacción con el modelo o las herramientas.
Entre los buenos candidatos se incluyen:
- una recuperación fiable después de fallos repetidos de herramientas o modelos;
- una restricción de orden no evidente que evitó un error recurrente;
- un flujo de trabajo estable de varios pasos que exigía búsquedas repetidas; o
- una comprobación previa reutilizable que evitaría varias llamadas futuras.
El revisor debe abstenerse ante trabajos rutinarios completados correctamente, solicitudes puntuales, datos personales, preferencias simples, fallos transitorios del entorno, consejos genéricos, afirmaciones negativas sin respaldo y secretos.
Cuándo se ejecuta la revisión de experiencias
La revisión de experiencias se retrasa y limita deliberadamente:
- El turno en primer plano debe finalizar correctamente.
- El turno actual debe contener al menos diez iteraciones del modelo.
- Se excluyen las sesiones de Cron, Heartbeat, memoria, desbordamiento, enlaces, subagentes y revisión.
- La ejecución en primer plano debe haber resuelto un proveedor y un modelo, y debe haber tenido realmente
acceso a
skill_workshop. - OpenClaw espera 30 segundos después de la finalización. Una finalización posterior en primer plano dentro de la misma sesión reinicia ese período de inactividad.
- Si aún hay alguna ejecución de agente o respuesta activa, la revisión espera otros 30 segundos.
- Solo se ejecuta una revisión de experiencias a la vez.
- La revisión retrasada es trabajo del Gateway local al proceso. El Gateway debe seguir ejecutándose durante el período de inactividad; los entornos de ejecución locales de una sola ejecución y los basados en la CLI no conservan suficiente contexto de trayectoria y disponibilidad de herramientas para programarla.
La respuesta en primer plano nunca se retrasa por el aprendizaje. Un turno fallido o no apto no inicia la revisión de experiencias, aunque las correcciones directas del usuario aún pueden ofrecerse como sugerencia cuando la autonomía está desactivada.
Qué recibe el revisor
El revisor en segundo plano recibe únicamente el turno actual, comenzando por su mensaje de usuario más reciente. La trayectoria renderizada se limita a 60,000 caracteres; cuando es necesario, OpenClaw conserva el primer mensaje y la evidencia más reciente, y marca la parte intermedia omitida.
El revisor reutiliza el proveedor y el modelo resueltos. Reutiliza el perfil de autenticación en primer plano cuando esa identidad está disponible y desactiva las alternativas del modelo. Por tanto, la revisión inicia una ejecución adicional del modelo en el proveedor configurado. Esa ejecución puede realizar más de una solicitud al proveedor cuando inspecciona o redacta una propuesta. Se aplican los precios y las condiciones de tratamiento de datos del proveedor, al igual que en el turno en primer plano.
Antes de comenzar, OpenClaw vuelve a cargar la configuración actual del entorno de ejecución y comprueba de nuevo la
política efectiva de aislamiento y herramientas de la conversación original. Si la ejecución está
aislada, la política ya no permite skill_workshop o faltan datos necesarios del entorno de ejecución,
la revisión se cierra de forma segura y no crea nada.
Seguridad de las propuestas
El revisor se ejecuta en una sesión aislada con un conjunto de herramientas deliberadamente restringido:
- Solo puede enumerar o inspeccionar propuestas de Workshop y crear o revisar una propuesta pendiente.
- No puede actualizar una Skill activa, aplicar una propuesta, rechazar una propuesta, poner en cuarentena una propuesta, enviar un mensaje ni usar herramientas generales del agente.
- Se comparte un presupuesto de una mutación entre los reintentos del modelo, por lo que una revisión puede crear o revisar como máximo una propuesta.
- La trayectoria revisada se trata como evidencia no fiable, no como instrucciones para el agente en segundo plano.
- Skill Workshop analiza el contenido de la propuesta y rechaza las credenciales literales reconocidas antes de escribir el estado de la propuesta.
Se siguen aplicando los límites normales de Workshop, incluidos maxPending, maxSkillBytes,
las restricciones de archivos auxiliares, las comprobaciones del analizador y las escrituras exclusivas en el espacio de trabajo. La
configuración approvalPolicy: "auto" no concede al revisor en segundo plano acceso
a las acciones del ciclo de vida.
Revisar las propuestas aprendidas
El autoaprendizaje genera las mismas propuestas pendientes que el uso manual de Workshop. Inspecciónelas antes de aplicarlas:
openclaw skills workshop listopenclaw skills workshop inspect <proposal-id>openclaw skills workshop apply <proposal-id>Revise, rechace o ponga en cuarentena las propuestas que sean útiles pero aún no estén listas:
openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.mdopenclaw skills workshop reject <proposal-id> --reason "Too specific"openclaw skills workshop quarantine <proposal-id> --reason "Needs security review"Aplicar es la única operación que escribe una SKILL.md activa. Consulte
Skill Workshop para conocer el ciclo de vida y el modelo de almacenamiento
completos.
Configuración
| Ajuste | Valor predeterminado | Efecto del autoaprendizaje |
|---|---|---|
skills.workshop.autonomous.enabled |
false |
Activa la captura directa de correcciones y la revisión retrasada de experiencias. |
skills.workshop.approvalPolicy |
"auto" |
Controla las solicitudes de aprobación para las acciones normales del ciclo de vida iniciadas por agentes; no amplía los permisos del revisor en segundo plano. |
skills.workshop.maxPending |
50 |
Limita las propuestas pendientes y en cuarentena por espacio de trabajo. |
skills.workshop.maxSkillBytes |
40000 |
Limita el tamaño del cuerpo de la propuesta en bytes. |
skills.workshop.allowSymlinkTargetWrites |
false |
Solo afecta al comportamiento de aplicación; el autoaprendizaje escribe el estado de la propuesta, no los destinos de Skills activas. |
Para consultar el esquema exhaustivo, los intervalos y los ajustes relacionados con Skills, consulte Configuración de Skills.
Solución de problemas
No aparece ninguna propuesta después de un turno largo
Compruebe todo lo siguiente:
skills.workshop.autonomous.enabledestrueen la configuración activa del Gateway.- El turno finalizó correctamente e incluyó al menos diez iteraciones del modelo después del mensaje de usuario más reciente.
- La conversación fue una ejecución normal en primer plano, no una ejecución programada, de memoria, de enlace ni de subagente.
- La ejecución original tuvo acceso a
skill_workshopy no estaba aislada. - El sistema permaneció inactivo el tiempo suficiente para la revisión retrasada.
- El proceso de larga duración del Gateway permaneció activo durante el período de inactividad; un comando local de una sola ejecución no espera la revisión retrasada.
Una revisión apta puede seguir sin generar ninguna propuesta. La abstención es el resultado esperado cuando la evidencia no supera el criterio de procedimiento reutilizable.
Doctor informa que la herramienta Workshop está oculta
Cuando el autoaprendizaje está activado, openclaw doctor comprueba si la política efectiva
de herramientas del agente predeterminado permite skill_workshop. Aplique el cambio indicado en
tools.allow o tools.alsoAllow, o desactive el autoaprendizaje.
Aparecen demasiadas propuestas de poco valor
Desactive el autoaprendizaje y siga usando /learn o solicitudes explícitas de Workshop:
openclaw config set skills.workshop.autonomous.enabled false --strict-jsonLas propuestas pendientes siguen pudiéndose revisar después de desactivar la función. Desactivar el autoaprendizaje no las aplica, rechaza ni elimina.
Contenido relacionado
- Taller de Skills para la revisión, aprobación y almacenamiento de propuestas
- Creación de Skills para Skills creadas manualmente y
la estructura
SKILL.md - Configuración de Skills para todos los ajustes de
skills.* - CLI de Skills para los comandos del Taller y de curador