Volver

06. Sistema de Skills de OpenClaw en detalle

Skills es el núcleo de las capacidades de extensión de OpenClaw, con más de 5700 paquetes de habilidades contribuidos por la comunidad. Este artículo detalla el concepto de Skills, métodos de instalación, uso de ClawHub, clasificación de habilidades, gestión de configuración, y cómo elegir y usar las habilidades adecuadas para mejorar las capacidades de tu asistente de IA.

Aplica a OpenClaw v2026.2 | Este artículo asume que ya completaste la instalación básica y quieres ampliar las capacidades de tu asistente de IA.

TL;DR: Los Skills son extensiones de capacidades pre-empaquetadas. Instala con openclaw skill install <name>, directorio en ~/.openclaw/workspace/skills/. ClawHub tiene 5700+ skills de la comunidad: asistentes de codificación, búsqueda e investigación, DevOps, automatización web, etc. Cada skill contiene SKILL.md (descripción + palabras clave + instrucciones), implementación de herramientas opcional. Escaneo de seguridad verificado por VirusTotal.

¿Qué son los Skills?

Explicación del concepto

Los Skills son módulos de extensión de capacidades pre-empaquetados que contienen:

Componente Descripción
SKILL.md Archivo de definición del skill, incluye descripción, palabras clave de activación, instrucciones, ejemplos
Tools Funciones de herramientas invocables (opcional)
Resources Archivos de recursos relacionados (opcional)
Package.json Declaración de dependencias (opcional)

Skills vs Tools

Característica Skills Tools
Origen Contribución de la comunidad Integrados/personalizados
Instalación Necesitan instalación Disponibles por defecto
Complejidad Pueden ser muy complejos Generalmente simples
Compartibles Generalmente no se comparten
Actualizaciones Actualizaciones independientes Se actualizan con el sistema

Clasificación de habilidades

Los skills en ClawHub se organizan por categorías:

Categoría Cantidad Skills representativos
Asistente de codificación 133+ coding-agent, debug-pro, tdd-guide
Búsqueda e investigación 253+ web-search, deepwiki, exa-search
DevOps 212+ docker-essentials, git-workflows
Automatización web 139+ browser-control, puppeteer-skill
Herramientas de productividad 135+ calendar-skill, task-manager
Análisis de datos 46+ data-analyzer, budget-variance
Hogar inteligente 56+ home-assistant, smart-home-io
Documentos PDF 67+ pdf-reader, doc-summarizer
Imagen y video 60+ image-gen, video-editor
Notas y conocimiento 100+ obsidian, notion-sync

Métodos de instalación de Skills

Método uno: ClawHub CLI (recomendado)

# Buscar skill
openclaw skill search gmail

# Instalar skill
openclaw skill install gmail

# Instalar versión específica
openclaw skill install [email protected]

# Instalar desde GitHub
openclaw skill install github:user/skill-repo

# Instalar desde ruta local
openclaw skill install ./my-skill

Método dos: Instalación manual

# Clonar repositorio del skill
git clone https://github.com/user/skill-repo.git

# Copiar al directorio de skills
cp -r skill-repo ~/.openclaw/workspace/skills/skill-name

Método tres: Pegar enlace de GitHub

Envía directamente el enlace de GitHub del skill en el chat, el Agent lo identificará e instalará automáticamente:

Por favor instala este skill: https://github.com/user/skill-repo

Estructura del directorio de skills

~/.openclaw/workspace/skills/
├── gmail/
│   └── SKILL.md
├── calendar/
│   └── SKILL.md
├── web-search/
│   ├── SKILL.md
│   └── package.json
└── my-custom-skill/
    ├── SKILL.md
    ├── src/
    │   └── index.js
    └── package.json

Guía de uso de ClawHub

Acceder a ClawHub

Visita clawhub.com para explorar todos los skills disponibles.

Buscar skills

# Búsqueda desde CLI
openclaw skill search <palabra clave>

# Ejemplos
openclaw skill search email
openclaw skill search calendar
openclaw skill search home assistant

Detalles del skill

Cada página de skill incluye:

Información Descripción
Nombre y descripción Explicación de la funcionalidad del skill
Autor Desarrollador del skill
Versión Número de versión actual
Descargas Número de instalaciones
Dependencias Otros skills o paquetes necesarios
Vista previa de SKILL.md Archivo de definición del skill
Escaneo de seguridad Resultado del escaneo de VirusTotal

Escaneo de seguridad

ClawHub colabora con VirusTotal para escanear la seguridad de cada skill:

# Ver estado de seguridad del skill
openclaw skill info gmail --security

# Salida ejemplo:
# Skill: gmail
# Security Status: ✅ Verified
# VirusTotal Scan: Clean (0/72)
# Last Updated: 2026-02-20

Verificación pre-instalación

# Verificar dependencias del skill
openclaw skill check gmail

# Salida ejemplo:
# Skill: gmail
# Dependencies:
#   - google-auth: required ✓
#   - google-apis: required ✓
# Conflicts: None
# Recommendations:
#   - Consider also installing: calendar

