Pluginbundels

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 ingebouwde functies zoals Skills, hooks en MCP-tools.

Waarom bundels bestaan

Veel nuttige plugins worden gepubliceerd in de indeling van Codex, Claude of Cursor. In plaats van auteurs te verplichten ze als ingebouwde OpenClaw-plugins te herschrijven, detecteert OpenClaw deze indelingen en zet het de ondersteunde inhoud ervan om naar de ingebouwde functieset. U kunt een Claude-opdrachtenpakket of een Codex-Skills-bundel installeren en direct gebruiken.

Een bundel installeren

# Lokale mapopenclaw plugins install ./my-bundle # Archiefopenclaw plugins install ./my-bundle.tgz # Claude-marktplaatsopenclaw plugins marketplace list <source>openclaw plugins install <plugin> --marketplace <source>

openclaw plugins listopenclaw plugins inspect <id>

openclaw gateway restart

Wat OpenClaw vanuit bundels toewijst

Niet elke bundelfunctie wordt momenteel in OpenClaw uitgevoerd. Hieronder staat wat werkt en wat wel wordt gedetecteerd, maar nog niet is aangesloten.

Momenteel ondersteund

Skills-inhoud

• Hoofdmappen voor Skills uit de bundel worden als normale hoofdmappen voor OpenClaw-Skills geladen.
• Claude-hoofdmappen commands/ worden als aanvullende hoofdmappen voor Skills behandeld.
• Cursor-hoofdmappen .cursor/commands/ worden als aanvullende hoofdmappen voor Skills behandeld.

Markdown-opdrachtbestanden van Claude en opdrachtmarkdown van Cursor werken beide via de normale OpenClaw-lader voor Skills.

Hook-pakketten

Hoofdmappen voor bundelhooks werken alleen wanneer ze de normale indeling voor OpenClaw-hook-pakketten gebruiken: HOOK.md plus handler.ts of handler.js. Momenteel geldt dit voornamelijk voor het Codex-compatibele geval.

MCP voor ingebedde OpenClaw

• Ingeschakelde bundels kunnen configuratie voor MCP-servers aanleveren.
• OpenClaw voegt de MCP-configuratie van de bundel als mcpServers samen met de effectieve ingebedde OpenClaw-instellingen.
• OpenClaw stelt ondersteunde MCP-tools uit bundels beschikbaar tijdens agentbeurten van ingebedde OpenClaw door stdio-servers te starten of verbinding te maken met HTTP-servers.
• De toolprofielen coding en messaging bevatten standaard MCP-tools uit bundels; gebruik tools.deny: ["bundle-mcp"] om ze voor een agent of Gateway uit te schakelen.
• Projectlokale instellingen voor ingebedde agents worden nog steeds na de bundelstandaarden toegepast, zodat werkruimte-instellingen indien nodig MCP-vermeldingen uit bundels kunnen overschrijven.
• Toolcatalogi voor MCP uit bundels worden vóór registratie deterministisch gesorteerd, zodat wijzigingen in de bovenliggende listTools()-volgorde niet voortdurend de toolblokken in de promptcache wijzigen.

Transporten

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

Stdio start een onderliggend proces:

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

HTTP maakt verbinding met een actieve MCP-server en gebruikt standaard sse, tenzij streamable-http wordt aangevraagd:

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

• transport accepteert "streamable-http" of "sse"; bij weglaten is de standaardwaarde sse.
• type: "http" is een CLI-eigen vorm voor verdere verwerking; gebruik transport: "streamable-http" in de OpenClaw-configuratie. openclaw mcp set en openclaw doctor --fix normaliseren de gebruikelijke alias.
• Alleen de URL-schema's http: en https: zijn toegestaan.
• Waarden van headers ondersteunen interpolatie van ${ENV_VAR}.
• Een serververmelding met zowel command als url wordt geweigerd.
• URL-referenties (gebruikersinformatie en queryparameters) worden onleesbaar gemaakt in toolbeschrijvingen en logboeken.
• connectionTimeoutMs overschrijft de standaardverbindingstime-out van 30 seconden voor zowel stdio- als HTTP-transporten. De standaardtime-out voor aanvragen is 60 seconden en kan worden overschreven met requestTimeoutMs.

Naamgeving van tools

