--- doc-schema-version: 1 read_when: - Vous souhaitez parcourir, installer, activer ou désactiver des plugins dans l’interface de contrôle - Vous souhaitez des exemples rapides pour répertorier, installer, mettre à jour, inspecter ou désinstaller des plugins - Vous souhaitez choisir une source d’installation de Plugin - Vous recherchez la documentation de référence appropriée pour publier des paquets de Plugins sidebarTitle: Manage plugins summary: Gérez les plugins OpenClaw depuis l’interface de contrôle ou la CLI title: Gérer les plugins x-i18n: generated_at: "2026-07-12T02:51:15Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: 0b235dfca7ef815cc8b0f82db6a9ba8cb344b00612ffd77ca67c8bbd379bdf2a source_path: plugins/manage-plugins.md workflow: 16 --- 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`](/fr/cli/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](/fr/cli/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](https://clawhub.ai/plugins) 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 ` 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 ```bash openclaw plugins list openclaw plugins list --enabled openclaw plugins list --verbose openclaw plugins list --json openclaw plugins search "calendar" ``` `--json` pour les scripts : ```bash 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:`). ## Activer et désactiver des plugins ```bash openclaw plugins enable openclaw plugins disable ``` 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 ```bash # Rechercher des paquets de plugins sur ClawHub. openclaw plugins search "calendar" # Installer depuis ClawHub. openclaw plugins install clawhub: openclaw plugins install clawhub:@1.2.3 openclaw plugins install clawhub:@beta # Installer depuis npm. openclaw plugins install npm: openclaw plugins install npm:@scope/openclaw-plugin@1.2.3 openclaw plugins install npm:@openclaw/codex # Installer depuis un artefact npm-pack local. openclaw plugins install npm-pack: # Installer depuis git ou une copie de travail locale de développement. openclaw plugins install git:github.com/acme/openclaw-plugin@v1.0.0 openclaw plugins install ./my-plugin openclaw 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 : ```bash openclaw gateway restart openclaw plugins inspect --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 ```bash openclaw plugins update openclaw plugins update openclaw plugins update --all openclaw plugins update --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 `. `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 ` 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 : ```bash openclaw plugins update @scope/openclaw-plugin@beta openclaw 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`](/fr/cli/plugins#update) pour connaître les règles exactes de repli et d’épinglage. ## Désinstaller des plugins ```bash openclaw plugins uninstall --dry-run openclaw plugins uninstall openclaw plugins uninstall --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 | Source | À utiliser lorsque | Exemple | | ----------- | ----------------------------------------------------------------------------- | -------------------------------------------------------------- | | ClawHub | Vous souhaitez la découverte native d’OpenClaw, les résumés d’analyse, les versions et les indications | `openclaw plugins install clawhub:` | | git | Vous souhaitez une branche, une étiquette ou un commit provenant d’un dépôt | `openclaw plugins install git:github.com//@` | | chemin local | Vous développez ou testez un plugin sur la même machine | `openclaw plugins install --link ./my-plugin` | | place de marché | Vous installez un plugin de place de marché compatible avec Claude | `openclaw plugins install --marketplace ` | | paquet npm | Vous validez un artefact de paquet local au moyen de la sémantique d’installation npm | `openclaw plugins install npm-pack:` | | npmjs.com | Vous distribuez déjà des paquets JavaScript ou avez besoin de dist-tags npm ou d’un registre privé | `openclaw plugins install npm:@acme/openclaw-plugin` | 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. ```bash npm i -g clawhub clawhub login clawhub package publish your-org/your-plugin --dry-run clawhub package publish your-org/your-plugin clawhub 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 : ```json package.json { "name": "@acme/openclaw-plugin", "version": "1.0.0", "type": "module", "openclaw": { "extensions": ["./dist/index.js"] } } ``` ```bash npm publish --access public openclaw plugins install npm:@acme/openclaw-plugin openclaw plugins install npm:@acme/openclaw-plugin@beta openclaw 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](/fr/clawhub/publishing) 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](/fr/plugins/building-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](/fr/plugins/manifest) 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](/fr/tools/plugin) - installer, configurer, redémarrer et résoudre les problèmes - [`openclaw plugins`](/fr/cli/plugins) - référence CLI complète - [Plugins communautaires](/fr/plugins/community) - découverte publique et publication sur ClawHub - [ClawHub](/fr/clawhub/cli) - opérations CLI du registre - [Création de plugins](/fr/plugins/building-plugins) - créer un paquet de plugin - [Manifeste de plugin](/fr/plugins/manifest) - manifeste et métadonnées du paquet