​

Bundles de plugins

​

Pourquoi les bundles existent

​

Installer un bundle

# Répertoire local
openclaw plugins install ./my-bundle

# Archive
openclaw plugins install ./my-bundle.tgz

# Marketplace Claude
openclaw plugins marketplace list <marketplace-name>
openclaw plugins install <plugin-name>@<marketplace-name>

openclaw plugins list
openclaw plugins inspect <id>

openclaw gateway restart

​

Ce qu’OpenClaw mappe depuis les bundles

​

Pris en charge maintenant

​

Contenu de Skill

• les racines de Skills du bundle se chargent comme des racines de Skills OpenClaw normales
• les racines commands Claude sont traitées comme des racines de Skills supplémentaires
• les racines .cursor/commands Cursor sont traitées comme des racines de Skills supplémentaires

​

Packs de hooks

• les racines de hooks du bundle fonctionnent uniquement lorsqu’elles utilisent la disposition normale des packs de hooks OpenClaw. Aujourd’hui, il s’agit principalement du cas compatible Codex :
  • HOOK.md
  • handler.ts ou handler.js

​

MCP pour Pi

• les bundles activés peuvent contribuer une configuration de serveur MCP
• OpenClaw fusionne la configuration MCP du bundle dans les paramètres Pi embarqués effectifs sous mcpServers
• OpenClaw expose les outils MCP de bundle pris en charge pendant les tours d’agent Pi embarqué en lançant des serveurs stdio ou en se connectant à des serveurs HTTP
• les paramètres Pi locaux au projet s’appliquent toujours après les valeurs par défaut du bundle, de sorte que les paramètres d’espace de travail peuvent remplacer les entrées MCP du bundle si nécessaire
• les catalogues d’outils MCP des bundles sont triés de manière déterministe avant l’enregistrement, afin que les changements d’ordre listTools() en amont ne perturbent pas les blocs d’outils du cache de prompt

Transports

{
  "mcp": {
    "servers": {
      "my-server": {
        "command": "node",
        "args": ["server.js"],
        "env": { "PORT": "3000" }
      }
    }
  }
}

{
  "mcp": {
    "servers": {
      "my-server": {
        "url": "http://localhost:3100/mcp",
        "transport": "streamable-http",
        "headers": {
          "Authorization": "Bearer ${MY_SECRET_TOKEN}"
        },
        "connectionTimeoutMs": 30000
      }
    }
  }
}

• transport peut être défini sur "streamable-http" ou "sse" ; lorsqu’il est omis, OpenClaw utilise sse
• seuls les schémas d’URL http: et https: sont autorisés
• les valeurs headers prennent en charge l’interpolation ${ENV_VAR}
• une entrée de serveur avec à la fois command et url est rejetée
• les identifiants d’URL (userinfo et paramètres de requête) sont masqués dans les descriptions d’outils et les journaux
• connectionTimeoutMs remplace le délai de connexion par défaut de 30 secondes pour les transports stdio et HTTP

Nommage des outils

• les caractères hors de A-Za-z0-9_- sont remplacés par -
• les préfixes de serveur sont plafonnés à 30 caractères
• les noms complets d’outils sont plafonnés à 64 caractères
• les noms de serveur vides reviennent à mcp
• les noms assainis en collision sont désambiguïsés avec des suffixes numériques
• l’ordre final des outils exposés est déterministe par nom sûr afin de garder les tours Pi répétés stables vis-à-vis du cache

​

Paramètres Pi embarqués

• le settings.json de Claude est importé comme paramètres Pi embarqués par défaut lorsque le bundle est activé
• OpenClaw assainit les clés de remplacement du shell avant de les appliquer

• shellPath
• shellCommandPrefix

​

LSP Pi embarqué

• les bundles Claude activés peuvent contribuer une configuration de serveur LSP
• OpenClaw charge .lsp.json plus tous les chemins lspServers déclarés dans le manifeste
• la configuration LSP du bundle est fusionnée dans les valeurs par défaut LSP effectives de Pi embarqué
• seuls les serveurs LSP adossés à stdio pris en charge peuvent être exécutés aujourd’hui ; les transports non pris en charge apparaissent toujours dans openclaw plugins inspect <id>

​

Détecté mais non exécuté

• agents, automatisation hooks.json, outputStyles de Claude
• .cursor/agents, .cursor/hooks.json, .cursor/rules de Cursor
• métadonnées inline/app Codex au-delà du signalement de capacité

​

Formats de bundle

​

Priorité de détection

1. openclaw.plugin.json ou package.json valide avec openclaw.extensions — traité comme plugin natif
2. Marqueurs de bundle (.codex-plugin/, .claude-plugin/, ou disposition Claude/Cursor par défaut) — traité comme bundle

​

Sécurité

• OpenClaw ne charge pas arbitrairement des modules runtime de bundle dans le processus
• les chemins des Skills et des packs de hooks doivent rester à l’intérieur de la racine du plugin (vérification de frontière)
• les fichiers de paramètres sont lus avec les mêmes vérifications de frontière
• les serveurs MCP stdio pris en charge peuvent être lancés comme sous-processus

​

Dépannage

​

Lié

• Installer et configurer des plugins
• Building Plugins — créer un plugin natif
• Manifeste de plugin — schéma du manifeste natif