​

Créer des plugins

​

Prérequis

• Node >= 22 et un gestionnaire de paquets (npm ou pnpm)
• Familiarité avec TypeScript (ESM)
• Pour les plugins dans le dépôt : dépôt cloné et pnpm install exécuté

​

Quel type de plugin ?

​

Démarrage rapide : plugin d’outil

{
  "name": "@myorg/openclaw-my-plugin",
  "version": "1.0.0",
  "type": "module",
  "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"
    }
  }
}

// index.ts
import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
import { Type } from "@sinclair/typebox";

export default definePluginEntry({
  id: "my-plugin",
  name: "My Plugin",
  description: "Ajoute un outil personnalisé à OpenClaw",
  register(api) {
    api.registerTool({
      name: "my_tool",
      description: "Faire une chose",
      parameters: Type.Object({ input: Type.String() }),
      async execute(_id, params) {
        return { content: [{ type: "text", text: `Reçu : ${params.input}` }] };
      },
    });
  },
});

clawhub package publish your-org/your-plugin --dry-run
clawhub package publish your-org/your-plugin
openclaw plugins install clawhub:@myorg/openclaw-my-plugin

pnpm test -- <bundled-plugin-root>/my-plugin/

​

Capacités des plugins

• before_tool_call : { block: true } est terminal et arrête les gestionnaires de priorité inférieure.
• before_tool_call : { block: false } est traité comme aucune décision.
• before_tool_call : { requireApproval: true } met en pause l’exécution de l’agent et demande une approbation à l’utilisateur via la surcouche d’approbation exec, les boutons Telegram, les interactions Discord ou la commande /approve sur n’importe quel canal.
• before_install : { block: true } est terminal et arrête les gestionnaires de priorité inférieure.
• before_install : { block: false } est traité comme aucune décision.
• message_sending : { cancel: true } est terminal et arrête les gestionnaires de priorité inférieure.
• message_sending : { cancel: false } est traité comme aucune décision.

​

Enregistrement d’outils d’agent

register(api) {
  // Outil requis — toujours disponible
  api.registerTool({
    name: "my_tool",
    description: "Faire une chose",
    parameters: Type.Object({ input: Type.String() }),
    async execute(_id, params) {
      return { content: [{ type: "text", text: params.input }] };
    },
  });

  // Outil facultatif — l’utilisateur doit l’ajouter à la liste d’autorisation
  api.registerTool(
    {
      name: "workflow_tool",
      description: "Exécuter un workflow",
      parameters: Type.Object({ pipeline: Type.String() }),
      async execute(_id, params) {
        return { content: [{ type: "text", text: params.pipeline }] };
      },
    },
    { optional: true },
  );
}

{
  tools: { allow: ["workflow_tool"] },
}

• Les noms d’outils ne doivent pas entrer en conflit avec les outils du cœur (les conflits sont ignorés)
• Utilisez optional: true pour les outils avec effets de bord ou exigences binaires supplémentaires
• Les utilisateurs peuvent activer tous les outils d’un plugin en ajoutant l’identifiant du plugin à tools.allow

​

Conventions d’import

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

// Incorrect : racine monolithique (obsolète, sera supprimée)
import { ... } from "openclaw/plugin-sdk";

• Anthropic : wrappers de flux Claude et assistants service_tier / bêta
• OpenAI : constructeurs de fournisseurs, assistants de modèle par défaut, fournisseurs temps réel
• OpenRouter : constructeur de fournisseur plus assistants d’intégration guidée/configuration

​

Checklist avant soumission

​

Tests de publication bêta

1. Surveillez les tags de publication GitHub sur openclaw/openclaw et abonnez-vous via Watch > Releases. Les tags bêta ressemblent à v2026.3.N-beta.1. Vous pouvez aussi activer les notifications pour le compte X officiel d’OpenClaw @openclaw pour les annonces de publication.
2. Testez votre plugin contre le tag bêta dès qu’il apparaît. La fenêtre avant stable n’est généralement que de quelques heures.
3. Publiez dans le fil de votre plugin dans le canal Discord plugin-forum après le test avec soit all good, soit ce qui a cassé. Si vous n’avez pas encore de fil, créez-en un.
4. Si quelque chose casse, ouvrez ou mettez à jour une issue intitulée Beta blocker: <plugin-name> - <summary> et appliquez le label beta-blocker. Placez le lien de l’issue dans votre fil.
5. Ouvrez une PR vers main intitulée fix(<plugin-id>): beta blocker - <summary> et liez l’issue à la fois dans la PR et dans votre fil Discord. Les contributeurs ne peuvent pas labelliser les PR, donc le titre est le signal côté PR pour les mainteneurs et l’automatisation. Les bloqueurs avec une PR sont fusionnés ; les bloqueurs sans PR peuvent quand même partir en publication. Les mainteneurs surveillent ces fils pendant les tests bêta.
6. Le silence signifie vert. Si vous ratez la fenêtre, votre correctif arrivera probablement dans le cycle suivant.

​

Étapes suivantes

​

Lié

• Architecture des plugins — analyse approfondie de l’architecture interne
• Vue d’ensemble du SDK — référence du SDK de plugins
• Manifest — format du manifeste de plugin
• Plugins de canal — créer des plugins de canal
• Plugins de fournisseur — créer des plugins de fournisseur