Creación de plugins

openclaw plugins install clawhub:<package-name>

​

Requisitos

• Node 22.22.3+, Node 24.15+ o Node 25.9+, y npm o pnpm.
• Módulos ESM de TypeScript.
• Para trabajar en plugins incluidos en el repositorio, clone el repositorio y ejecute pnpm install. El desarrollo de plugins desde una copia del código fuente solo admite pnpm porque OpenClaw descubre los plugins incluidos a partir de los paquetes del espacio de trabajo extensions/*.

​

Elegir la estructura del plugin

​

Inicio rápido

{
  "name": "@myorg/openclaw-my-plugin",
  "version": "1.0.0",
  "type": "module",
  "dependencies": {
    "typebox": "1.1.39"
  },
  "peerDependencies": {
    "openclaw": ">=2026.3.24-beta.2"
  },
  "openclaw": {
    "extensions": ["./index.ts"],
    "compat": {
      "pluginApi": ">=2026.3.24-beta.2",
      "minGatewayVersion": "2026.3.24-beta.2"
    },
    "build": {
      "openclawVersion": "2026.3.24-beta.2",
      "pluginSdkVersion": "2026.3.24-beta.2"
    }
  }
}

{
  "id": "my-plugin",
  "name": "My Plugin",
  "description": "Adds a custom tool to OpenClaw",
  "contracts": {
    "tools": ["my_tool"]
  },
  "activation": {
    "onStartup": true
  },
  "configSchema": {
    "type": "object",
    "additionalProperties": false
  }
}

import { Type } from "typebox";
import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";

export default definePluginEntry({
  id: "my-plugin",
  name: "My Plugin",
  description: "Adds a custom tool to OpenClaw",
  register(api) {
    api.registerTool({
      name: "my_tool",
      description: "Echo one input value",
      parameters: Type.Object({ input: Type.String() }),
      outputSchema: Type.Object(
        { input: Type.String() },
        { additionalProperties: false },
      ),
      async execute(_id, params) {
        const details = { input: params.input };
        return {
          content: [{ type: "text", text: `Got: ${params.input}` }],
          details,
        };
      },
    });
  },
});

openclaw plugins inspect my-plugin --runtime --json

pnpm test extensions/my-plugin/
pnpm check

npm pack --pack-destination /tmp
openclaw plugins install npm-pack:/tmp/<plugin-package>.tgz --force
openclaw plugins inspect my-plugin --runtime --json

clawhub package publish your-org/your-plugin --dry-run
clawhub package publish your-org/your-plugin

openclaw plugins install clawhub:your-org/your-plugin

​

Registrar herramientas

register(api) {
  api.registerTool(
    {
      name: "workflow_tool",
      description: "Run a workflow",
      parameters: Type.Object({ pipeline: Type.String() }),
      outputSchema: Type.Object(
        { pipeline: Type.String() },
        { additionalProperties: false },
      ),
      async execute(_id, params) {
        return {
          content: [{ type: "text", text: params.pipeline }],
          details: { pipeline: params.pipeline },
        };
      },
    },
    { optional: true },
  );
}

{
  "contracts": {
    "tools": ["workflow_tool"]
  },
  "toolMetadata": {
    "workflow_tool": {
      "optional": true
    }
  }
}

{
  tools: { allow: ["workflow_tool"] }, // or ["my-plugin"] for every tool from one plugin
}

​

Convenciones de importación

import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";

​

Lista de comprobación previa al envío

​

Pruebas con versiones beta

1. Siga los lanzamientos de openclaw/openclaw (Watch > Releases). Las etiquetas beta tienen un formato similar a v2026.3.N-beta.1. También puede seguir a @openclaw en X para recibir anuncios de lanzamientos.
2. Pruebe su plugin con la etiqueta beta en cuanto aparezca. El plazo antes de la versión estable suele ser de solo unas horas.
3. Después de realizar las pruebas, publique en el hilo de su plugin en el canal de Discord plugin-forum (discord.gg/clawd) e indique all good o qué dejó de funcionar. Cree un hilo si todavía no tiene uno.
4. Si algo deja de funcionar, abra o actualice una incidencia titulada Beta blocker: <plugin-name> - <summary> y aplique la etiqueta beta-blocker. Enlace la incidencia en su hilo.
5. Abra un PR para main titulado fix(<plugin-id>): beta blocker - <summary> y enlace la incidencia tanto en el PR como en su hilo de Discord. Los colaboradores no pueden etiquetar los PR, por lo que el título sirve como señal del PR para los mantenedores y la automatización. Los bloqueos con un PR se fusionan; los bloqueos sin uno podrían publicarse de todos modos.
6. El silencio significa que todo está correcto. Si se pierde el plazo, la corrección suele incorporarse en el siguiente ciclo.

​

Siguientes pasos

​

Contenido relacionado

• Hooks de plugins
• Arquitectura de plugins