Skills enseña al agente cómo y cuándo usar herramientas. Cada skill es un directorio que contiene un archivoDocumentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
SKILL.md con frontmatter YAML e instrucciones en markdown.
Para saber cómo se cargan y priorizan las skills, consulta Skills.
Crea tu primera skill
Escribe SKILL.md
Crea Usa formato con guiones y letras minúsculas, dígitos y guiones para el
SKILL.md dentro de ese directorio. El frontmatter define los metadatos,
y el cuerpo markdown contiene instrucciones para el agente.name de la skill. Mantén alineados el nombre de la carpeta y el name del frontmatter.Agrega herramientas (opcional)
Puedes definir esquemas de herramientas personalizados en el frontmatter o indicar al agente
que use herramientas del sistema existentes (como
exec o browser). Las Skills también pueden
incluirse dentro de plugins junto con las herramientas que documentan.Carga la skill
Inicia una sesión nueva para que OpenClaw detecte la skill:Verifica que la skill se haya cargado:
Referencia de metadatos de skills
El frontmatter YAML admite estos campos:| Campo | Obligatorio | Descripción |
|---|---|---|
name | Sí | Identificador único que usa letras minúsculas, dígitos y guiones |
description | Sí | Descripción de una línea que se muestra al agente |
metadata.openclaw.os | No | Filtro de SO (["darwin"], ["linux"], etc.) |
metadata.openclaw.requires.bins | No | Binarios requeridos en PATH |
metadata.openclaw.requires.config | No | Claves de configuración requeridas |
Buenas prácticas
- Sé conciso — indica al modelo qué hacer, no cómo ser una IA
- La seguridad primero — si tu skill usa
exec, asegúrate de que los prompts no permitan inyección arbitraria de comandos desde entradas no confiables - Prueba localmente — usa
openclaw agent --message "..."para probar antes de compartir - Usa ClawHub — explora y contribuye skills en ClawHub
Dónde viven las skills
| Ubicación | Precedencia | Alcance |
|---|---|---|
\<workspace\>/skills/ | Más alta | Por agente |
\<workspace\>/.agents/skills/ | Alta | Agente por espacio de trabajo |
~/.agents/skills/ | Media | Perfil de agente compartido |
~/.openclaw/skills/ | Media | Compartido (todos los agentes) |
| Incluidas (enviadas con OpenClaw) | Baja | Global |
skills.load.extraDirs | Más baja | Carpetas compartidas personalizadas |
Relacionado
- Referencia de Skills — carga, precedencia y reglas de control
- Configuración de Skills — esquema de configuración
skills.* - ClawHub — registro público de skills
- Creación de Plugins — los plugins pueden incluir skills