Pluginbundels

​

Waarom bundels bestaan

​

Een bundel installeren

# Lokale map
openclaw plugins install ./my-bundle

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

# Claude-marketplace
openclaw plugins marketplace list <source>
openclaw plugins install <plugin> --marketplace <source>

openclaw plugins list
openclaw plugins inspect <id>

openclaw gateway restart

​

Wat OpenClaw uit bundels toewijst

​

Momenteel ondersteund

​

Skills-inhoud

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

​

Hookpakketten

​

MCP voor ingesloten OpenClaw

• Ingeschakelde bundels kunnen MCP-serverconfiguratie aanleveren.
• OpenClaw voegt de MCP-configuratie van de bundel als mcpServers samen met de effectieve instellingen van ingesloten OpenClaw.
• OpenClaw stelt ondersteunde MCP-tools uit bundels beschikbaar tijdens agentbeurten van ingesloten 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 dit voor een agent of Gateway uit te schakelen.
• Projectlokale instellingen voor ingesloten agents blijven van toepassing na de standaardwaarden van de bundel, zodat werkruimte-instellingen indien nodig MCP-vermeldingen van de bundel kunnen overschrijven.
• MCP-toolcatalogi van bundels worden vóór registratie deterministisch gesorteerd, zodat wijzigingen in de volgorde van upstream-listTools() geen voortdurende wijzigingen in toolblokken van de promptcache veroorzaken.

Transporten

{
  "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 accepteert "streamable-http" of "sse"; bij weglating is de standaardwaarde sse.
• type: "http" is een CLI-eigen downstream-vorm; gebruik transport: "streamable-http" in de OpenClaw-configuratie. openclaw mcp set en openclaw doctor --fix normaliseren de algemene alias.
• Alleen de URL-schema’s http: en https: zijn toegestaan.
• headers-waarden ondersteunen ${ENV_VAR}-interpolatie.
• Een serververmelding met zowel command als url wordt geweigerd.
• URL-aanmeldgegevens (gebruikersinformatie en queryparameters) worden afgeschermd in toolbeschrijvingen en logboeken.
• connectionTimeoutMs overschrijft de standaardverbindingstime-out van 30 seconden voor zowel stdio- als HTTP-transporten. De time-out voor aanvragen is standaard 60 seconden en kan worden overschreven met requestTimeoutMs.

Toolnamen

• Tekens buiten A-Za-z0-9_- worden vervangen door -.
• Fragmenten die met een niet-letter zouden beginnen, krijgen een letter als voorvoegsel, 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 beschikbaar gestelde tools is deterministisch op basis van de veilige naam, waardoor herhaalde beurten van ingesloten 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/geweigerde profielen kunnen verwijzen naar afzonderlijke beschikbaar gestelde toolnamen of de pluginsleutel bundle-mcp.

​

Instellingen voor ingesloten OpenClaw

• shellPath
• shellCommandPrefix

​

LSP voor ingesloten OpenClaw

• Ingeschakelde Claude-bundels kunnen LSP-serverconfiguratie aanleveren.
• OpenClaw laadt .lsp.json plus alle in het manifest gedeclareerde lspServers-paden.
• De LSP-configuratie van de bundel wordt samengevoegd met de effectieve LSP-standaardwaarden van ingesloten OpenClaw.
• Alleen ondersteunde, op stdio gebaseerde LSP-servers kunnen momenteel worden uitgevoerd; niet-ondersteunde transporten worden nog steeds weergegeven in openclaw plugins inspect <id>.

​

Gedetecteerd maar niet uitgevoerd

• Claude-agents, hooks/hooks.json-automatisering, outputStyles
• Cursor-.cursor/agents, .cursor/hooks.json, .cursor/rules
• Codex-.app.json-metadata naast mogelijkhedenrapportage

​

Bundelindelingen

​

Detectievolgorde

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

​

Runtime-afhankelijkheden en opschoning

• Compatibele bundels van derden krijgen bij het opstarten geen npm install-reparatie. Ze moeten via openclaw plugins install worden geïnstalleerd en alles wat ze nodig hebben in de geïnstalleerde pluginmap meeleveren.
• Gebundelde plugins die eigendom zijn van OpenClaw worden ofwel lichtgewicht in de kern meegeleverd, of kunnen via het installatieprogramma voor plugins worden gedownload. Bij het opstarten van de Gateway wordt hiervoor nooit een pakketbeheerder uitgevoerd.
• openclaw doctor --fix verwijdert verouderde lokale installatierecords van gebundelde plugins en kan downloadbare plugins herstellen die ontbreken in de lokale pluginindex wanneer de configuratie er nog naar verwijst.

​

Beveiliging

• OpenClaw laadt geen willekeurige runtime-modules van bundels in het proces.
• Paden voor Skills en hookpakketten moeten binnen de hoofdmap van de plugin blijven (grenzen worden gecontroleerd).
• Instellingsbestanden worden met dezelfde grenscontroles gelezen.
• Ondersteunde stdio-MCP-servers kunnen als subprocessen worden gestart.

​

Problemen oplossen

​

Gerelateerd

• Plugins installeren en configureren
• Plugins bouwen - maak een native plugin
• Pluginmanifest - schema voor een native manifest