Gérer les plugins

L’interface de contrôle couvre le flux de travail courant de découverte, d’installation, d’activation et de désactivation. La CLI ajoute la mise à jour, la désinstallation, la configuration avancée et des contrôles explicites de la source d’installation. Pour connaître l’intégralité du contrat de commande, des options, des règles de sélection de la source et des cas limites, consultez openclaw plugins.

Flux de travail CLI type : recherchez un paquet, installez-le depuis ClawHub, npm, git ou un chemin local, laissez le Gateway géré redémarrer automatiquement (ou redémarrez-le manuellement), puis vérifiez les enregistrements d’exécution du plugin.

Utiliser l’interface de contrôle

Ouvrez Plugins dans l’interface de contrôle, ou utilisez /settings/plugins relativement au chemin de base configuré de l’interface de contrôle. Par exemple, avec un chemin de base /openclaw, utilisez /openclaw/settings/plugins. La page comporte deux onglets :

• Installés affiche l’inventaire local complet regroupé par catégorie (canaux, fournisseurs de modèles, mémoire, outils). Chaque ligne ouvre une vue détaillée ; son menu de débordement (…) permet d’activer ou de désactiver le plugin et, pour les plugins installés depuis une source externe, propose Supprimer. L’onglet répertorie également les serveurs MCP configurés avec les mêmes actions d’activation, de désactivation et de suppression accessibles par menu, qui modifient mcp.servers dans la configuration du Gateway.
• Découvrir est la boutique : plugins mis en avant inclus avec OpenClaw, plugins externes officiels et sélection de connecteurs. Les cartes de connecteur ajoutent en un clic un serveur MCP hébergé (GitHub, Notion, Linear, Sentry, Home Assistant) ou ouvrent une recherche ClawHub préremplie. La saisie dans le champ de recherche interroge directement ClawHub et ajoute une section Depuis ClawHub avec le nombre de téléchargements et des badges de vérification de la source.

Les plugins inclus ne nécessitent pas l’installation d’un paquet. Leur action de menu est Activer ou Désactiver. Workboard, par exemple, est inclus avec OpenClaw et désactivé par défaut ; choisissez donc Activer pour l’activer. Les plugins intégrés ne peuvent pas être supprimés, seulement désactivés.

L’accès au catalogue et à la recherche nécessite operator.read. L’installation, l’activation, la désactivation, la suppression et les modifications des serveurs MCP nécessitent operator.admin. Une installation depuis ClawHub est effectuée par le Gateway et conserve ses contrôles de confiance, d’intégrité et de politique d’installation des plugins.

L’installation ou la suppression du code d’un plugin nécessite un redémarrage du Gateway. Les changements d’activation peuvent être appliqués sans redémarrage lorsque le plugin installé et l’environnement d’exécution actuel du Gateway le permettent ; sinon, l’interface indique qu’un redémarrage est requis. Les connecteurs MCP utilisant OAuth nécessitent toujours une exécution unique de openclaw mcp login <name> depuis la CLI après leur ajout.

L’interface de contrôle n’installe pas depuis des sources npm, git ou des chemins locaux arbitraires, ne met pas à jour les plugins et n’expose pas de configuration avancée des plugins. Utilisez les flux de travail CLI ci-dessous pour ces opérations.

Répertorier et rechercher des plugins

openclaw plugins listopenclaw plugins list --enabledopenclaw plugins list --verboseopenclaw plugins list --jsonopenclaw plugins search "calendar"

--json pour les scripts :

openclaw plugins list --json \  | jq '.plugins[] | {id, enabled, format, source, dependencyStatus}'

plugins list effectue une vérification d’inventaire à froid : ce qu’OpenClaw peut découvrir à partir de la configuration, des manifestes et du registre persistant des plugins. Cela ne prouve pas qu’un Gateway déjà en cours d’exécution a importé l’environnement d’exécution du plugin. La sortie JSON inclut les diagnostics du registre et le champ dependencyStatus de chaque plugin (indiquant si les dependencies/optionalDependencies déclarées sont résolues sur le disque).

plugins search interroge ClawHub pour rechercher des paquets de plugins installables et affiche pour chaque résultat une indication d’installation (openclaw plugins install clawhub:<package>).

Activer et désactiver des plugins

openclaw plugins enable <plugin-id>openclaw plugins disable <plugin-id>

Modifie l’entrée de configuration d’un plugin sans toucher aux fichiers installés. Certains plugins intégrés (fournisseurs de modèles ou de synthèse vocale intégrés, plugin de navigateur intégré) sont activés par défaut ; d’autres nécessitent enable après l’installation.

Installer des plugins

# Rechercher des paquets de plugins sur ClawHub.openclaw plugins search "calendar" # Installer depuis ClawHub.openclaw plugins install clawhub:<package>openclaw plugins install clawhub:<package>@1.2.3openclaw plugins install clawhub:<package>@beta # Installer depuis npm.openclaw plugins install npm:<package>openclaw plugins install npm:@scope/openclaw-plugin@1.2.3openclaw plugins install npm:@openclaw/codex # Installer depuis un artefact npm-pack local.openclaw plugins install npm-pack:<path.tgz> # Installer depuis git ou une copie de travail locale de développement.openclaw plugins install git:github.com/acme/openclaw-plugin@v1.0.0openclaw plugins install ./my-pluginopenclaw plugins install --link ./my-plugin

Les spécifications de paquet sans préfixe sont installées depuis npm pendant la transition de lancement, sauf si le nom correspond à l’identifiant d’un plugin intégré ou officiel, auquel cas OpenClaw utilise cette copie locale ou officielle à la place. Utilisez clawhub:, npm:, git: ou npm-pack: pour sélectionner la source de manière déterministe.

