Création de plugins

openclaw plugins install clawhub:<package-name>

​

Prérequis

• Node 22.22.3+, Node 24.15+ ou Node 25.9+, et npm ou pnpm.
• Modules ESM TypeScript.
• Pour travailler sur un Plugin intégré au dépôt, clonez le dépôt et exécutez pnpm install. Le développement de Plugins à partir du code source utilise uniquement pnpm, car OpenClaw détecte les Plugins intégrés à partir des paquets de l’espace de travail extensions/*.

​

Choisir la forme du Plugin

​

Démarrage rapide

{
  "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() }),
      async execute(_id, params) {
        return {
          content: [{ type: "text", text: `Got: ${params.input}` }],
        };
      },
    });
  },
});

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

​

Enregistrer des outils

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

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

{
  tools: { allow: ["workflow_tool"] }, // ou ["my-plugin"] pour tous les outils d’un même Plugin
}

​

Conventions d’importation

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

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

​

Liste de contrôle avant soumission

​

Tester avec les versions bêta

1. Surveillez les versions de openclaw/openclaw (Watch > Releases). Les étiquettes bêta ressemblent à v2026.3.N-beta.1. Vous pouvez également suivre @openclaw sur X pour les annonces de versions.
2. Testez votre Plugin avec l’étiquette bêta dès qu’elle apparaît. La période précédant la version stable ne dure généralement que quelques heures.
3. Après les tests, publiez un message dans le fil de votre Plugin, dans le canal Discord plugin-forum (discord.gg/clawd), en indiquant soit all good, soit ce qui ne fonctionne plus. Créez un fil si vous n’en avez pas encore.
4. Si quelque chose ne fonctionne plus, ouvrez ou mettez à jour un ticket intitulé Beta blocker: <plugin-name> - <summary> et appliquez-lui l’étiquette beta-blocker. Ajoutez le lien du ticket dans votre fil.
5. Ouvrez une PR vers main, intitulée fix(<plugin-id>): beta blocker - <summary>, et ajoutez le lien du ticket à la fois dans la PR et dans votre fil Discord. Les contributeurs ne peuvent pas étiqueter les PR, le titre sert donc de signal aux responsables de maintenance et aux automatisations. Les problèmes bloquants accompagnés d’une PR sont corrigés par fusion ; ceux qui n’en ont pas risquent de se retrouver malgré tout dans la version publiée.
6. L’absence de réponse signifie que tout va bien. Si vous manquez cette période, votre correctif sera généralement intégré au cycle suivant.

​

Étapes suivantes

​

Contenu associé

• Hooks de Plugin
• Architecture des Plugins