Gérer les plugins

L’interface de contrôle couvre le workflow 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 consulter l’intégralité du contrat de commande, des options, des règles de sélection de la source et des cas limites, voir openclaw plugins.

Workflow CLI classique : trouvez 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, un chemin de base /openclaw utilise /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 en 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 le menu, en modifiant mcp.servers dans la configuration du Gateway.
• Découvrir correspond à la boutique : plugins en vedette inclus avec OpenClaw, plugins externes officiels et sélection organisée 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 ClawHub directement et ajoute une section Depuis ClawHub contenant 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 groupé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 ClawHub est effectuée par le Gateway et conserve ses vérifications de confiance, d’intégrité et de stratégie d’installation des plugins. Lorsqu’un administrateur active un plugin installé, cette confiance explicite est également enregistrée en ajoutant le plugin sélectionné à une liste restrictive plugins.allow existante. Une entrée plugins.deny explicite reste prioritaire et doit être supprimée avant d’activer le plugin.

L’installation ou la suppression du code d’un plugin nécessite un redémarrage du Gateway. Les modifications d’activation peuvent être appliquées 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 nécessaire. Les connecteurs MCP reposant sur 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 ne permet pas d’installer depuis des sources npm, git ou des chemins locaux arbitraires, de mettre à jour les plugins ni d’accéder à une configuration avancée des plugins. Utilisez les workflows 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 est une vérification d’inventaire à froid : elle indique ce qu’OpenClaw peut découvrir à partir de la configuration, des manifestes et du registre persistant des plugins. Elle 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 éléments dependencies/optionalDependencies déclarés sont résolus sur le disque).

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

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 groupés (fournisseurs groupés de modèles ou de synthèse vocale et plugin de navigateur groupé) sont activés par défaut ; les autres nécessitent enable après l’installation.

Installer des plugins

# Rechercher des paquets de plugins dans 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/[email protected]openclaw plugins install npm:@openclaw/codex # Installer depuis un artefact local produit par npm pack.openclaw plugins install npm-pack:<path.tgz> # Installer depuis git ou une copie de travail de développement locale.openclaw plugins install git:github.com/acme/[email protected]openclaw 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 groupé 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. Les paquets groupés et officiels du catalogue OpenClaw sont approuvés au même titre que les paquets ClawHub. Toute nouvelle source arbitraire npm, git, de chemin ou d’archive locale, npm-pack: ou de place de marché nécessite --force lors des installations non interactives, après examen et approbation de la source.

--force confirme une source autre que ClawHub sans demander de confirmation et remplace une cible d’installation existante si nécessaire. Pour les mises à niveau courantes d’une installation npm, ClawHub ou hook-pack suivie, utilisez plutôt openclaw plugins update. Avec --link, --force confirme uniquement la source ; le répertoire lié n’est ni copié ni remplacé.

Redémarrer et inspecter

Un Gateway géré en cours d’exécution, lorsque 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 et commandes CLI appartenant au plugin). Les commandes simples inspect et list effectuent uniquement des vérifications à froid du manifeste, de la configuration et du registre.

Mettre à jour les 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 le workflow de maintenance en masse. Il respecte toujours les spécifications d’installation suivies ordinaires, mais les enregistrements approuvés de plugins OpenClaw officiels sont synchronisés avec la cible actuelle du catalogue officiel au lieu de rester épinglés à un ancien paquet officiel exact ; lorsque update.channel vaut beta, cette synchronisation privilégie la branche de versions bêta. Utilisez une commande update <plugin-id> ciblée pour conserver sans modification une spécification officielle exacte ou balisé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 deuxième commande replace un plugin sur la branche de versions par défaut du registre lorsqu’il était précédemment épinglé à une version exacte ou à un tag.

Consultez openclaw plugins pour connaître précisément les règles 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 plugins.load.paths liées, 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 plutôt ces choix dans la source Nix de l’installation.

Choisir une source

Les installations gérées depuis un chemin local doivent correspondre à 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 vos plugins lorsque vous souhaitez que les utilisateurs puissent consulter leurs métadonnées, leur historique de versions, les résultats d’analyse du registre et les indications d’installation avant de les installer.

npm i -g clawhubclawhub loginclawhub package publish your-org/your-plugin --dry-runclawhub package publish your-org/your-pluginclawhub package publish your-org/[email protected]

Les plugins npm natifs doivent inclure un manifeste de plugin (openclaw.plugin.json) ainsi que les métadonnées 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/[email protected]

Utilisez les pages suivantes pour consulter l’intégralité du contrat de publication plutôt que de considérer cette page comme la référence en matière de publication :

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

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 connexes

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