Utilisez --force uniquement pour remplacer une cible d’installation existante provenant d’une autre source. Pour les mises à niveau courantes d’une installation npm, ClawHub ou d’un paquet de hooks suivie, utilisez plutôt openclaw plugins update ; --force n’est pas pris en charge avec --link.

Redémarrer et inspecter

Un Gateway géré en cours d’exécution dont le rechargement de la configuration est activé redémarre automatiquement après l’installation, la mise à jour ou la désinstallation du code d’un plugin. Si le Gateway n’est pas géré ou si le rechargement est désactivé, redémarrez-le vous-même avant de vérifier les surfaces d’exécution actives :

openclaw gateway restartopenclaw plugins inspect <plugin-id> --runtime --json

inspect --runtime charge le module du plugin et prouve qu’il a enregistré des surfaces d’exécution (outils, hooks, services, méthodes du Gateway, routes HTTP, commandes CLI appartenant au plugin). Les commandes inspect sans option et list effectuent uniquement des vérifications à froid du manifeste, de la configuration et du registre.

Mettre à jour des plugins

openclaw plugins update <plugin-id>openclaw plugins update <npm-package-or-spec>openclaw plugins update --allopenclaw plugins update <plugin-id> --dry-run

La transmission de l’identifiant d’un plugin réutilise sa spécification d’installation suivie : les dist-tags enregistrés (@beta) et les versions exactes épinglées sont conservés lors des exécutions ultérieures de update <plugin-id>.

openclaw plugins update --all est la méthode de maintenance en masse. Elle respecte toujours les spécifications d’installation suivies ordinaires, mais les enregistrements de plugins OpenClaw officiels et approuvés se synchronisent avec la cible actuelle du catalogue officiel au lieu de rester épinglés à un paquet officiel exact obsolète ; lorsque update.channel vaut beta, cette synchronisation privilégie la branche de publication bêta. Utilisez une commande ciblée update <plugin-id> pour conserver telle quelle une spécification officielle exacte ou étiquetée.

Pour les installations npm, transmettez une spécification de paquet explicite afin de modifier l’enregistrement suivi :

openclaw plugins update @scope/openclaw-plugin@betaopenclaw plugins update @scope/openclaw-plugin

La seconde commande ramène un plugin à la branche de publication par défaut du registre lorsqu’il était auparavant épinglé à une version exacte ou à une étiquette.

Consultez openclaw plugins pour connaître les règles exactes de repli et d’épinglage.

Désinstaller des plugins

openclaw plugins uninstall <plugin-id> --dry-runopenclaw plugins uninstall <plugin-id>openclaw plugins uninstall <plugin-id> --keep-files

La désinstallation supprime l’entrée de configuration du plugin, l’enregistrement persistant de l’index des plugins, les entrées des listes d’autorisation et de refus, ainsi que les entrées liées de plugins.load.paths, le cas échéant. Le répertoire d’installation géré est supprimé sauf si vous transmettez --keep-files. Un Gateway géré en cours d’exécution redémarre automatiquement lorsque la désinstallation modifie la source du plugin.

En mode Nix (OPENCLAW_NIX_MODE=1), l’installation, la mise à jour, la désinstallation, l’activation et la désactivation des plugins sont toutes désactivées ; gérez ces choix dans la source Nix de l’installation.

Choisir une source

Les installations gérées depuis un chemin local doivent être des répertoires ou des archives de plugins. Placez les fichiers de plugin autonomes dans plugins.load.paths au lieu de les installer avec plugins install.

Publier des plugins

ClawHub est la principale surface publique de découverte des plugins OpenClaw. Publiez-y votre plugin lorsque vous souhaitez que les utilisateurs puissent trouver ses métadonnées, son historique des versions, les résultats d’analyse du registre et les indications d’installation avant de l’installer.

npm i -g clawhubclawhub loginclawhub package publish your-org/your-plugin --dry-runclawhub package publish your-org/your-pluginclawhub package publish your-org/your-plugin@v1.0.0

Les plugins npm natifs doivent inclure un manifeste de plugin (openclaw.plugin.json) ainsi que les métadonnées de package.json avant leur publication :

{  "name": "@acme/openclaw-plugin",  "version": "1.0.0",  "type": "module",  "openclaw": {    "extensions": ["./dist/index.js"]  }}

npm publish --access publicopenclaw plugins install npm:@acme/openclaw-pluginopenclaw plugins install npm:@acme/openclaw-plugin@betaopenclaw plugins install npm:@acme/openclaw-plugin@1.0.0

Consultez les pages suivantes pour connaître l’intégralité du contrat de publication au lieu de considérer cette page comme la référence en la matière :

• Publication sur ClawHub explique les propriétaires, les portées, les publications, la révision, la validation des paquets et le transfert de paquets.
• Création de plugins présente la structure complète d’un paquet de plugin (y compris openclaw.plugin.json) et le flux de travail de première publication.
• Manifeste de plugin définit les champs du manifeste natif d’un plugin.

Si le même paquet est disponible à la fois sur ClawHub et npm, utilisez le préfixe explicite clawhub: ou npm: pour imposer une source.

Pages associées

• Plugins - installer, configurer, redémarrer et résoudre les problèmes
• openclaw plugins - référence CLI complète
• Plugins communautaires - découverte publique et publication sur ClawHub
• ClawHub - opérations CLI du registre
• Création de plugins - créer un paquet de plugin
• Manifeste de plugin - manifeste et métadonnées du paquet