Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

La plupart des workflows de plugins se résument à quelques commandes : rechercher, installer, redémarrer le Gateway, vérifier, puis désinstaller lorsque vous n’avez plus besoin du plugin.

​
Lister les plugins

openclaw plugins list
openclaw plugins list --enabled
openclaw plugins list --verbose
openclaw plugins list --json
Utilisez --json pour les scripts. Il inclut les diagnostics du registre et le dependencyStatus statique de chaque plugin lorsque le paquet du plugin déclare dependencies ou optionalDependencies. 
openclaw plugins list --json \
  | jq '.plugins[] | {id, enabled, format, source, dependencyStatus}'
plugins list est une vérification d’inventaire à froid. Elle montre ce qu’OpenClaw peut découvrir à partir de la configuration, des manifestes et du registre de plugins ; elle ne prouve pas qu’un processus Gateway déjà en cours d’exécution a importé le runtime du plugin.

​
Installer des plugins

# Search ClawHub for plugin packages.
openclaw plugins search "calendar"

# Bare package specs try ClawHub first, then npm fallback.
openclaw plugins install <package>

# Force one source.
openclaw plugins install clawhub:<package>
openclaw plugins install npm:<package>

# Install a specific version or dist-tag.
openclaw plugins install clawhub:<package>@1.2.3
openclaw plugins install clawhub:<package>@beta
openclaw plugins install npm:@scope/openclaw-plugin@1.2.3
openclaw plugins install npm:@openclaw/codex

# Install from git or a local development checkout.
openclaw plugins install git:github.com/acme/openclaw-plugin@v1.0.0
openclaw plugins install ./my-plugin
openclaw plugins install --link ./my-plugin
Après avoir installé le code du plugin, redémarrez le Gateway qui sert vos canaux : 
openclaw gateway restart
openclaw plugins inspect <plugin-id> --runtime --json
Utilisez inspect --runtime lorsque vous avez besoin de prouver que le plugin a enregistré des surfaces runtime telles que des outils, hooks, services, méthodes Gateway ou commandes CLI appartenant au plugin.

​
Mettre à jour les plugins

openclaw plugins update <plugin-id>
openclaw plugins update <npm-package-or-spec>
openclaw plugins update --all
Si un plugin a été installé depuis un dist-tag npm tel que @beta, les appels ultérieurs à update <plugin-id> réutilisent ce tag enregistré. Fournir une spec npm explicite fait basculer l’installation suivie vers cette spec pour les prochaines mises à jour. 
openclaw plugins update @scope/openclaw-plugin@beta
openclaw plugins update @scope/openclaw-plugin
La deuxième commande ramène un plugin sur la ligne de publication par défaut du registre lorsqu’il était auparavant épinglé à une version exacte ou à un tag. Lorsque openclaw update s’exécute sur le canal beta, les enregistrements de plugins npm et ClawHub de ligne par défaut tentent d’abord la publication @beta du plugin correspondante. Si cette publication beta n’existe pas, OpenClaw revient à la spec par défaut/latest enregistrée. Les versions exactes et les tags explicites tels que @rc ou @beta sont conservés.

​
Désinstaller des plugins

openclaw plugins uninstall <plugin-id> --dry-run
openclaw plugins uninstall <plugin-id>
openclaw plugins uninstall <plugin-id> --keep-files
openclaw gateway restart
La désinstallation supprime l’entrée de configuration du plugin, l’enregistrement d’index du plugin, les entrées de listes d’autorisation/refus, ainsi que 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.

​
Publier des plugins

Vous pouvez publier des plugins externes sur ClawHub, npmjs.com ou les deux.

​
Publier sur ClawHub

ClawHub est la principale surface publique de découverte pour les plugins OpenClaw. Il fournit aux utilisateurs des métadonnées consultables, un historique des versions et des résultats d’analyse du registre avant l’installation. 
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 utilisateurs installent depuis ClawHub avec : 
openclaw plugins install clawhub:<package>
openclaw plugins install <package>
La forme nue vérifie toujours ClawHub en premier.

​
Publier sur npmjs.com

Les plugins npm natifs doivent inclure un manifeste de plugin et des métadonnées de point d’entrée OpenClaw dans package.json.
package.json
{
  "name": "@acme/openclaw-plugin",
  "version": "1.0.0",
  "type": "module",
  "openclaw": {
    "extensions": ["./dist/index.js"]
  }
}

npm publish --access public
Les utilisateurs installent depuis npm uniquement avec : 
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
Si le même paquet est également disponible sur ClawHub, npm: ignore la recherche ClawHub et force la résolution npm.

​
Choix de la source

  • ClawHub : utilisez-le lorsque vous voulez une découverte native OpenClaw, des résumés d’analyse, des versions et des indications d’installation.
  • npmjs.com : utilisez-le lorsque vous publiez déjà des paquets JavaScript ou avez besoin de workflows avec dist-tags npm/registre privé.
  • Git : utilisez-le lorsque vous voulez installer directement depuis une branche, un tag ou un commit.
  • Chemin local : utilisez-le lorsque vous développez ou testez un plugin sur la même machine.

​
Liens connexes