Cómo crear una habilidad personalizada de OpenClaw

Introducción

Las habilidades de OpenClaw son servidores MCP (Protocolo de Contexto de Modelo) que exponen herramientas al agente. Cuando construyes una habilidad, estás dándole a tu agente nuevas capacidades -- desde acceder a APIs hasta controlar hardware o procesar archivos. Las habilidades son la forma principal de hacer que tu agente OpenClaw haga cosas más allá de la conversación.

Requisitos previos

• Node.js 18+ o Python 3.10+ instalados
• Conocimientos básicos de programación (TypeScript o Python recomendados)
• Una cuenta de KiwiClaw con un agente activo para pruebas
• Familiaridad con la arquitectura de OpenClaw

Instrucciones paso a paso

Paso 1: Comprende el formato de habilidades

Una habilidad de OpenClaw es un servidor MCP que expone una o más herramientas. Cada herramienta tiene un nombre, descripción, esquema de entrada y una función controladora. El agente descubre herramientas disponibles y decide cuándo llamarlas basándose en el contexto de la conversación.

Paso 2: Configura tu entorno de desarrollo

Crea un nuevo directorio de proyecto. Si usas TypeScript, inicializa con npm init e instala el SDK de MCP. Si usas Python, configura un entorno virtual e instala el paquete MCP de Python.

Paso 3: Crea el manifiesto de habilidades

Define los metadatos de tu habilidad: nombre, versión, descripción, autor y la lista de herramientas que proporciona. Este manifiesto le dice a OpenClaw qué puede hacer tu habilidad.

Paso 4: Escribe los gestores de herramientas

Implementa las funciones para cada herramienta. Un gestor de herramientas recibe parámetros de entrada y devuelve un resultado. Por ejemplo, una habilidad de clima podría aceptar un nombre de ciudad y devolver el pronóstico actual llamando a una API de clima.

Paso 5: Prueba localmente

Ejecuta tu habilidad localmente y pruébala contra tu agente KiwiClaw. Instala la habilidad usando la página de Habilidades del panel de control apuntando a tu servidor local. Verifica que cada herramienta funcione correctamente.

Paso 6: Publica en el mercado

Cuando tu habilidad esté lista, envíala al Mercado de habilidades de KiwiClaw. Nuestro equipo revisa los envíos de seguridad y calidad. Una vez aprobada, otros usuarios pueden instalar tu habilidad. Puedes establecerla como gratuita o de pago.

Consejos profesionales

• Comienza con el Creador de habilidades -- Esta meta-habilidad ayuda a tu agente a construir otras habilidades, generando código base para ti.
• Mantén las herramientas enfocadas -- Cada herramienta debe hacer una cosa bien. Múltiples herramientas pequeñas son mejores que una herramienta compleja.
• Maneja los errores correctamente -- Devuelve mensajes de error informativos para que el agente pueda explicar qué salió mal al usuario.
• Agrega buenas descripciones -- El agente usa descripciones de herramientas para decidir cuándo llamarlas. Descripciones claras y específicas llevan a una mejor selección de herramientas.

Preguntas frecuentes

¿Qué lenguaje de programación puedo usar para habilidades de OpenClaw?

Las habilidades de OpenClaw son servidores MCP, por lo que puedes usar cualquier lenguaje que soporte el protocolo MCP. La mayoría de habilidades se escriben en TypeScript o Python, pero también funcionan Go, Rust y otros lenguajes.

¿Puedo monetizar mi habilidad de OpenClaw?

Sí. Publica tu habilidad en el mercado de KiwiClaw y establece un precio. KiwiClaw maneja pagos, distribución y revisiones. Ganas ingresos cada vez que alguien instala tu habilidad de pago. Consulta nuestra guía de publicación para detalles.

¿Cómo se revisan las habilidades de seguridad?

Todos los envíos del mercado pasan por el proceso de revisión de KiwiClaw. Revisamos el código fuente, verificamos comportamiento malicioso, validamos permisos y probamos funcionalidad antes de aprobar una habilidad para el mercado.