Plugins bouwen

openclaw plugins install clawhub:<package-name>

​

Vereisten

• Node 22.22.3+, Node 24.15+ of Node 25.9+, en npm of pnpm.
• TypeScript ESM-modules.
• Voor werk aan een gebundelde plugin in de repository kloon je de repository en voer je pnpm install uit. Pluginontwikkeling vanuit een broncheckout werkt alleen met pnpm, omdat OpenClaw gebundelde plugins ontdekt via extensions/*-werkruimtepakketten.

​

Kies de pluginvorm

​

Snelstart

{
  "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": "Voegt een aangepaste tool toe aan 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: "Voegt een aangepaste tool toe aan OpenClaw",
  register(api) {
    api.registerTool({
      name: "my_tool",
      description: "Eén invoerwaarde teruggeven",
      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: `Ontvangen: ${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

​

Tools registreren

register(api) {
  api.registerTool(
    {
      name: "workflow_tool",
      description: "Een workflow uitvoeren",
      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"] }, // of ["my-plugin"] voor elke tool van één plugin
}

​

Importconventies

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

​

Controlelijst vóór indiening

​

Testen met bètareleases

1. Houd de releases van openclaw/openclaw in de gaten (Watch > Releases). Bètatags zien eruit als v2026.3.N-beta.1. Je kunt ook @openclaw volgen op X voor releaseaankondigingen.
2. Test je plugin met de bètatag zodra deze verschijnt. De periode vóór de stabiele release duurt doorgaans slechts enkele uren.
3. Plaats na het testen een bericht in de thread van je plugin in het Discord-kanaal plugin-forum (discord.gg/clawd), met all good of een beschrijving van wat niet meer werkte. Maak een thread als je er nog geen hebt.
4. Als er iets niet meer werkt, open of werk dan een issue bij met de titel Beta blocker: <plugin-name> - <summary> en pas het label beta-blocker toe. Link het issue in je thread.
5. Open een PR voor main met de titel fix(<plugin-id>): beta blocker - <summary> en link het issue zowel in de PR als in je Discord-thread. Bijdragers kunnen PR’s geen labels geven, dus de titel is voor beheerders en automatisering het signaal aan de PR-zijde. Blokkerende problemen met een PR worden samengevoegd; blokkerende problemen zonder PR worden mogelijk toch uitgebracht.
6. Geen bericht betekent groen licht. Als je deze periode mist, wordt je oplossing doorgaans in de volgende cyclus opgenomen.

​

Volgende stappen

​

Gerelateerd

• Plugin-hooks
• Pluginarchitectuur