lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

configuración intermedio openclawagentesherramientasdesarrollo

OpenClaw Plugin SDK: desarrolla extensiones con contratos tipados

Crea herramientas y otras capacidades de OpenClaw mediante su API de plugins y comprueba su carga en el entorno real.

✓ verificado el 26 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.


Para el agente: cómo acompañar al usuario

  1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
  2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
  3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
  4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
  5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
  6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

  1. Sigue el ejemplo de Building plugins para crear package.json, openclaw.plugin.json e index.ts.
  2. Usa los imports documentados en SDK overview y fija la versión de OpenClaw que probarás.
  3. Tras instalar el ejemplo con su procedimiento documentado, inspecciona la carga con:
openclaw plugins inspect my-plugin --runtime --json

Comprobación

Confirma que las capacidades declaradas en el manifiesto coinciden con las cargadas y prueba una operación con datos desechables.

Si algo falla

Revisa compatibilidad de host, imports, manifiesto y punto de entrada compilado. No amplíes rangos de versión sin probarlos.

ver en .md ¿Prefieres el recurso entero?

Qué es

El SDK de plugins define el contrato entre una extensión y el núcleo de OpenClaw. Su código vive en una carpeta propia del monorepo y la documentación distingue esta API de las integraciones externas con la pasarela.

Para qué te sirve

  • Cuando necesitas añadir una herramienta propia al agente.
  • Cuando desarrollas un proveedor o canal y quieres usar los contratos de extensión.

Cómo funciona

El paquete del plugin declara metadatos, manifiesto y punto de entrada. El registro añade capacidades a OpenClaw mediante los subpaths del SDK. ClawHub es una vía de distribución de paquetes, no sustituye el desarrollo ni sus pruebas.

Antes de empezar

La guía exige TypeScript ESM y Node.js 24.16 o posterior, o 26.1 o posterior. Para desarrollo de extensiones incluidas en el repositorio indica pnpm. Revisa la versión del host y fija las versiones que realmente vayas a comprobar.

Límites y alternativas

Las API de plugins son experimentales y pueden cambiar entre versiones. Prueba cada host declarado compatible y limita las capacidades registradas. Para una aplicación externa que solo llama al agente, consulta las integraciones de Gateway en lugar de usar este SDK.

Recursos