Gérer les plugins

Utilisez cette page pour les commandes courantes de gestion des plugins. Pour le contrat de commande exhaustif, les options, les règles de sélection de source et les cas limites, consultez openclaw plugins.

La plupart des flux d’installation consistent à :

1. trouver un paquet
2. l’installer depuis ClawHub, npm, git ou un chemin local
3. laisser le Gateway géré redémarrer automatiquement, ou le redémarrer manuellement lorsqu’il n’est pas géré
4. vérifier les enregistrements d’exécution du plugin

Lister et rechercher des plugins

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

Utilisez --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 affiche ce qu’OpenClaw peut découvrir depuis la configuration, les manifestes et le registre des plugins ; elle ne prouve pas qu’un Gateway déjà en cours d’exécution a importé l’exécution du plugin. La sortie JSON inclut les diagnostics du registre et le dependencyStatus statique de chaque plugin lorsque le paquet du plugin déclare des dependencies ou des optionalDependencies.

plugins search interroge ClawHub pour trouver des paquets de plugins installables et affiche des indications d’installation comme openclaw plugins install clawhub:<package>.

Installer des plugins

# Search ClawHub for plugin packages.openclaw plugins search "calendar" # Install from ClawHub.openclaw plugins install clawhub:<package>openclaw plugins install clawhub:<package>@1.2.3openclaw plugins install clawhub:<package>@beta # Install from npm.openclaw plugins install npm:<package>openclaw plugins install npm:@scope/openclaw-plugin@1.2.3openclaw plugins install npm:@openclaw/codex # Install from a local npm pack artifact.openclaw plugins install npm-pack:<path.tgz> # Install from git or a local development checkout.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 nues s’installent depuis npm pendant la transition de lancement. Utilisez clawhub:, npm:, git: ou npm-pack: lorsque vous avez besoin d’une sélection de source déterministe. Si le nom nu correspond à un identifiant de plugin officiel, OpenClaw peut installer directement l’entrée du catalogue.

Utilisez --force uniquement lorsque vous voulez intentionnellement écraser une cible d’installation existante. Pour les mises à niveau courantes d’installations suivies depuis npm, ClawHub ou hook-pack, utilisez openclaw plugins update.

Redémarrer et inspecter

Après l’installation, la mise à jour ou la désinstallation du code d’un plugin, un Gateway géré en cours d’exécution avec le rechargement de configuration activé redémarre automatiquement. 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 en direct :

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

Utilisez inspect --runtime lorsque vous avez besoin de prouver que le plugin a enregistré des surfaces d’exécution comme des outils, hooks, services, méthodes Gateway, routes HTTP ou commandes CLI appartenant au plugin. inspect et list simples sont des vérifications à froid de manifeste, de configuration et de 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

Lorsque vous passez un identifiant de plugin, OpenClaw réutilise la spécification d’installation suivie. Les dist-tags stockés comme @beta et les versions épinglées exactes continuent à être utilisés lors des exécutions ultérieures de update <plugin-id>.

openclaw plugins update --all est le chemin de maintenance en masse. Il respecte toujours les spécifications d’installation suivies ordinaires, mais les enregistrements de plugins OpenClaw officiels de confiance peuvent se synchroniser sur la cible actuelle du catalogue officiel au lieu de rester sur un paquet officiel exact obsolète. Si update.channel est défini sur beta, cette synchronisation officielle en masse utilise le contexte du canal bêta. Utilisez un update <plugin-id> ciblé lorsque vous voulez intentionnellement conserver inchangée une spécification officielle exacte ou étiquetée.

Pour les installations npm, vous pouvez passer 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 ramène un plugin vers la ligne de publication par défaut du registre lorsqu’il était auparavant épinglé à une version exacte ou à une étiquette.

Lorsque openclaw update s’exécute sur le canal bêta, les enregistrements de plugins peuvent privilégier les versions @beta correspondantes. Pour les règles exactes de repli et d’épinglage, consultez openclaw plugins.

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 persisté d’index du plugin, les entrées de listes d’autorisation/refus et les chemins de chargement liés le cas échéant. Les répertoires d’installation gérés sont supprimés sauf si vous passez --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), les commandes d’installation, de mise à jour, de désinstallation, d’activation et de désactivation des plugins sont 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 être des répertoires ou archives de plugin. 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 de découverte publique pour les plugins OpenClaw. Publiez-y lorsque vous voulez que les utilisateurs trouvent les métadonnées du plugin, l’historique des versions, les résultats d’analyse du registre et les indications d’installation avant d’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 et des métadonnées de paquet avant 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

Utilisez ces pages pour le contrat de publication complet au lieu de considérer cette page comme la référence de publication :

• Publication ClawHub explique les propriétaires, portées, versions, revues, validations de paquet et transferts de paquet.
• Créer des plugins montre la forme du paquet de plugin et le premier flux de publication.
• Manifeste de plugin définit les champs du manifeste de plugin natif.

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

Connexe

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