OpenClaw registreert MCP-tools uit bundels met providerveilige namen in de vorm serverName__toolName. Een server met de sleutel "vigil-harbor" die bijvoorbeeld een tool memory_search 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 lettervoorvoegsel, zodat numerieke serversleutels zoals 12306 providerveilige toolvoorvoegsels worden.
• Servervoorvoegsels zijn beperkt tot 30 tekens.
• Volledige toolnamen zijn beperkt tot 64 tekens.
• Lege servernamen vallen terug op mcp.
• Botsende opgeschoonde namen worden onderscheiden met numerieke achtervoegsels.
• De uiteindelijke volgorde van beschikbare tools is deterministisch op basis van de veilige naam, waardoor herhaalde beurten van ingebedde agents cachestabiel blijven.
• Profielfiltering behandelt elke tool van één MCP-server uit een bundel als eigendom van de Plugin bundle-mcp, zodat lijsten met toegestane of geweigerde profielen naar afzonderlijke beschikbare toolnamen of naar de Plugin-sleutel bundle-mcp kunnen verwijzen.

Instellingen voor ingebedde OpenClaw

Claude settings.json wordt als standaardinstellingen voor ingebedde OpenClaw geïmporteerd wanneer de bundel is ingeschakeld. OpenClaw schoont sleutels voor shelloverschrijvingen op voordat ze worden toegepast:

• shellPath
• shellCommandPrefix

LSP voor ingebedde OpenClaw

• Ingeschakelde Claude-bundels kunnen configuratie voor LSP-servers aanleveren.
• OpenClaw laadt .lsp.json plus eventuele in het manifest opgegeven lspServers-paden.
• De LSP-configuratie van de bundel wordt samengevoegd met de effectieve ingebedde standaardinstellingen voor OpenClaw-LSP.
• Momenteel kunnen alleen ondersteunde, door stdio aangestuurde LSP-servers worden uitgevoerd; niet-ondersteunde transporten worden nog steeds weergegeven in openclaw plugins inspect <id>.

Gedetecteerd maar niet uitgevoerd

Deze worden herkend en in diagnostische gegevens weergegeven, maar OpenClaw voert ze niet uit:

• Claude agents, automatisering via hooks/hooks.json, outputStyles
• Cursor .cursor/agents, .cursor/hooks.json, .cursor/rules
• Codex-metadata in .app.json buiten de rapportage van mogelijkheden

Bundelindelingen

Detectievolgorde

OpenClaw controleert eerst op de ingebouwde Plugin-indeling:

1. openclaw.plugin.json of een geldige package.json met openclaw.extensions - wordt behandeld als een ingebouwde Plugin
2. Bundelmarkeringen (.codex-plugin/, .claude-plugin/ of de standaardindeling van Claude/Cursor) - wordt behandeld als een bundel

Als een map beide bevat, gebruikt OpenClaw het ingebouwde pad. Dit voorkomt dat pakketten met twee indelingen gedeeltelijk als bundels worden geïnstalleerd.

Runtime-afhankelijkheden en opschoning

• Compatibele bundels van derden krijgen bij het opstarten geen herstel via npm install. Ze moeten via openclaw plugins install worden geïnstalleerd en alles wat ze nodig hebben meeleveren in de geïnstalleerde Plugin-map.
• Door OpenClaw beheerde meegeleverde plugins worden lichtgewicht in de kern meegeleverd of kunnen via het Plugin-installatieprogramma worden gedownload. Bij het opstarten voert de Gateway nooit een pakketbeheerder voor ze uit.
• openclaw doctor --fix verwijdert verouderde lokale installatierecords van meegeleverde plugins en kan downloadbare plugins herstellen die in de lokale Plugin-index ontbreken wanneer de configuratie er nog steeds naar verwijst.

Beveiliging

Bundels hebben een beperktere vertrouwensgrens dan ingebouwde plugins:

• OpenClaw laadt geen willekeurige runtimemodules uit bundels binnen het proces.
• Paden voor Skills en hook-pakketten moeten binnen de hoofdmap van de Plugin blijven (met grenscontrole).
• Instellingenbestanden worden met dezelfde grenscontroles gelezen.
• Ondersteunde stdio-MCP-servers kunnen als subprocessen worden gestart.

Hierdoor zijn bundels standaard veiliger, maar u moet bundels van derden nog steeds als vertrouwde inhoud behandelen voor de functies die ze beschikbaar stellen.

Problemen oplossen

Gerelateerd

• Plugins installeren en configureren
• Plugins bouwen - maak een ingebouwde Plugin
• Plugin-manifest - schema voor het ingebouwde manifest