Skills y plugins en OpenClaw
Entiende la diferencia entre Tools, Skills y Plugins en OpenClaw, y aprende a ampliar tu agente de forma segura
La pregunta más frecuente de los nuevos usuarios de OpenClaw es: "¿Cuál es la diferencia entre un Skill, un Plugin y un Tool?" Suenan intercambiables, pero operan en capas completamente distintas. Entender esta distinción es la clave para extender tu agente de forma efectiva.
Las tres capas
La extensibilidad de OpenClaw se basa en tres capas que funcionan juntas en una cadena clara:
| Capa | Qué es | Ejemplo | Cómo se define |
|---|---|---|---|
| Tool | Una capacidad ejecutable de bajo nivel | read, write, exec, web_search, browser | Integrado en el core de OpenClaw (26 built-in) |
| Skill | Un documento de prompt estructurado que enseña al agente cómo usar los tools | github, notion, spotify-player | SKILL.md + metadatos YAML (no es código) |
| Plugin | Un módulo de código runtime que extiende la propia plataforma | Canal de Telegram, almacén de memoria vectorial, proveedor LLM personalizado | Módulo TypeScript/JavaScript |
La cadena fluye así:
Plugin → puede incluir sus propios Skills → los Skills enseñan al agente a usar Tools → los Tools ejecutan acciones
Tools: la base
Los Tools son las 26 capacidades integradas que permiten a tu agente interactuar con el mundo. Cada tool tiene un nivel de riesgo asignado:
- Seguro — Operaciones de solo lectura como
read,web_search,list_directory - Medio — Operaciones de escritura como
write,edit,browser - Alto — Ejecución sin restricciones como
exec,shell
Controlas a qué tools puede acceder tu agente mediante la configuración tools.allow en openclaw.json. Si solo necesitas que tu agente busque en la web y lea archivos, no le des acceso a exec.
Skills: la capa de inteligencia
Los Skills son la parte más malinterpretada. Un skill no es código. Es un documento estructurado (SKILL.md) con front-matter YAML que se carga en el system prompt del agente. Enseña al agente cómo realizar una tarea usando los tools que ya tiene disponibles.
Por ejemplo, el skill github no contiene código de la API de GitHub. En su lugar, contiene instrucciones detalladas que le dicen al agente cómo usar el tool exec para ejecutar comandos de la CLI gh y así crear PRs, revisar código y gestionar issues.
Los Skills usan divulgación progresiva — el agente solo carga las instrucciones de los skills relevantes cuando coinciden con la conversación actual, manteniendo el uso eficiente de la ventana de contexto.
Plugins: la capa de plataforma
Los Plugins son código runtime real que extiende OpenClaw a nivel de sistema. Hay cuatro tipos:
- Channel plugins — Conectan nuevas plataformas de mensajería (Telegram, Discord, Slack, WhatsApp)
- Memory plugins — Añaden backends de memoria persistente (almacenes vectoriales, bases de datos)
- Tool plugins — Registran capacidades de herramientas completamente nuevas más allá de las 26 integradas
- Provider plugins — Añaden proveedores de LLM personalizados
La mayoría de los usuarios nunca necesitan escribir un plugin. Los Skills y los tools integrados cubren la gran mayoría de los casos de uso.
Si estás pensando "necesito construir un plugin", pregúntate primero: ¿puede un Skill resolver esto enseñando al agente a usar las herramientas existentes de otra forma? En nueve de cada diez casos, la respuesta es sí.
Skills integrados que vale la pena conocer
OpenClaw incluye 53 skills de serie. Estos son los que la gente realmente usa:
Desarrollo
| Skill | Qué hace |
|---|---|
github | Creación de PRs, revisión de código, gestión de issues mediante la CLI gh |
gh-issues | Flujos de trabajo centrados en triaje y gestión de issues |
coding-agent | Patrones de generación de código y refactoring multi-archivo |
node-connect | Flujos de trabajo de depuración y desarrollo en Node.js |
tmux | Gestión de sesiones de terminal para tareas de larga duración |
IA y generación
| Skill | Qué hace |
|---|---|
gemini | Integración con Google Gemini para tareas multimodales |
openai-image-gen | Generación de imágenes mediante DALL-E |
openai-whisper | Transcripción de audio |
nano-banana-pro | Generación de imágenes ligera |
Comunicación
| Skill | Qué hace |
|---|---|
slack | Mensajería en canales, gestión de hilos |
discord | Interacción con servidores y canales |
himalaya | Lectura y envío de correos electrónicos |
voice-call | Gestión de llamadas de voz |
Productividad
| Skill | Qué hace |
|---|---|
notion | Gestión de páginas y bases de datos |
obsidian | Interacción con bóvedas de notas |
apple-notes | Integración con Notas de macOS |
apple-reminders | Integración con Recordatorios de macOS |
trello | Gestión de tableros y tarjetas |
Domótica y multimedia
| Skill | Qué hace |
|---|---|
openhue | Control de luces Philips Hue |
sonoscli | Control de altavoces Sonos |
spotify-player | Control de reproducción de música |
Utilidades
| Skill | Qué hace |
|---|---|
weather | Previsiones meteorológicas |
nano-pdf | Lectura y resumen de PDFs |
summarize | Resumen de contenido extenso |
healthcheck | Monitorización del estado del agente |
model-usage | Seguimiento del consumo de tokens |
Algunos skills integrados como apple-notes, apple-reminders e imsg requieren macOS. En Claw Buff, tu agente se ejecuta en un contenedor Linux, por lo que estos skills se filtran automáticamente.
El ecosistema ClawHub
Más allá de los 53 skills integrados, ClawHub es el marketplace comunitario con más de 13.700 skills. Los más populares tienen una adopción masiva:
- Navegación web — más de 180.000 instalaciones
- Integración con Telegram — más de 145.000 instalaciones
Los skills en ClawHub se organizan en categorías: AI/ML, Utilidades, Desarrollo, Productividad, Web, Ciencia, Multimedia, Social y Finanzas.
Encontrar skills de calidad
Con más de 13.700 skills, la calidad varía enormemente. Así puedes encontrar los buenos:
Consulta la lista awesome-openclaw-skills
La lista curada por la comunidad awesome-openclaw-skills contiene más de 5.400 skills revisados. Empieza aquí antes de buscar directamente en ClawHub.
Busca editores verificados
Tras el incidente ClawHavoc (más detalles abajo), OpenClaw introdujo la verificación de editores. Da preferencia a los skills de cuentas verificadas.
Lee el SKILL.md antes de instalar
Dado que los skills son simplemente documentos de prompt, puedes leer exactamente qué instrucciones se inyectarán en el contexto de tu agente. Si las instrucciones de un skill parecen sospechosas o excesivamente amplias, descártalo.
Revisa el número de instalaciones y la fecha de actualización
Un alto número de instalaciones con actualizaciones recientes indica un mantenimiento activo. Los skills abandonados con instrucciones obsoletas pueden causar comportamientos inesperados.
MCP Tools
OpenClaw tiene soporte nativo para el Model Context Protocol (MCP), que te permite conectar servidores de herramientas externos a tu agente. Esto es especialmente útil para integrarse con servicios que no tienen un skill dedicado de OpenClaw.
La configuración va en la sección mcpServers de openclaw.json:
{
"mcpServers": {
"google-drive": {
"command": "npx",
"args": ["-y", "@anthropic/mcp-google-drive"]
}
}
}Hay más de 1.000 servidores MCP de la comunidad disponibles, cubriendo Google Drive, Slack, bases de datos (PostgreSQL, MongoDB), plataformas cloud (AWS, GCP, Azure) y más. Cada servidor MCP expone su propio conjunto de herramientas que tu agente puede invocar directamente.
Los servidores MCP y los skills de OpenClaw son complementarios. Un servidor MCP le da a tu agente nuevas capacidades de herramientas; un skill le enseña cuándo y cómo usarlas de forma efectiva. Para mejores resultados, combina un servidor MCP con un skill que proporcione instrucciones de uso.
Seguridad: el incidente ClawHavoc
Entre enero y febrero de 2026, la comunidad de OpenClaw experimentó ClawHavoc — un ataque coordinado a la cadena de suministro a través de skills maliciosos en ClawHub. Esto no es teórico; sucedió realmente.
Qué ocurrió
A través de 12 cuentas de editor, los atacantes subieron 1.184 skills maliciosos que contenían:
- Reverse shells — que daban a los atacantes acceso remoto a la máquina host
- Exfiltración de datos — subiendo silenciosamente archivos, credenciales y variables de entorno
- AMOS stealer — malware específico de macOS dirigido a contraseñas del navegador y carteras de criptomonedas
- Infección persistente mediante MEMORY.md — inyectando instrucciones en la memoria persistente del agente para que el comportamiento malicioso sobreviviera a la eliminación del skill
La respuesta
OpenClaw se asoció con VirusTotal y eliminó más de 2.400 skills sospechosos. Se introdujo la verificación de editores para que los usuarios puedan distinguir entre editores verificados y subidas anónimas.
Sin embargo, una auditoría posterior de Snyk encontró que el 36% de los skills de ClawHub todavía contienen alguna forma de prompt injection. VirusTotal detecta malware binario y patrones de ataque conocidos, pero no puede detectar prompt injection en lenguaje natural — instrucciones ocultas dentro de un skill que manipulan sutilmente el comportamiento del agente.
La prompt injection en skills es particularmente peligrosa porque los skills son prompts. Un skill malicioso no necesita introducir código ejecutable — solo necesita incluir instrucciones que convenzan al agente de realizar acciones dañinas usando sus herramientas existentes.
Cómo mantenerse seguro
Estas prácticas no son opcionales si usas skills de la comunidad:
- Audita cada skill no verificado antes de instalarlo. Lee el archivo
SKILL.md. Es un documento de texto — revisarlo lleva minutos, no horas. - Usa
allowBundledpara permitir solo los skills que necesitas. No cargues los 53 skills integrados si solo usas 5. - Fija las versiones de los skills. No actualices automáticamente los skills de la comunidad. Revisa los changelogs antes de actualizar.
- Ejecuta
openclaw security auditregularmente. Esto escanea los skills instalados en busca de patrones maliciosos conocidos. - Minimiza
tools.allow. Si tu agente no necesita acceso a la shell, no le concedasexec. El radio de impacto de un skill comprometido se limita a los tools a los que el agente puede acceder.
Gestionar skills en Claw Buff
En Claw Buff, la gestión de skills se realiza a través de la Consola en lugar de editar openclaw.json a mano.
Activar y desactivar skills — Cada skill instalado tiene un interruptor en la sección Agent de la Consola. Los skills desactivados no se cargan en el contexto del agente.
Configurar API keys — Los skills que necesitan credenciales de servicios externos (como spotify-player o notion) tienen campos de configuración en línea donde puedes establecer las variables de entorno necesarias.
Explorar e instalar desde ClawHub — Puedes buscar e instalar skills de ClawHub directamente desde la Consola sin necesidad de acceso SSH al contenedor.
Dependencias binarias — Algunos skills requieren binarios externos (como ffmpeg para procesamiento multimedia o gh para GitHub). Si un skill necesita un binario que no está preinstalado en el contenedor, verás un aviso de dependencia durante la instalación. Contacta con soporte si necesitas paquetes de sistema adicionales.
Los skills diseñados para macOS (como apple-notes, apple-reminders e imsg) se filtran automáticamente en Claw Buff, ya que tu agente se ejecuta en un contenedor Linux. Si un skill aparece en ClawHub pero no en tu Consola, probablemente esta sea la razón.