Plugin-bundels

OpenClaw kan plugins uit drie externe ecosystemen installeren: Codex, Claude en Cursor. Deze worden bundels genoemd: pakketten met inhoud en metadata die OpenClaw omzet naar native functies zoals Skills, hooks en MCP-tools.

Waarom bundels bestaan

Veel nuttige plugins worden gepubliceerd in Codex-, Claude- of Cursor-indeling. In plaats van auteurs te verplichten ze te herschrijven als native OpenClaw-plugins, detecteert OpenClaw deze indelingen en zet de ondersteunde inhoud om naar de native functieset. Dit betekent dat je een Claude-commandopakket of een Codex-Skills-bundel kunt installeren en meteen gebruiken.

Een bundel installeren

# Local directoryopenclaw plugins install ./my-bundle # Archiveopenclaw plugins install ./my-bundle.tgz # Claude marketplaceopenclaw plugins marketplace list <marketplace-name>openclaw plugins install <plugin-name>@<marketplace-name>

openclaw plugins listopenclaw plugins inspect <id>

openclaw gateway restart

Wat OpenClaw omzet vanuit bundels

Niet elke bundelfunctie draait vandaag in OpenClaw. Dit werkt al en dit wordt wel gedetecteerd maar nog niet aangesloten.

Nu ondersteund

Skill-inhoud

• bundel-Skill-roots worden geladen als normale OpenClaw-Skill-roots
• Claude-commands-roots worden behandeld als extra Skill-roots
• Cursor-.cursor/commands-roots worden behandeld als extra Skill-roots

Dit betekent dat Claude-markdowncommandobestanden werken via de normale OpenClaw-Skill- loader. Cursor-commandomarkdown werkt via hetzelfde pad.

Hook-pakketten

• bundel-hook-roots werken alleen wanneer ze de normale OpenClaw-hook-pack- layout gebruiken. Vandaag is dit vooral de Codex-compatibele situatie:
  • HOOK.md
  • handler.ts of handler.js

MCP voor Pi

• ingeschakelde bundels kunnen MCP-serverconfig bijdragen
• OpenClaw voegt bundel-MCP-config samen in de effectieve ingebedde Pi-instellingen als mcpServers
• OpenClaw stelt ondersteunde bundel-MCP-tools beschikbaar tijdens beurten van ingebedde Pi-agents door stdio-servers te starten of verbinding te maken met HTTP-servers
• de coding- en messaging-toolprofielen bevatten standaard bundel-MCP-tools; gebruik tools.deny: ["bundle-mcp"] om je af te melden voor een agent of Gateway
• project-lokale Pi-instellingen blijven van toepassing na bundelstandaarden, zodat werkruimte- instellingen bundel-MCP-vermeldingen kunnen overschrijven wanneer nodig
• bundel-MCP-toolcatalogi worden deterministisch gesorteerd vóór registratie, zodat upstreamwijzigingen in de volgorde van listTools() geen prompt-cache-toolblokken laten schommelen

Transports

MCP-servers kunnen stdio- of HTTP-transport gebruiken:

Stdio start een childproces:

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

HTTP maakt standaard verbinding met een draaiende MCP-server via sse, of via streamable-http wanneer daarom wordt gevraagd:

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

• transport mag worden ingesteld op "streamable-http" of "sse"; wanneer dit wordt weggelaten, gebruikt OpenClaw sse
• type: "http" is een CLI-native downstreamvorm; gebruik transport: "streamable-http" in OpenClaw-config. openclaw mcp set en openclaw doctor --fix normaliseren de algemene alias.
• alleen http:- en https:-URL-schema's zijn toegestaan
• headers-waarden ondersteunen ${ENV_VAR}-interpolatie
• een serververmelding met zowel command als url wordt geweigerd
• URL-inloggegevens (userinfo en queryparameters) worden geredigeerd uit tool- beschrijvingen en logs
• connectionTimeoutMs overschrijft de standaard verbindingstime-out van 30 seconden voor zowel stdio- als HTTP-transports

Toolnaamgeving

