Skip to content

Escribe tu propio Skill: SKILL.md y publicación en ClawHub ​

Objetivo en una frase: completar con tus propias manos tu primer desarrollo de habilidades en OpenClaw: escribir desde cero una habilidad hello-world, recorrer toda la cadena «crear directorio → escribir SKILL.md → verificar la invocación» y aclarar qué hay que preparar antes de publicar en ClawHub.

Preparación ​

  • Haber completado la lección anterior «Primeros pasos con Skills: instalación, uso y configuración» y saber usar habilidades ya hechas.
  • Tener OpenClaw instalado en la máquina (Node 24.16.0+ o 26.1.0+), con el comando openclaw disponible.
  • Basta con una ventana de terminal; no se necesitan dependencias adicionales.

Hazlo conmigo ​

Paso 1: crear el directorio de la habilidad ​

Las habilidades se colocan en la carpeta skills/ del espacio de trabajo; una habilidad es un directorio:

bash
mkdir -p ~/.openclaw/workspace/skills/hello-world

Si quieres agruparlas, también puedes usar subcarpetas (por ejemplo skills/personal/hello-world); el nombre de la habilidad sigue determinado por el frontmatter de SKILL.md, y la invocación sigue siendo /hello-world.

Resultado esperado: el directorio skills/hello-world/ se crea correctamente; OpenClaw por defecto vigila el archivo SKILL.md bajo el directorio raíz de skills.

Paso 2: escribir SKILL.md ​

Crea un SKILL.md nuevo en el directorio: en el frontmatter escribe los metadatos y en el cuerpo las instrucciones para el agent.

markdown
---
name: hello-world
description: A simple skill that prints a greeting.
---

# Hello World

When the user asks for a greeting, use the `exec` tool to run:

```bash
echo "Hello from your custom skill!"
```

Hay que respetar tres reglas de nomenclatura: name usa solo letras minúsculas, números y guiones; el nombre del directorio debe coincidir con el name del frontmatter; description se comprime en una sola línea y no supera los 160 caracteres: se muestra al agent y también aparece en el descubrimiento de comandos con barra.

Resultado esperado: el archivo se guarda como skills/hello-world/SKILL.md y el frontmatter se analiza correctamente.

Paso 3: verificar la carga y probar ​

bash
openclaw skills list

Si hello-world aparece en la lista, ya está cargada. Si continuaste una sesión antigua o el monitor estaba desactivado, refresca primero:

bash
# 聊天里:归档当前会话,开新会话
/new
bash
# 或重启网关
openclaw gateway restart

Luego prueba:

bash
openclaw agent --message "give me a greeting"

También puedes plantear tu necesidad directamente en el chat, o usar /skill hello-world para invocarla explícitamente por nombre.

Resultado esperado: el agent ejecuta los comandos de la habilidad y te responde con Hello from your custom skill!.

Verificación ​

Revisa punto por punto:

  • openclaw skills list permite ver hello-world.
  • /skill hello-world produce salida al invocarse explícitamente.
  • Tras modificar SKILL.md, /new o una nueva sesión tras reiniciar el gateway obtiene la lista de habilidades actualizada.

Si todo se cumple, tu primera habilidad ya está lista. Una habilidad es en esencia «directorio + SKILL.md»; una vez probada, puedes considerar publicarla en ClawHub para que otros la instalen: instala el CLI independiente de ClawHub (npm i -g clawhub), inicia sesión con clawhub login y publica con clawhub skill publish ~/.openclaw/workspace/skills/hello-world; los detalles como la revisión del registro se rigen por la documentación oficial de ClawHub.

Errores comunes ​

  • El nombre del directorio no coincide con name: el nombre de la habilidad es el del frontmatter, y el nombre del directorio es solo el contenedor; pero si no coinciden es fácil equivocarse al invocar, así que lo más cómodo es mantenerlos alineados.
  • description demasiado larga: superar los 160 caracteres afecta el descubrimiento de comandos con barra; comprímela en una sola línea.
  • Cambios en SKILL.md sin efecto: las sesiones antiguas no actualizan automáticamente la lista de habilidades; prueba con /new abriendo una sesión nueva o tras openclaw gateway restart.

Próxima lección ​

Una vez que tu habilidad escrita a mano funciona, la próxima lección «Skill Workshop: deja que Claw aprenda habilidades por sí mismo» hace que Claw redacte, valide e itere habilidades por ti: así se cierra el círculo completo de «crear-validar-instalar-invocar» de OpenClaw 2.0.

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.