Plugin-bundels

OmeniaClaw kan plugins uit drie externe ecosystemen installeren: Codex, Claude en Cursor. Deze worden bundels genoemd: pakketten met inhoud en metadata die OmeniaClaw 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 OmeniaClaw-plugins, detecteert OmeniaClaw 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 directoryOmeniaClaw plugins install ./my-bundle # ArchiveOmeniaClaw plugins install ./my-bundle.tgz # Claude marketplaceOmeniaClaw plugins marketplace list <marketplace-name>OmeniaClaw plugins install <plugin-name>@<marketplace-name>

OmeniaClaw plugins listOmeniaClaw plugins inspect <id>

OmeniaClaw gateway restart

Wat OmeniaClaw omzet vanuit bundels

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

Nu ondersteund

Skill-inhoud

• bundel-Skill-roots worden geladen als normale OmeniaClaw-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 OmeniaClaw-Skill- loader. Cursor-commandomarkdown werkt via hetzelfde pad.

Hook-pakketten

• bundel-hook-roots werken alleen wanneer ze de normale OmeniaClaw-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
• OmeniaClaw voegt bundel-MCP-config samen in de effectieve ingebedde Pi-instellingen als mcpServers
• OmeniaClaw 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 OmeniaClaw sse
• type: "http" is een CLI-native downstreamvorm; gebruik transport: "streamable-http" in OmeniaClaw-config. OmeniaClaw mcp set en OmeniaClaw 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

OmeniaClaw 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
• OmeniaClaw schoont shell-overschrijvingssleutels op voordat ze worden toegepast

Opgeschoonde sleutels:

• shellPath
• shellCommandPrefix

Ingebedde Pi-LSP

• ingeschakelde Claude-bundels kunnen LSP-serverconfig bijdragen
• OmeniaClaw 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 OmeniaClaw plugins inspect <id>

Gedetecteerd maar niet uitgevoerd

Deze worden herkend en getoond in diagnostics, maar OmeniaClaw 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

OmeniaClaw controleert eerst op native pluginindeling:

1. OmeniaClaw.plugin.json of geldige package.json met OmeniaClaw.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 OmeniaClaw 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 OmeniaClaw plugins install en alles meeleveren wat ze nodig hebben in de geïnstalleerde plugindirectory.
• Door OmeniaClaw beheerde gebundelde plugins worden lichtgewicht in core meegeleverd of zijn downloadbaar via de plugininstaller. Gateway-startup draait nooit een package manager voor ze.
• OmeniaClaw 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:

• OmeniaClaw 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