OpenClaw registreert bundel-MCP-tools met provider-veilige namen in de vorm serverName__toolName. Bijvoorbeeld: een server met sleutel "vigil-harbor" die een memory_search-tool beschikbaar stelt, wordt geregistreerd als vigil-harbor__memory_search.

• tekens buiten A-Za-z0-9_- worden vervangen door -
• fragmenten die met een niet-letter zouden beginnen, krijgen een letterprefix, zodat numerieke serversleutels zoals 12306 provider-veilige toolprefixes worden
• serverprefixes zijn beperkt tot 30 tekens
• volledige toolnamen zijn beperkt tot 64 tekens
• lege servernamen vallen terug op mcp
• botsende geschoonde namen worden onderscheiden met numerieke suffixen
• de uiteindelijke blootgestelde toolvolgorde is deterministisch op veilige naam om herhaalde Pi- beurten cache-stabiel te houden
• profielfiltering behandelt alle tools van één bundel-MCP-server als plugin-owned door bundle-mcp, zodat profiel-allowlists en deny lists zowel individuele blootgestelde toolnamen als de bundle-mcp-pluginsleutel kunnen bevatten

Ingebedde Pi-instellingen

• Claude settings.json wordt geïmporteerd als standaard ingebedde Pi-instellingen wanneer de bundel is ingeschakeld
• OpenClaw schoont shell-overschrijvingssleutels op voordat ze worden toegepast

Opgeschoonde sleutels:

• shellPath
• shellCommandPrefix

Ingebedde Pi-LSP

• ingeschakelde Claude-bundels kunnen LSP-serverconfig bijdragen
• OpenClaw laadt .lsp.json plus alle in het manifest gedeclareerde lspServers-paden
• bundel-LSP-config wordt samengevoegd in de effectieve ingebedde Pi-LSP-standaarden
• alleen ondersteunde stdio-backed LSP-servers zijn vandaag uitvoerbaar; niet-ondersteunde transports verschijnen nog steeds in openclaw plugins inspect <id>

Gedetecteerd maar niet uitgevoerd

Deze worden herkend en getoond in diagnostics, maar OpenClaw voert ze niet uit:

• Claude agents, hooks.json-automatisering, outputStyles
• Cursor .cursor/agents, .cursor/hooks.json, .cursor/rules
• Codex inline/app-metadata buiten capabilityrapportage

Bundelindelingen

Detectieprioriteit

OpenClaw controleert eerst op native pluginindeling:

1. openclaw.plugin.json of geldige package.json met openclaw.extensions — behandeld als native plugin
2. Bundelmarkeringen (.codex-plugin/, .claude-plugin/ of standaard Claude/Cursor-layout) — behandeld als bundel

Als een directory beide bevat, gebruikt OpenClaw het native pad. Dit voorkomt dat dual-format-pakketten gedeeltelijk als bundels worden geïnstalleerd.

Runtimeafhankelijkheden en opschoning

• Compatibele bundels van derden krijgen geen startup-npm install-reparatie. Ze moeten worden geïnstalleerd via openclaw plugins install en alles meeleveren wat ze nodig hebben in de geïnstalleerde plugindirectory.
• Door OpenClaw beheerde gebundelde plugins worden lichtgewicht in core meegeleverd of zijn downloadbaar via de plugininstaller. Gateway-startup draait nooit een package manager voor ze.
• openclaw doctor --fix verwijdert verouderde gestagede afhankelijkheidsdirectories en kan downloadbare plugins herstellen die ontbreken in de lokale pluginindex wanneer config ernaar verwijst.

Beveiliging

Bundels hebben een smallere vertrouwensgrens dan native plugins:

• OpenClaw laadt geen willekeurige bundel-runtimemodules in-process
• Skills- en hook-packpaden moeten binnen de pluginroot blijven (grensgecontroleerd)
• Instellingenbestanden worden gelezen met dezelfde grenscontroles
• Ondersteunde stdio-MCP-servers kunnen als subprocessen worden gestart

Dit maakt bundels standaard veiliger, maar je moet bundels van derden nog steeds behandelen als vertrouwde inhoud voor de functies die ze wel blootstellen.

Probleemoplossing

Gerelateerd

• Plugins installeren en configureren
• Plugins bouwen — maak een native plugin
• Pluginmanifest — native manifestschema