Skip to main content
De Plugin SDK bevat beperkte openbare subpaden en uitsluitend voor de repository bestemde gebundelde helpers onder openclaw/plugin-sdk/. Deze pagina inventariseert beide en markeert privé-lokale vermeldingen expliciet. Drie bestanden definiëren de grens:
  • scripts/lib/plugin-sdk-entrypoints.json: de onderhouden inventaris van entrypoints die door de build wordt gecompileerd.
  • scripts/lib/plugin-sdk-private-local-only-subpaths.json: interne subpaden die zijn uitgesloten van de getypeerde, gedocumenteerde SDK. Productie-entrypoints blijven beschikbaar als uitsluitend JavaScript-hostruntime-exports voor afzonderlijk gepubliceerde officiële plugins; entrypoints die alleen voor tests zijn bedoeld, blijven ongeëxporteerd.
  • src/plugin-sdk/entrypoints.ts: classificatiemetadata voor verouderde subpaden, gereserveerde gebundelde helpers, ondersteunde gebundelde façades en openbare oppervlakken die eigendom zijn van plugins.
Onderhouders controleren het aantal openbare exports met pnpm plugin-sdk:surface en actieve gereserveerde helpersubpaden met pnpm plugins:boundary-report:summary; ongebruikte gereserveerde helperexports laten het CI-rapport mislukken in plaats van als slapende compatibiliteitsschuld in de openbare SDK te blijven. Zie voor de handleiding voor het schrijven van plugins het overzicht van de Plugin SDK.

Plugin-entrypoint

Compatibiliteits- en privé-lokale helpers

Alleen de verouderde subpaden uit het latere tijdvenster blijven geëxporteerd. Aliassen uit juli 2026 en ongebruikte subpaden zijn verwijderd, terwijl helpers die uitsluitend gebundeld zijn uit het openbare pakket zijn verwijderd en hieronder als privé-lokaal zijn gemarkeerd. De onderhouden lijst is scripts/lib/plugin-sdk-deprecated-public-subpaths.json; CI weigert gebundelde plugin-sdk/text-runtime zijn uitsluitend voor compatibiliteit en plugin-sdk/zod is een compatibiliteitsherexport: importeer zod rechtstreeks uit zod. De brede domein- barrels plugin-sdk/agent-runtime, plugin-sdk/channel-lifecycle, plugin-sdk/conversation-runtime, plugin-sdk/hook-runtime, plugin-sdk/media-runtime, plugin-sdk/plugin-runtime en plugin-sdk/security-runtime zijn eveneens verouderd ten gunste van gerichte subpaden. De op Vitest gebaseerde testhelpersubpaden van OpenClaw zijn uitsluitend repository-lokaal en zijn niet langer pakketexports: agent-runtime-test-contracts, channel-contract-testing, channel-target-testing, channel-test-helpers, plugin-state-test-runtime, plugin-test-api, plugin-test-contracts, plugin-test-runtime, provider-http-test-mocks, provider-test-contracts, reply-payload-testing, sqlite-runtime-testing, test-env, test-fixtures, test-live, test-live-auth, test-media-generation, test-media-understanding, test-node-mocks en testing. De privé-oppervlakken voor gebundelde helpers ssrf-runtime-internal en codex-native-task-runtime zijn eveneens uitsluitend repository- lokaal.

Helpersubpaden voor gebundelde plugins

Helpermodules die uitsluitend gebundeld zijn, zijn na de opschoning van juli 2026 privé-lokaal. Imports tussen verschillende eigenaren worden geblokkeerd door beschermingsregels voor pakketcontracten. src/plugin-sdk/entrypoints.ts houdt afzonderlijk de ondersteunde gebundelde façades bij die openbaar blijven: SDK- entrypoints die door hun gebundelde plugin worden ondersteund totdat generieke contracten plugin-sdk/qa-runner-runtime, plugin-sdk/telegram-account vervangen, verouderd voor nieuwe code; zie de opmerkingen per rij hieronder.
Kanaalcompatibiliteitssubpaden uit het latere tijdvenster blijven alleen openbaar tot hun registerdatums. Juli-aliassen, zoals toegang tot rechtstreekse DM’s, antwoordopties, koppelings- paden en afgesplitste kanaalruntimes, zijn verwijderd; helpers die uitsluitend gebundeld zijn, zijn privé-lokaal.
Snapshots van providergebruik rapporteren normaal gesproken een of meer quota-windows, elk met een label, gebruikt percentage en optionele resetdatum. Providers die saldo- of accountstatustekst tonen in plaats van resetbare quotavensters, moeten summary retourneren met een lege windows-array in plaats van percentages te verzinnen. OpenClaw toont die samenvattingstekst in statusuitvoer; gebruik error alleen wanneer het gebruikseindpunt is mislukt of geen bruikbare gebruiksgegevens heeft geretourneerd.
Gereserveerde SDK-subpaden voor gebundelde helpers zijn gerichte, eigenaarspecifieke oppervlakken voor gebundelde plugincode. Ze worden bijgehouden in de SDK-inventaris, zodat pakket- builds en aliasing deterministisch blijven, maar het zijn geen algemene API’s voor het ontwikkelen van plugins. Nieuwe herbruikbare hostcontracten moeten algemene SDK-subpaden gebruiken, zoals plugin-sdk/gateway-runtime en plugin-sdk/ssrf-runtime.

Gerelateerd