Configuración de skills

Ubicación del archivo de configuración

~/.openclaw/workspace/skills/<skill-name>/SKILL.md

Estructura detallada de SKILL.md

---
name: gmail
version: 1.2.0
author: community
description: Send and read Gmail messages through OpenClaw
triggers:
  - email
  - gmail
  - mail
  - send email
  - read email
dependencies:
  - google-auth
tools:
  - gmail_list
  - gmail_send
  - gmail_read
---

# Gmail Skill

Manage your Gmail account through OpenClaw.

## Features

- List recent emails
- Send new emails
- Read specific emails
- Search emails
- Manage labels

## Setup

1. Enable Gmail API in Google Cloud Console
2. Create OAuth credentials
3. Run `openclaw skill config gmail` to authenticate

## Usage Examples

### List emails
User: "Check my recent emails"
Action: Use gmail_list tool with default parameters

### Send email
User: "Send an email to [email protected]"
Action: 
1. Ask for subject and body
2. Use gmail_send tool

### Search emails
User: "Search for emails from github"
Action: Use gmail_list tool with query parameter

## Configuration

Set the following environment variables:
- GOOGLE_CLIENT_ID
- GOOGLE_CLIENT_SECRET
- GOOGLE_REDIRECT_URI

Or configure in ~/.openclaw/workspace/skills/gmail/config.json

Archivo de configuración del skill

Algunos skills necesitan configuración adicional:

# Configurar skill
openclaw skill config gmail

# O editar manualmente el archivo de configuración
vi ~/.openclaw/workspace/skills/gmail/config.json

Ejemplo de configuración:

{
  "clientId": "your-client-id",
  "clientSecret": "your-client-secret",
  "redirectUri": "http://localhost:18789/callback",
  "scopes": [
    "https://www.googleapis.com/auth/gmail.readonly",
    "https://www.googleapis.com/auth/gmail.send"
  ]
}

Variables de entorno del skill

# Establecer variables de entorno del skill
export GMAIL_CLIENT_ID="your-client-id"
export GMAIL_CLIENT_SECRET="your-client-secret"

# O en archivo .env
echo "GMAIL_CLIENT_ID=your-client-id" >> ~/.openclaw/.env

Gestión de skills

Ver skills instalados

# Listar todos los skills
openclaw skill list

# Salida ejemplo:
# Name           Version   Status    Last Updated
# gmail          1.2.0     active    2026-02-20
# calendar       2.0.1     active    2026-02-18
# web-search     1.0.0     active    2026-02-15
# home-assistant 0.5.0    disabled  2026-02-10

Habilitar/Deshabilitar skills

# Deshabilitar skill
openclaw skill disable home-assistant

# Habilitar skill
openclaw skill enable home-assistant

Actualizar skills

# Actualizar un solo skill
openclaw skill update gmail

# Actualizar todos los skills
openclaw skill update --all

# Verificar actualizaciones disponibles
openclaw skill outdated

Desinstalar skills

# Desinstalar skill
openclaw skill uninstall gmail

# Desinstalar y limpiar configuración
openclaw skill uninstall gmail --purge

Diagnóstico de skills

# Diagnosticar problemas del skill
openclaw skill diagnose gmail

# Salida ejemplo:
# ✓ SKILL.md valid
# ✓ Dependencies installed
# ✓ Configuration complete
# ✓ Authentication working
# ✗ API quota exceeded (2/100 used today)

Skills recomendados

Desarrollo de programación

Nombre del skill Función Comando de instalación
coding-agent Ejecutar Claude Code, Codex, etc. openclaw skill install coding-agent
debug-pro Método de depuración sistemática openclaw skill install debug-pro
tdd-guide Desarrollo guiado por pruebas openclaw skill install tdd-guide
git-workflows Flujos de trabajo Git openclaw skill install git-workflows
docker-essentials Fundamentos de Docker openclaw skill install docker-essentials

Productividad

Nombre del skill Función Comando de instalación
gmail Gestión de Gmail openclaw skill install gmail
calendar Gestión de calendario openclaw skill install calendar
task-manager Gestión de tareas openclaw skill install task-manager
notion-sync Sincronización con Notion openclaw skill install notion-sync
obsidian Notas Obsidian openclaw skill install obsidian

Búsqueda e investigación

Nombre del skill Función Comando de instalación
web-search Búsqueda web openclaw skill install web-search
deepwiki Búsqueda en Wiki openclaw skill install deepwiki
exa-search Búsqueda con IA openclaw skill install exa-search
research-paper Búsqueda de papers openclaw skill install research-paper

Hogar inteligente

Nombre del skill Función Comando de instalación
home-assistant Control de Home Assistant openclaw skill install home-assistant
smart-home-io Dispositivos de hogar inteligente openclaw skill install smart-home-io
philips-hue Philips Hue openclaw skill install philips-hue

Fundamentos de desarrollo de skills

Crear un nuevo skill

# Crear plantilla de skill
openclaw skill create my-skill

# Estructura de directorios generada
my-skill/
├── SKILL.md
├── config.json.example
└── README.md

