Crear habilidades

Las habilidades enseñan al agente cómo y cuándo usar las herramientas. Cada habilidad es un directorio que contiene un archivo SKILL.md con frontmatter YAML e instrucciones markdown. OpenClaw carga habilidades desde varias raíces en un orden de precedencia definido.

Crea tu primera habilidad

1. Crear el directorio de la habilidad

   Las habilidades residen en su carpeta del espacio de trabajo skills/. Cree un directorio para su nueva habilidad:

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

   Puede agrupar habilidades en subcarpetas para organizarlas — la habilidad aún se nombra por el frontmatter SKILL.md, no por la ruta de la carpeta:

   mkdir -p ~/.openclaw/workspace/skills/personal/hello-world
   # skill name is still "hello-world", invoked as /hello-world

2. Escribir SKILL.md

   Cree SKILL.md dentro del directorio. El frontmatter define los metadatos; el cuerpo le da instrucciones al agente.

   ---
   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!"

   Reglas de nomenclatura:
   - Use letras minúsculas, dígitos y guiones para `name`.
   - Mantenga el nombre del directorio y el frontmatter `name` alineados.
   - `description` se muestra al agente y en el descubrimiento de comandos de barra —
     manténgalo en una línea y por debajo de 160 caracteres.

3. Verificar que la habilidad se cargó

   openclaw skills list

   OpenClaw observa los archivos SKILL.md bajo las raíces de habilidades por defecto. Si el observador está deshabilitado o está continuando una sesión existente, inicie una nueva para que el agente reciba la lista actualizada:

   # From chat — archive current session and start fresh
   /new
   
   # Or restart the gateway
   openclaw gateway restart

4. Probarlo

   Envíe un mensaje que debería activar la habilidad:

   openclaw agent --message "give me a greeting"

   O abra un chat y pregúntele al agente directamente. Use /skill hello-world para invocarla explícitamente por nombre.

Referencia de SKILL.md

Campos obligatorios

Campo	Descripción
name	Identificador único usando letras minúsculas, dígitos y guiones
description	Descripción de una línea mostrada al agente y en el resultado de descubrimiento

Claves de frontmatter opcionales

Campo	Predeterminado	Descripción
user-invocable	true	Exponer la habilidad como un comando de barra diagonal del usuario
disable-model-invocation	false	Mantener la habilidad fuera del mensaje del sistema del agente (aún se ejecuta a través de /skill)
command-dispatch	—	Establézcalo en tool para enrutar el comando de barra directamente a una herramienta, omitiendo el modelo
command-tool	—	Nombre de la herramienta a invocar cuando command-dispatch: tool está establecido
command-arg-mode	raw	Para el envío a la herramienta, reenvía la cadena de argumentos cruda a la herramienta
homepage	—	URL que se muestra como “Sitio web” en la interfaz de usuario de Habilidades de macOS

Para los campos de puerta de enlace (requires.bins, requires.env, etc.) consulte Habilidades — Puerta de enlace.

Uso de {baseDir}

Use {baseDir} en el cuerpo de la habilidad para hacer referencia a archivos dentro del directorio de la habilidad sin codificar rutas:

Run the helper script at `{baseDir}/scripts/run.sh`.

Agregar activación condicional

Establezca una puerta de enlace para su habilidad para que solo se cargue cuando sus dependencias estén disponibles:

---
name: gemini-search
description: Search using Gemini CLI.
metadata: { "openclaw": { "requires": { "bins": ["gemini"] }, "primaryEnv": "GEMINI_API_KEY" } }
---

Opciones de filtrado

Clave	Descripción
requires.bins	Todos los binarios deben existir en PATH
requires.anyBins	Al menos un binario debe existir en PATH
requires.env	Cada variable de entorno debe existir en el proceso o en la configuración
requires.config	Cada ruta openclaw.json debe ser verdadera
os	Filtro de plataforma: ["darwin"], ["linux"], ["win32"]
always	Establezca true para omitir todos los filtros e incluir siempre la skill

Referencia completa: Skills — Gating.

Entorno y claves API

Conecte una clave API a una entrada de skill en openclaw.json:

{
  skills: {
    entries: {
      "gemini-search": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" },
      },
    },
  },
}

La clave se inyecta en el proceso host solo para ese turno del agente. No llega al sandbox — consulte variables de entorno en sandbox.

Proponer a través de Skill Workshop

Para habilidades redactadas por el agente o cuando desee una revisión del operador antes de que una habilidad se active, use propuestas de Skill Workshop en lugar de escribir SKILL.md directamente.

# Propose a brand-new skill
openclaw skills workshop propose-create \
  --name "hello-world" \
  --description "A simple skill that prints a greeting." \
  --proposal ./PROPOSAL.md

# Propose an update to an existing skill
openclaw skills workshop propose-update hello-world \
  --proposal ./PROPOSAL.md \
  --description "Updated greeting skill"

Use --proposal-dir cuando la propuesta incluya archivos de soporte:

openclaw skills workshop propose-create \
  --name "hello-world" \
  --description "A simple skill that prints a greeting." \
  --proposal-dir ./hello-world-proposal/

El directorio debe contener PROPOSAL.md. Los archivos de soporte pueden ir en assets/, examples/, references/, scripts/ o templates/.

Después de la revisión:

openclaw skills workshop inspect <proposal-id>
openclaw skills workshop apply <proposal-id>

Consulte Skill Workshop para ver el ciclo de vida completo de la propuesta.

Publicar en ClawHub

1. Asegúrese de que su SKILL.md esté completo

   Asegúrese de que name, description y cualquier metadata.openclaw campos de filtrado estén configurados. Agregue una URL homepage si tiene una página de proyecto.

2. Instalar la habilidad ClawHub

   La habilidad ClawHub documenta la forma actual del comando de publicación y los metadatos requeridos:

   openclaw skills install clawhub-publish

3. Publicar

   clawhub publish

   Consulte ClawHub — Publicación para ver el flujo completo.

Mejores prácticas

Tip

• Sea conciso — indique al modelo qué hacer, no cómo ser una IA. - Seguridad primero — si su habilidad usa exec, asegúrese de que los prompts no permitan la inyección de comandos arbitrarios desde entradas que no son de confianza. - Pruebe localmente — use openclaw agent --message "..." antes de compartir. - Use ClawHub — explore las habilidades de la comunidad en clawhub.ai antes de construir desde cero.

Relacionado

Referencia de habilidades

Orden de carga, restricciones, listas de permitidos y formato SKILL.md.

Skill Workshop

Cola de propuestas para habilidades redactadas por el agente.

Configuración de habilidades

Esquema de configuración skills.* completo.

ClawHub

Explore y publique habilidades en el registro público.

Construcción de complementos

Los complementos pueden incluir habilidades junto con las herramientas que documentan.