--- read_when: - Vous souhaitez installer un bundle compatible avec Codex, Claude ou Cursor - Vous devez comprendre comment OpenClaw mappe le contenu du bundle vers les fonctionnalités natives - Vous déboguez la détection du bundle ou des capacités manquantes summary: Installer et utiliser les ensembles Codex, Claude et Cursor comme plugins OpenClaw title: Ensembles de Plugins x-i18n: generated_at: "2026-06-27T17:45:27Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: b26915603db9d4d4422f4d1542f033be02eb83c5ffefcf93cac7968f624f4969 source_path: plugins/bundles.md workflow: 16 --- OpenClaw peut installer des paquets issus de trois écosystèmes externes : **Codex**, **Claude** et **Cursor**. Ils sont appelés **paquets** — des ensembles de contenu et de métadonnées qu’OpenClaw associe à des fonctionnalités natives comme les Skills, les hooks et les outils MCP. Les paquets ne sont **pas** identiques aux plugins OpenClaw natifs. Les plugins natifs s’exécutent dans le processus et peuvent enregistrer n’importe quelle capacité. Les paquets sont des ensembles de contenu avec une association sélective des fonctionnalités et une frontière de confiance plus étroite. ## Pourquoi les paquets existent De nombreux plugins utiles sont publiés au format Codex, Claude ou Cursor. Au lieu d’obliger les auteurs à les réécrire en plugins OpenClaw natifs, OpenClaw détecte ces formats et associe leur contenu pris en charge à l’ensemble de fonctionnalités natif. Cela signifie que vous pouvez installer un pack de commandes Claude ou un paquet de Skills Codex et l’utiliser immédiatement. ## Installer un paquet ```bash # Local directory openclaw plugins install ./my-bundle # Archive openclaw plugins install ./my-bundle.tgz # Claude marketplace openclaw plugins marketplace list openclaw plugins install @ ``` ```bash openclaw plugins list openclaw plugins inspect ``` Les paquets apparaissent comme `Format: bundle`, avec un sous-type `codex`, `claude` ou `cursor`. ```bash openclaw gateway restart ``` Les fonctionnalités associées (Skills, hooks, outils MCP, valeurs LSP par défaut) sont disponibles dans la session suivante. ## Ce qu’OpenClaw associe depuis les paquets Toutes les fonctionnalités de paquet ne s’exécutent pas dans OpenClaw aujourd’hui. Voici ce qui fonctionne et ce qui est détecté mais pas encore câblé. ### Pris en charge actuellement | Fonctionnalité | Mode d’association | S’applique à | | -------------- | ------------------------------------------------------------------------------------------------- | -------------- | | Contenu Skill | Les racines de Skills du paquet se chargent comme des Skills OpenClaw normales | Tous les formats | | Commandes | `commands/` et `.cursor/commands/` sont traités comme des racines de Skills | Claude, Cursor | | Packs de hooks | Dispositions OpenClaw de type `HOOK.md` + `handler.ts` | Codex | | Outils MCP | Configuration MCP du paquet fusionnée dans les paramètres OpenClaw intégrés ; serveurs stdio et HTTP pris en charge chargés | Tous les formats | | Serveurs LSP | `.lsp.json` de Claude et `lspServers` déclarés dans le manifeste fusionnés dans les valeurs LSP OpenClaw intégrées par défaut | Claude | | Paramètres | `settings.json` de Claude importé comme paramètres OpenClaw intégrés par défaut | Claude | #### Contenu Skill - les racines de Skills du paquet se chargent comme des racines de Skills OpenClaw normales - les racines `commands` de Claude sont traitées comme des racines de Skills supplémentaires - les racines `.cursor/commands` de Cursor sont traitées comme des racines de Skills supplémentaires Cela signifie que les fichiers de commandes Markdown Claude fonctionnent via le chargeur de Skills OpenClaw normal. Le Markdown des commandes Cursor fonctionne via le même chemin. #### Packs de hooks - les racines de hooks de paquet fonctionnent **uniquement** lorsqu’elles utilisent la disposition normale des packs de hooks OpenClaw. Aujourd’hui, cela correspond principalement au cas compatible avec Codex : - `HOOK.md` - `handler.ts` ou `handler.js` #### MCP pour OpenClaw intégré - les paquets activés peuvent fournir une configuration de serveur MCP - OpenClaw fusionne la configuration MCP du paquet dans les paramètres OpenClaw intégrés effectifs sous `mcpServers` - OpenClaw expose les outils MCP de paquet pris en charge pendant les tours d’agent OpenClaw intégré en lançant des serveurs stdio ou en se connectant à des serveurs HTTP - les profils d’outils `coding` et `messaging` incluent les outils MCP de paquet par défaut ; utilisez `tools.deny: ["bundle-mcp"]` pour vous en désinscrire pour un agent ou une gateway - les paramètres d’agent intégré locaux au projet s’appliquent toujours après les valeurs par défaut du paquet, afin que les paramètres de l’espace de travail puissent remplacer les entrées MCP du paquet lorsque nécessaire - les catalogues d’outils MCP de paquet 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 d’invite ##### Transports Les serveurs MCP peuvent utiliser le transport stdio ou HTTP : **Stdio** lance un processus enfant : ```json { "mcp": { "servers": { "my-server": { "command": "node", "args": ["server.js"], "env": { "PORT": "3000" } } } } } ``` **HTTP** se connecte à un serveur MCP en cours d’exécution via `sse` par défaut, ou `streamable-http` lorsque cela est demandé : ```json { "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` - `type: "http"` est une forme aval native de la CLI ; utilisez `transport: "streamable-http"` dans la configuration OpenClaw. `openclaw mcp set` et `openclaw doctor --fix` normalisent l’alias courant. - 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 contenant à la fois `command` et `url` est rejetée - les identifiants d’URL (userinfo et paramètres de requête) sont expurgés des descriptions d’outils et des journaux - `connectionTimeoutMs` remplace le délai de connexion par défaut de 30 secondes pour les transports stdio et HTTP ##### Nommage des outils OpenClaw enregistre les outils MCP de paquet avec des noms compatibles avec les fournisseurs, sous la forme `serverName__toolName`. Par exemple, un serveur dont la clé est `"vigil-harbor"` et qui expose un outil `memory_search` est enregistré sous `vigil-harbor__memory_search`. - les caractères hors de `A-Za-z0-9_-` sont remplacés par `-` - les fragments qui commenceraient par une non-lettre reçoivent un préfixe alphabétique, de sorte que les clés de serveur numériques comme `12306` deviennent des préfixes d’outils compatibles avec les fournisseurs - les préfixes de serveur sont limités à 30 caractères - les noms complets des outils sont limités à 64 caractères - les noms de serveur vides utilisent `mcp` comme solution de repli - les noms assainis en collision sont différencié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 répétés d’agents intégrés stables pour le cache - le filtrage de profils traite tous les outils d’un même serveur MCP de paquet comme appartenant au plugin `bundle-mcp`, afin que les listes d’autorisation et de refus de profil puissent inclure soit des noms d’outils exposés individuels, soit la clé de plugin `bundle-mcp` #### Paramètres OpenClaw intégrés - `settings.json` de Claude est importé comme paramètres OpenClaw intégrés par défaut lorsque le paquet est activé - OpenClaw assainit les clés de remplacement du shell avant de les appliquer Clés assainies : - `shellPath` - `shellCommandPrefix` #### LSP OpenClaw intégré - les paquets Claude activés peuvent fournir une configuration de serveur LSP - OpenClaw charge `.lsp.json` ainsi que tous les chemins `lspServers` déclarés dans le manifeste - la configuration LSP du paquet est fusionnée dans les valeurs LSP OpenClaw intégrées effectives par défaut - seuls les serveurs LSP adossés à stdio pris en charge sont exécutables aujourd’hui ; les transports non pris en charge apparaissent tout de même dans `openclaw plugins inspect ` ### Détecté mais non exécuté Ces éléments sont reconnus et affichés dans les diagnostics, mais OpenClaw ne les exécute pas : - `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 des capacités ## Formats de paquets Marqueurs : `.codex-plugin/plugin.json` Contenu facultatif : `skills/`, `hooks/`, `.mcp.json`, `.app.json` Les paquets Codex s’intègrent le mieux à OpenClaw lorsqu’ils utilisent des racines de Skills et des répertoires de packs de hooks de style OpenClaw (`HOOK.md` + `handler.ts`). Deux modes de détection : - **Basé sur le manifeste :** `.claude-plugin/plugin.json` - **Sans manifeste :** disposition Claude par défaut (`skills/`, `commands/`, `agents/`, `hooks/`, `.mcp.json`, `.lsp.json`, `settings.json`) Comportement propre à Claude : - `commands/` est traité comme du contenu Skill - `settings.json` est importé dans les paramètres OpenClaw intégrés (les clés de remplacement du shell sont assainies) - `.mcp.json` expose les outils stdio pris en charge à OpenClaw intégré - `.lsp.json` ainsi que les chemins `lspServers` déclarés dans le manifeste se chargent dans les valeurs LSP OpenClaw intégrées par défaut - `hooks/hooks.json` est détecté mais non exécuté - les chemins de composants personnalisés dans le manifeste sont additifs (ils étendent les valeurs par défaut, sans les remplacer) Marqueurs : `.cursor-plugin/plugin.json` Contenu facultatif : `skills/`, `.cursor/commands/`, `.cursor/agents/`, `.cursor/rules/`, `.cursor/hooks.json`, `.mcp.json` - `.cursor/commands/` est traité comme du contenu Skill - `.cursor/rules/`, `.cursor/agents/` et `.cursor/hooks.json` sont seulement détectés ## Priorité de détection OpenClaw vérifie d’abord le format de plugin natif : 1. `openclaw.plugin.json` ou `package.json` valide avec `openclaw.extensions` — traité comme **plugin natif** 2. Marqueurs de paquet (`.codex-plugin/`, `.claude-plugin/` ou disposition Claude/Cursor par défaut) — traité comme **paquet** Si un répertoire contient les deux, OpenClaw utilise le chemin natif. Cela empêche les packages à double format d’être installés partiellement comme paquets. ## Dépendances d’exécution et nettoyage - Les paquets compatibles tiers ne bénéficient pas d’une réparation `npm install` au démarrage. Ils doivent être installés via `openclaw plugins install` et embarquer tout ce dont ils ont besoin dans le répertoire de plugin installé. - Les plugins groupés appartenant à OpenClaw sont soit fournis en version légère dans le cœur, soit téléchargeables via l’installateur de plugins. Le démarrage du Gateway n’exécute jamais de gestionnaire de packages pour eux. - `openclaw doctor --fix` supprime les anciens répertoires de dépendances préparés et peut récupérer les plugins téléchargeables absents de l’index local des plugins lorsque la configuration les référence. ## Sécurité Les paquets ont une frontière de confiance plus étroite que les plugins natifs : - OpenClaw ne charge **pas** de modules d’exécution arbitraires de paquet dans le processus - Les chemins de Skills et de packs de hooks doivent rester à l’intérieur de la racine du plugin (frontière vérifiée) - 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 Cela rend les paquets plus sûrs par défaut, mais vous devez tout de même traiter les paquets tiers comme du contenu de confiance pour les fonctionnalités qu’ils exposent. ## Dépannage Exécutez `openclaw plugins inspect `. Si une capacité est listée mais marquée comme non câblée, il s’agit d’une limite du produit — pas d’une installation défectueuse. Assurez-vous que le paquet est activé et que les fichiers Markdown se trouvent dans une racine `commands/` ou `skills/` détectée. Seuls les paramètres OpenClaw intégrés issus de `settings.json` sont pris en charge. OpenClaw ne traite pas les paramètres de paquet comme des correctifs de configuration bruts. `hooks/hooks.json` est uniquement détecté. Si vous avez besoin de hooks exécutables, utilisez la disposition des packs de hooks OpenClaw ou fournissez un plugin natif. ## Connexe - [Installer et configurer les plugins](/fr/tools/plugin) - [Créer des plugins](/fr/plugins/building-plugins) — créer un plugin natif - [Manifeste de plugin](/fr/plugins/manifest) — schéma du manifeste natif