Plantilla de SKILL.md

---
name: my-skill
version: 1.0.0
author: your-name
description: Brief description of what this skill does
triggers:
  - trigger-word-1
  - trigger-word-2
dependencies: []
tools: []
---

# My Skill

Detailed description of the skill.

## Features

- Feature 1
- Feature 2
- Feature 3

## Setup

1. Step 1
2. Step 2
3. Step 3

## Usage Examples

### Example 1
User: "..."
Action: ...

### Example 2
User: "..."
Action: ...

## Configuration

Required configuration and environment variables.

## Notes

Any additional notes or warnings.

Añadir definición de herramientas

## Tools

This skill provides the following tools:

### my_tool_name

Description of what this tool does.

Parameters:
- `param1` (string, required): Description
- `param2` (number, optional): Description, default: 0

Returns:
- Result description

Example usage:
User: "..."
Action: Use my_tool_name with param1="value"

Publicar skill

# Validar skill
openclaw skill validate my-skill

# Publicar en ClawHub
openclaw skill publish my-skill

# O subir a GitHub
git add .
git commit -m "Initial skill release"
git push origin main

Seguridad de skills

Mejores prácticas de seguridad

Recomendación Descripción
Revisar la fuente Solo instalar skills de fuentes confiables
Verificar permisos Entender qué permisos necesita el skill
Revisar el código Inspeccionar SKILL.md y código de implementación
Probar aisladamente Usar nuevos skills primero en entornos de prueba
Actualizar regularmente Mantener los skills en su última versión

Permisos de skills

# Ver permisos del skill
openclaw skill permissions gmail

# Salida ejemplo:
# Skill: gmail
# Permissions:
#   - network:outbound (gmail.googleapis.com)
#   - filesystem:read (credential files)
#   - filesystem:write (token cache)
# Risk Level: Medium

Limitar permisos de skills

{
  "skills": {
    "gmail": {
      "permissions": {
        "network": {
          "allow": ["gmail.googleapis.com", "oauth2.googleapis.com"],
          "deny": ["*"]
        },
        "filesystem": {
          "allow": ["~/.openclaw/workspace/skills/gmail/"],
          "deny": ["*"]
        }
      }
    }
  }
}

Resolución de conflictos de skills

Conflictos comunes

Tipo de conflicto Descripción Solución
Palabras clave superpuestas Múltiples skills responden a la misma palabra clave Especificar palabras clave o deshabilitar skill en conflicto
Conflicto de dependencias Diferentes skills necesitan diferentes versiones de dependencias Usar entornos aislados
Conflicto de permisos Skills necesitan los mismos permisos Verificar si es necesario

Resolver conflictos

# Ver conflictos de skills
openclaw skill conflicts

# Salida ejemplo:
# Conflict: email trigger
#   - gmail
#   - outlook
# Resolution: Specify skill name or adjust priorities

# Establecer prioridad de skill
openclaw skill priority gmail 10
openclaw skill priority outlook 5

Entornos aislados

Para skills con conflictos de dependencias, se pueden usar entornos aislados:

{
  "skills": {
    "isolatedSkills": ["gmail", "outlook"],
    "isolationMode": "per-skill"
  }
}

Resolución de problemas

El skill no funciona

# Verificar estado del skill
openclaw skill list --status

# Verificar carga del skill
openclaw skill load gmail --verbose

# Ver logs del skill
openclaw logs --filter skill:gmail

Fallo de autenticación

# Re-autenticar
openclaw skill auth gmail --reauth

# Verificar estado de autenticación
openclaw skill auth gmail --status

Problemas de dependencias

# Verificar dependencias
openclaw skill deps gmail

# Instalar dependencias
openclaw skill deps gmail --install

# Actualizar dependencias
openclaw skill deps gmail --update

Error de carga del skill

# Validar sintaxis de SKILL.md
openclaw skill validate gmail

# Salida ejemplo:
# ✗ Error: Invalid frontmatter
#   Line 5: Unknown field 'invalid-field'
# ✗ Error: Missing required field 'name'

Resumen

El sistema de Skills es el núcleo de las capacidades de extensión de OpenClaw:

  • Ecosistema rico: 5700+ skills de la comunidad cubren diversos escenarios
  • Instalación simple: Un solo comando para instalar
  • Configuración flexible: Soporta personalización y sobreescritura
  • Seguro y controlable: Gestión de permisos y escaneo de seguridad

Mediante la selección y configuración adecuada de skills, puedes dar a tu asistente de IA posibilidades ilimitadas de extensión de capacidades.


Resumen de este artículo:

  • Entendiste el concepto y la estructura de los Skills
  • Dominaste múltiples métodos para instalar y gestionar skills
  • Aprendiste a usar ClawHub para descubrir y evaluar skills
  • Conociste la seguridad y gestión de permisos de skills
  • Dominaste los fundamentos del desarrollo de skills

Historial de actualizaciones:

  • 2026-02-26: Versión inicial publicada, basada en OpenClaw v2026.2

Navegación de la serie: