openclaw plugins.
La plupart des flux d’installation consistent à :
- trouver un paquet
- l’installer depuis ClawHub, npm, git ou un chemin local
- laisser le Gateway géré redémarrer automatiquement, ou le redémarrer manuellement lorsqu’il n’est pas géré
- vérifier les enregistrements d’exécution du plugin
Lister et rechercher des plugins
--json pour les scripts :
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
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 :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
@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 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
--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
| Source | À utiliser quand | Exemple |
|---|---|---|
| ClawHub | Vous voulez une découverte native OpenClaw, des résumés d’analyse, des versions et des indications | openclaw plugins install clawhub:<package> |
| npmjs.com | Vous publiez déjà des paquets JavaScript ou avez besoin de dist-tags npm/d’un registre privé | openclaw plugins install npm:@acme/openclaw-plugin |
| git | Vous voulez une branche, une étiquette ou un commit depuis un dépôt | openclaw plugins install git:github.com/<owner>/<repo>@<ref> |
| chemin local | Vous développez ou testez un plugin sur la même machine | openclaw plugins install --link ./my-plugin |
| npm pack | Vous validez un artefact de paquet local via la sémantique d’installation npm | openclaw plugins install npm-pack:<path.tgz> |
| marketplace | Vous installez un plugin de marketplace compatible avec Claude | openclaw plugins install <plugin> --marketplace <source> |
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.package.json
- 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.
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