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 modifiantmcp.serversdans 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.
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
--json pour les scripts :
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
enable après l’installation.
Installer des plugins
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 :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
@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 pour connaître précisément les règles de repli et d’épinglage.
Désinstaller des plugins
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.openclaw.plugin.json) ainsi que les métadonnées package.json avant leur publication :
package.json
- 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.
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