Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Le SDK de plugin est exposé sous forme d’un ensemble de sous-chemins publics ciblés sous openclaw/plugin-sdk/. Cette page recense les sous-chemins couramment utilisés, regroupés par objectif. L’inventaire généré des points d’entrée du compilateur se trouve dans scripts/lib/plugin-sdk-entrypoints.json; les exports de paquet constituent le sous-ensemble public après soustraction des sous-chemins de test/internes propres au dépôt listés dans scripts/lib/plugin-sdk-private-local-only-subpaths.json. Les mainteneurs peuvent auditer le nombre d’exports publics avec pnpm plugin-sdk:surface et les sous-chemins d’assistants réservés actifs avec pnpm plugins:boundary-report:summary; les exports d’assistants réservés inutilisés font échouer le rapport CI au lieu de rester dans le SDK public comme dette de compatibilité dormante. Pour le guide de création de plugins, consultez Vue d’ensemble du SDK de plugin.

​
Entrée de plugin

Sous-cheminExports clés
plugin-sdk/plugin-entrydefinePluginEntry
plugin-sdk/coredefineChannelPluginEntry, createChatChannelPlugin, createChannelPluginBase, defineSetupPluginEntry, buildChannelConfigSchema, buildJsonChannelConfigSchema
plugin-sdk/config-schemaOpenClawSchema
plugin-sdk/provider-entrydefineSingleProviderPluginEntry
plugin-sdk/migrationAssistants d’éléments de fournisseur de migration tels que createMigrationItem, constantes de raison, marqueurs d’état d’élément, assistants de caviardage et summarizeMigrationItems
plugin-sdk/migration-runtimeAssistants de migration à l’exécution tels que copyMigrationFileItem, withCachedMigrationConfigRuntime et writeMigrationReport

​
Assistants de compatibilité et de test obsolètes

Ces sous-chemins restent des exports de paquet pour les anciens plugins et les suites de test OpenClaw, mais le nouveau code ne doit pas y ajouter d’imports : agent-runtime-test-contracts, channel-contract-testing, channel-target-testing, channel-test-helpers, plugin-test-api, plugin-test-contracts, provider-http-test-mocks, provider-test-contracts, test-env, test-fixtures, test-node-mocks, testing, channel-runtime, compat, config-types, infra-runtime, text-runtime et zod. Importez zod directement depuis zod dans le nouveau code de plugin. plugin-test-runtime reste un sous-chemin d’assistant de test ciblé actif.

​
Sous-chemins publics inutilisés obsolètes

Ces sous-chemins publics existent depuis au moins un mois et ne comportent actuellement aucun import de production d’extension groupée. Ils restent importables pour la compatibilité, mais le nouveau code de plugin doit plutôt utiliser des sous-chemins SDK ciblés et activement consommés : agent-config-primitives, channel-config-schema-legacy, channel-reply-pipeline, channel-runtime, channel-secret-runtime, command-auth, compat, config-runtime, config-schema, discord, group-access, infra-runtime, matrix, mattermost, media-generation-runtime-shared, memory-core-engine-runtime, memory-core-host-multimodal, memory-core-host-query, music-generation-core, self-hosted-provider-setup, telegram-account, telegram-command-config et zalouser.

​
Sous-chemins publics rares obsolètes

Les sous-chemins publics actuellement utilisés par seulement un ou deux propriétaires de plugins groupés sont également obsolètes pour le nouveau code de plugin. Ils restent des exports de paquet pour la compatibilité, mais le nouveau code doit privilégier les interfaces SDK activement partagées ou les API de paquet appartenant au plugin. Les mainteneurs suivent l’ensemble exact dans scripts/lib/plugin-sdk-deprecated-public-subpaths.json et le budget actuel avec pnpm plugin-sdk:surface.

​
Barrels larges obsolètes

Ces barrels larges de réexport restent compilables pour le code source OpenClaw et les vérifications de compatibilité, mais le nouveau code doit privilégier les sous-chemins SDK ciblés : agent-runtime, channel-lifecycle, channel-runtime, cli-runtime, compat, config-types, conversation-runtime, hook-runtime, infra-runtime, media-runtime, plugin-runtime, security-runtime et text-runtime. channel-runtime, compat, config-types, infra-runtime et text-runtime restent des exports de paquet uniquement pour la rétrocompatibilité ; utilisez plutôt les sous-chemins channel/runtime ciblés, config-contracts, string-coerce-runtime, text-chunking, text-utility-runtime et logging-core.
Sous-cheminExports clés
plugin-sdk/channel-coredefineChannelPluginEntry, defineSetupPluginEntry, createChatChannelPlugin, createChannelPluginBase
plugin-sdk/config-schemaExport du schéma Zod racine openclaw.json (OpenClawSchema)
plugin-sdk/json-schema-runtimeAssistant de validation JSON Schema mis en cache pour les schémas détenus par le plugin
plugin-sdk/channel-setupcreateOptionalChannelSetupSurface, createOptionalChannelSetupAdapter, createOptionalChannelSetupWizard, plus DEFAULT_ACCOUNT_ID, createTopLevelChannelDmPolicy, setSetupChannelEnabled, splitSetupEntries
plugin-sdk/setupAssistants partagés d’assistant de configuration, invites d’allowlist, constructeurs d’état de configuration
plugin-sdk/setup-runtimecreatePatchedAccountSetupAdapter, createEnvPatchedAccountSetupAdapter, createSetupInputPresenceValidator, noteChannelLookupFailure, noteChannelLookupSummary, promptResolvedAllowFrom, splitSetupEntries, createAllowlistSetupWizardProxy, createDelegatedSetupWizardProxy
plugin-sdk/setup-adapter-runtimeAlias de compatibilité obsolète ; utilisez plugin-sdk/setup-runtime
plugin-sdk/setup-toolsformatCliCommand, detectBinary, extractArchive, resolveBrewExecutable, formatDocsLink, CONFIG_DIR
plugin-sdk/account-coreAssistants de configuration multi-compte et de verrou d’action, assistants de repli vers le compte par défaut
plugin-sdk/account-idDEFAULT_ACCOUNT_ID, assistants de normalisation d’identifiant de compte
plugin-sdk/account-resolutionAssistants de recherche de compte et de repli par défaut
plugin-sdk/account-helpersAssistants ciblés de liste de comptes et d’action de compte
plugin-sdk/access-groupsAssistants d’analyse d’allowlist de groupes d’accès et de diagnostics de groupes expurgés
plugin-sdk/channel-pairingcreateChannelPairingController
plugin-sdk/channel-reply-pipelineAssistants hérités de pipeline de réponse. Le nouveau code de pipeline de réponse de canal doit utiliser createChannelMessageReplyPipeline et resolveChannelMessageSourceReplyDeliveryMode depuis plugin-sdk/channel-message.
plugin-sdk/channel-config-helperscreateHybridChannelConfigAdapter, resolveChannelDmAccess, resolveChannelDmAllowFrom, resolveChannelDmPolicy, normalizeChannelDmPolicy, normalizeLegacyDmAliases
plugin-sdk/channel-config-schemaPrimitives partagées de schéma de configuration de canal, plus constructeurs Zod et JSON/TypeBox directs
plugin-sdk/bundled-channel-config-schemaSchémas de configuration de canal OpenClaw groupés pour les plugins groupés maintenus uniquement
plugin-sdk/channel-config-schema-legacyAlias de compatibilité obsolète pour les schémas de configuration de canal groupés
plugin-sdk/telegram-command-configAssistants de normalisation/validation de commandes personnalisées Telegram avec repli vers le contrat groupé
plugin-sdk/command-gatingAssistants ciblés de verrou d’autorisation de commande
plugin-sdk/channel-policyresolveChannelGroupRequireMention
plugin-sdk/channel-ingressFaçade de compatibilité obsolète de bas niveau pour l’entrée de canal. Les nouveaux chemins de réception doivent utiliser plugin-sdk/channel-ingress-runtime.
plugin-sdk/channel-ingress-runtimeRésolveur expérimental de runtime d’entrée de canal de haut niveau et constructeurs de faits de route pour les chemins de réception de canal migrés. Préférez-le à l’assemblage des allowlists effectives, des allowlists de commandes et des projections héritées dans chaque plugin. Voir API d’entrée de canal.
plugin-sdk/channel-lifecyclecreateAccountStatusSink, createChannelRunQueue, et assistants hérités de cycle de vie de flux de brouillon. Le nouveau code de finalisation d’aperçu doit utiliser plugin-sdk/channel-message.
plugin-sdk/channel-messageAssistants peu coûteux de contrat de cycle de vie des messages, tels que defineChannelMessageAdapter, createChannelMessageAdapterFromOutbound, createChannelMessageReplyPipeline, createReplyPrefixContext, resolveChannelMessageSourceReplyDeliveryMode, dérivation de capacité finale durable, assistants de preuve de capacité pour les capacités d’envoi/de reçu/d’effet de bord, MessageReceiveContext, preuves de politique d’accusé de réception, defineFinalizableLivePreviewAdapter, deliverWithFinalizableLivePreviewAdapter, preuves de capacité d’aperçu en direct et de finaliseur en direct, état de récupération durable, RenderedMessageBatch, types de reçu de message et assistants d’identifiant de reçu. Voir API de message de canal. Les façades héritées de distribution des réponses sont uniquement une compatibilité obsolète.
plugin-sdk/channel-message-runtimeAssistants de livraison runtime pouvant charger la livraison sortante, notamment deliverInboundReplyWithMessageSendContext, sendDurableMessageBatch et withDurableMessageSendContext. Les ponts obsolètes de distribution des réponses restent importables uniquement pour les distributeurs de compatibilité. À utiliser depuis les modules runtime de surveillance/envoi, pas depuis les fichiers chauds d’amorçage de plugin.
plugin-sdk/inbound-envelopeAssistants partagés de route entrante et de construction d’enveloppe
plugin-sdk/inbound-reply-dispatchAssistants hérités partagés d’enregistrement et de distribution entrants, prédicats de distribution visible/finale et compatibilité obsolète deliverDurableInboundReplyPayload pour les distributeurs de canal préparés. Le nouveau code de réception/distribution de canal doit importer les assistants runtime de cycle de vie depuis plugin-sdk/channel-message-runtime.
plugin-sdk/messaging-targetsAssistants d’analyse/de correspondance de cibles
plugin-sdk/outbound-mediaAssistants partagés de chargement de médias sortants
plugin-sdk/outbound-send-depsRecherche légère de dépendances d’envoi sortant pour les adaptateurs de canal
plugin-sdk/outbound-runtimeAssistants d’identité sortante, de délégué d’envoi, de session, de formatage et de planification de charge utile. Les assistants de livraison directe tels que deliverOutboundPayloads sont un substrat de compatibilité obsolète ; utilisez plugin-sdk/channel-message-runtime pour les nouveaux chemins d’envoi.
plugin-sdk/poll-runtimeAssistants ciblés de normalisation de sondage
plugin-sdk/thread-bindings-runtimeAssistants de cycle de vie et d’adaptateur de liaison de fils
plugin-sdk/agent-media-payloadConstructeur hérité de charge utile de média d’agent
plugin-sdk/conversation-runtimeAssistants de conversation/liaison de fil, d’appairage et de liaison configurée
plugin-sdk/runtime-config-snapshotAssistant d’instantané de configuration runtime
plugin-sdk/runtime-group-policyAssistants de résolution runtime de politique de groupe
plugin-sdk/channel-statusAssistants partagés d’instantané/résumé d’état de canal
plugin-sdk/channel-config-primitivesPrimitives ciblées de schéma de configuration de canal
plugin-sdk/channel-config-writesAssistants d’autorisation d’écriture de configuration de canal
plugin-sdk/channel-plugin-commonExports partagés de préambule de plugin de canal
plugin-sdk/allowlist-config-editAssistants de modification/lecture de configuration d’allowlist
plugin-sdk/group-accessAssistants partagés de décision d’accès de groupe
plugin-sdk/direct-dmAssistants partagés d’authentification/de garde de message direct
plugin-sdk/discordFaçade de compatibilité Discord obsolète pour le @openclaw/discord@2026.3.13 publié et la compatibilité propriétaire suivie ; les nouveaux plugins doivent utiliser les sous-chemins génériques du SDK de canal
plugin-sdk/telegram-accountFaçade de compatibilité obsolète de résolution de compte Telegram pour la compatibilité propriétaire suivie ; les nouveaux plugins doivent utiliser les assistants runtime injectés ou les sous-chemins génériques du SDK de canal
plugin-sdk/zalouserFaçade de compatibilité Zalo Personal obsolète pour les paquets Lark/Zalo publiés qui importent encore l’autorisation de commande d’expéditeur ; les nouveaux plugins doivent utiliser plugin-sdk/command-auth
plugin-sdk/interactive-runtimePrésentation sémantique des messages, livraison et assistants hérités de réponse interactive. Voir Présentation des messages
plugin-sdk/channel-inboundBarrel de compatibilité pour l’anti-rebond entrant, la correspondance de mentions, les assistants de politique de mention et les assistants d’enveloppe
plugin-sdk/channel-inbound-debounceAssistants ciblés d’anti-rebond entrant
plugin-sdk/channel-mention-gatingAssistants ciblés de politique de mention, de marqueur de mention et de texte de mention sans la surface runtime entrante plus large
plugin-sdk/channel-envelopeAssistants ciblés de formatage d’enveloppe entrante
plugin-sdk/channel-locationAssistants de contexte et de formatage d’emplacement de canal
plugin-sdk/channel-loggingAssistants de journalisation de canal pour les abandons entrants et les échecs de saisie/accusé de réception
plugin-sdk/channel-send-resultTypes de résultat de réponse
plugin-sdk/channel-actionsAssistants d’action de message de canal, plus assistants de schéma natif obsolètes conservés pour la compatibilité des plugins
plugin-sdk/channel-routeAssistants partagés de normalisation de route, de résolution de cible pilotée par analyseur, de conversion d’identifiant de fil en chaîne, de clés de route de déduplication/compaction, de types de cible analysée et de comparaison route/cible
plugin-sdk/channel-targetsAssistants d’analyse de cibles ; les appelants de comparaison de routes doivent utiliser plugin-sdk/channel-route
plugin-sdk/channel-contractTypes de contrat de canal
plugin-sdk/channel-feedbackCâblage de commentaires/réactions
plugin-sdk/channel-secret-runtimeAssistants ciblés de contrat de secret, tels que collectSimpleChannelFieldAssignments, getChannelSurface, pushAssignment, et types de cible de secret
Sous-cheminExports principaux
plugin-sdk/provider-entrydefineSingleProviderPluginEntry
plugin-sdk/lmstudioFaçade de fournisseur LM Studio prise en charge pour la configuration, la découverte du catalogue et la préparation des modèles à l’exécution
plugin-sdk/lmstudio-runtimeFaçade d’exécution LM Studio prise en charge pour les valeurs par défaut du serveur local, la découverte des modèles, les en-têtes de requête et les assistants de modèles chargés
plugin-sdk/provider-setupAssistants sélectionnés de configuration de fournisseurs locaux/auto-hébergés
plugin-sdk/self-hosted-provider-setupAssistants ciblés de configuration de fournisseurs auto-hébergés compatibles OpenAI
plugin-sdk/cli-backendValeurs par défaut du backend CLI + constantes de chien de garde
plugin-sdk/provider-auth-runtimeAssistants de résolution des clés API à l’exécution pour les Plugins de fournisseur
plugin-sdk/provider-auth-api-keyAssistants d’intégration/d’écriture de profil de clé API, tels que upsertApiKeyProfile
plugin-sdk/provider-auth-resultGénérateur standard de résultat d’authentification OAuth
plugin-sdk/provider-env-varsAssistants de recherche de variables d’environnement d’authentification de fournisseur
plugin-sdk/provider-authcreateProviderApiKeyAuthMethod, ensureApiKeyFromOptionEnvOrPrompt, upsertAuthProfile, upsertApiKeyProfile, writeOAuthCredentials, export de compatibilité obsolète resolveOpenClawAgentDir
plugin-sdk/provider-model-sharedProviderReplayFamily, buildProviderReplayFamilyHooks, normalizeModelCompat, générateurs partagés de politiques de relecture, assistants de points de terminaison de fournisseur et assistants partagés de normalisation d’identifiants de modèle
plugin-sdk/provider-catalog-runtimeHook d’exécution d’augmentation du catalogue de fournisseurs et points de raccordement du registre Plugin-fournisseur pour les tests de contrat
plugin-sdk/provider-catalog-sharedfindCatalogTemplate, buildSingleProviderApiKeyCatalog, buildManifestModelProviderConfig, supportsNativeStreamingUsageCompat, applyProviderNativeStreamingUsageCompat
plugin-sdk/provider-httpAssistants génériques de capacités HTTP/points de terminaison de fournisseur, erreurs HTTP de fournisseur et assistants de formulaire multipart de transcription audio
plugin-sdk/provider-web-fetch-contractAssistants ciblés de contrat de configuration/sélection web-fetch, tels que enablePluginInConfig et WebFetchProviderPlugin
plugin-sdk/provider-web-fetchAssistants d’enregistrement/de cache de fournisseur web-fetch
plugin-sdk/provider-web-search-config-contractAssistants ciblés de configuration/d’identifiants web-search pour les fournisseurs qui n’ont pas besoin du câblage d’activation de Plugin
plugin-sdk/provider-web-search-contractAssistants ciblés de contrat de configuration/d’identifiants web-search, tels que createWebSearchProviderContractFields, enablePluginInConfig, resolveProviderWebSearchPluginConfig, et accesseurs/mutateurs d’identifiants délimités
plugin-sdk/provider-web-searchAssistants d’enregistrement/de cache/d’exécution de fournisseur web-search
plugin-sdk/provider-toolsProviderToolCompatFamily, buildProviderToolCompatFamilyHooks, et nettoyage + diagnostics de schéma Gemini
plugin-sdk/provider-usagefetchClaudeUsage et similaires
plugin-sdk/provider-streamProviderStreamFamily, buildProviderStreamFamilyHooks, composeProviderStreamWrappers, types d’enveloppes de flux, et assistants partagés d’enveloppes Anthropic/Bedrock/DeepSeek V4/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot
plugin-sdk/provider-transport-runtimeAssistants de transport natifs de fournisseur, tels que fetch protégé, transformations de messages de transport et flux d’événements de transport inscriptibles
plugin-sdk/provider-onboardAssistants de correctif de configuration d’intégration
plugin-sdk/global-singletonAssistants de singleton/map/cache locaux au processus
plugin-sdk/group-activationAssistants ciblés de mode d’activation de groupe et d’analyse de commandes
Sous-cheminExports principaux
plugin-sdk/command-authresolveControlCommandGate, assistants de registre de commandes incluant la mise en forme dynamique des menus d’arguments, assistants d’autorisation d’expéditeur
plugin-sdk/command-statusGénérateurs de messages de commande/d’aide, tels que buildCommandsMessagePaginated et buildHelpMessage
plugin-sdk/approval-auth-runtimeAssistants de résolution d’approbateur et d’authentification d’action dans la même conversation
plugin-sdk/approval-client-runtimeAssistants de profil/filtre d’approbation exec natifs
plugin-sdk/approval-delivery-runtimeAdaptateurs natifs de capacité/livraison d’approbation
plugin-sdk/approval-gateway-runtimeAssistant partagé de résolution du Gateway d’approbation
plugin-sdk/approval-handler-adapter-runtimeAssistants légers de chargement d’adaptateurs d’approbation natifs pour les points d’entrée de canaux à chaud
plugin-sdk/approval-handler-runtimeAssistants d’exécution plus larges de gestionnaire d’approbation ; préférez les points de raccordement adaptateur/Gateway plus ciblés lorsqu’ils suffisent
plugin-sdk/approval-native-runtimeAssistants natifs de cible d’approbation + liaison de compte
plugin-sdk/approval-reply-runtimeAssistants de charge utile de réponse d’approbation exec/Plugin
plugin-sdk/approval-runtimeAssistants de charge utile d’approbation exec/Plugin, assistants natifs de routage/exécution d’approbation, et assistants structurés d’affichage d’approbation, tels que formatApprovalDisplayPath
plugin-sdk/reply-dedupeAssistants ciblés de réinitialisation de déduplication des réponses entrantes
plugin-sdk/channel-contract-testingAssistants ciblés de test de contrat de canal sans le barrel de test large
plugin-sdk/command-auth-nativeAuthentification de commande native, mise en forme dynamique des menus d’arguments et assistants natifs de cible de session
plugin-sdk/command-detectionAssistants partagés de détection de commandes
plugin-sdk/command-primitives-runtimePrédicats légers de texte de commande pour les chemins de canaux à chaud
plugin-sdk/command-surfaceNormalisation du corps de commande et assistants de surface de commande
plugin-sdk/allow-fromformatAllowFromLowercase
plugin-sdk/channel-secret-runtimeAssistants ciblés de collecte de contrats de secrets pour les surfaces de secrets de canal/Plugin
plugin-sdk/secret-ref-runtimeAssistants ciblés de typage coerceSecretRef et SecretRef pour l’analyse de contrats/configurations de secrets
plugin-sdk/security-runtimeAssistants partagés de confiance, de filtrage des messages privés, de fichiers/chemins bornés à la racine incluant les écritures uniquement en création, le remplacement atomique de fichiers synchrone/asynchrone, les écritures temporaires voisines, le repli de déplacement entre périphériques, les assistants de stockage privé de fichiers, les gardes de parents de liens symboliques, le contenu externe, la rédaction de texte sensible, la comparaison de secrets en temps constant et les assistants de collecte de secrets
plugin-sdk/ssrf-policyAssistants de liste d’hôtes autorisés et de politique SSRF de réseau privé
plugin-sdk/ssrf-dispatcherAssistants ciblés de dispatcher épinglé sans la large surface d’exécution d’infrastructure
plugin-sdk/ssrf-runtimeDispatcher épinglé, fetch protégé contre la SSRF, erreur SSRF et assistants de politique SSRF
plugin-sdk/secret-inputAssistants d’analyse d’entrée de secret
plugin-sdk/webhook-ingressAssistants de requête/cible Webhook et coercition brute de websocket/corps
plugin-sdk/webhook-request-guardsAssistants de taille/délai d’expiration du corps de requête
Sous-cheminExportations clés
plugin-sdk/runtimeAssistants généraux d’exécution, de journalisation, de sauvegarde et d’installation de plugins
plugin-sdk/runtime-envAssistants ciblés pour l’environnement d’exécution, le logger, les délais d’expiration, les nouvelles tentatives et le backoff
plugin-sdk/browser-configFaçade de configuration de navigateur prise en charge pour les profils/valeurs par défaut normalisés, l’analyse d’URL CDP et les assistants d’authentification de contrôle du navigateur
plugin-sdk/channel-runtime-contextAssistants génériques d’enregistrement et de recherche du contexte d’exécution des canaux
plugin-sdk/matrixFaçade de compatibilité Matrix obsolète pour les anciens packages de canaux tiers ; les nouveaux plugins doivent importer directement plugin-sdk/run-command
plugin-sdk/mattermostFaçade de compatibilité Mattermost obsolète pour les anciens packages de canaux tiers ; les nouveaux plugins doivent importer directement les sous-chemins génériques du SDK
plugin-sdk/runtime-storecreatePluginRuntimeStore
plugin-sdk/plugin-runtimeAssistants partagés de commandes, hooks, HTTP et interactions de plugin
plugin-sdk/hook-runtimeAssistants partagés de pipeline de Webhook/hook interne
plugin-sdk/lazy-runtimeAssistants d’importation et de liaison paresseuses de runtime, tels que createLazyRuntimeModule, createLazyRuntimeMethod et createLazyRuntimeSurface
plugin-sdk/process-runtimeAssistants d’exécution de processus
plugin-sdk/cli-runtimeAssistants CLI de formatage, d’attente, de version, d’invocation d’arguments et de groupes de commandes paresseux
plugin-sdk/gateway-runtimeClient Gateway, assistant de démarrage de client prêt pour la boucle d’événements, RPC CLI du Gateway, erreurs du protocole Gateway et assistants de correctifs d’état des canaux
plugin-sdk/config-contractsSurface de configuration ciblée, uniquement typée, pour les formes de configuration de plugin telles que OpenClawConfig et les types de configuration de canal/fournisseur
plugin-sdk/plugin-config-runtimeAssistants d’exécution de recherche de configuration de plugin, tels que requireRuntimeConfig, resolvePluginConfigObject et resolveLivePluginConfigObject
plugin-sdk/config-mutationAssistants de mutation transactionnelle de configuration, tels que mutateConfigFile, replaceConfigFile et logConfigUpdated
plugin-sdk/runtime-config-snapshotAssistants d’instantané de configuration du processus courant, tels que getRuntimeConfig, getRuntimeConfigSnapshot, et mutateurs d’instantané de test
plugin-sdk/telegram-command-configNormalisation des noms/descriptions de commandes Telegram et vérifications de doublons/conflits, même lorsque la surface de contrat Telegram intégrée n’est pas disponible
plugin-sdk/text-autolink-runtimeDétection d’autoliens de références de fichiers sans le barrel texte général
plugin-sdk/approval-runtimeAssistants d’approbation d’exécution/de plugin, constructeurs de capacités d’approbation, assistants d’authentification/profil, assistants de routage/runtime natifs et formatage structuré du chemin d’affichage d’approbation
plugin-sdk/reply-runtimeAssistants partagés d’exécution entrant/réponse, découpage, dispatch, Heartbeat, planificateur de réponses
plugin-sdk/reply-dispatch-runtimeAssistants ciblés de dispatch/finalisation de réponse et de libellés de conversation
plugin-sdk/reply-historyAssistants et marqueurs partagés d’historique de réponses à fenêtre courte, tels que buildHistoryContext, HISTORY_CONTEXT_MARKER, recordPendingHistoryEntry et clearHistoryEntriesIfEnabled
plugin-sdk/reply-referencecreateReplyReferencePlanner
plugin-sdk/reply-chunkingAssistants ciblés de découpage de texte/Markdown
plugin-sdk/session-store-runtimeAssistants de chemin de magasin de sessions, clé de session, date de mise à jour et mutation de magasin
plugin-sdk/cron-store-runtimeAssistants de chemin/chargement/enregistrement du magasin Cron
plugin-sdk/state-pathsAssistants de chemins de répertoires d’état/OAuth
plugin-sdk/routingAssistants de liaison route/clé de session/compte, tels que resolveAgentRoute, buildAgentSessionKey et resolveDefaultAgentBoundAccountId
plugin-sdk/status-helpersAssistants partagés de résumé d’état de canal/compte, valeurs par défaut d’état runtime et assistants de métadonnées de problème
plugin-sdk/target-resolver-runtimeAssistants partagés de résolution de cible
plugin-sdk/string-normalization-runtimeAssistants de normalisation de slugs/chaînes
plugin-sdk/request-urlExtraire les URL sous forme de chaînes depuis des entrées de type fetch/request
plugin-sdk/run-commandExécuteur de commandes temporisé avec résultats stdout/stderr normalisés
plugin-sdk/param-readersLecteurs de paramètres communs pour outils/CLI
plugin-sdk/tool-payloadExtraire des charges utiles normalisées depuis des objets de résultats d’outils
plugin-sdk/tool-sendExtraire les champs canoniques de cible d’envoi depuis les arguments d’outil
plugin-sdk/temp-pathAssistants partagés de chemins de téléchargement temporaire et espaces de travail temporaires privés sécurisés
plugin-sdk/logging-coreAssistants de logger de sous-système et de caviardage
plugin-sdk/markdown-table-runtimeAssistants de mode et de conversion de tableaux Markdown
plugin-sdk/model-session-runtimeAssistants de remplacement de modèle/session, tels que applyModelOverrideToSessionEntry et resolveAgentMaxConcurrent
plugin-sdk/talk-config-runtimeAssistants de résolution de configuration de fournisseur Talk
plugin-sdk/json-storePetits assistants de lecture/écriture d’état JSON
plugin-sdk/file-lockAssistants de verrouillage de fichiers réentrant
plugin-sdk/persistent-dedupeAssistants de cache de déduplication adossé au disque
plugin-sdk/acp-runtimeAssistants ACP de runtime/session et de dispatch de réponses
plugin-sdk/acp-runtime-backendAssistants légers d’enregistrement de backend ACP et de dispatch de réponses pour les plugins chargés au démarrage
plugin-sdk/acp-binding-resolve-runtimeRésolution en lecture seule des liaisons ACP sans importations de démarrage du cycle de vie
plugin-sdk/agent-config-primitivesPrimitives ciblées de schéma de configuration runtime d’agent
plugin-sdk/boolean-paramLecteur souple de paramètre booléen
plugin-sdk/dangerous-name-runtimeAssistants de résolution de correspondance de noms dangereux
plugin-sdk/device-bootstrapAssistants d’amorçage d’appareil et de jetons d’association
plugin-sdk/extension-sharedPrimitives partagées de canal passif, d’état et d’assistant de proxy ambiant
plugin-sdk/models-provider-runtimeAssistants de réponse pour la commande/le fournisseur /models
plugin-sdk/skill-commands-runtimeAssistants de liste de commandes de Skills
plugin-sdk/native-command-registryAssistants de registre/construction/sérialisation de commandes natives
plugin-sdk/agent-harnessSurface expérimentale de plugin de confiance pour les harnais d’agents de bas niveau : types de harnais, assistants de pilotage/abandon d’exécution active, assistants de pont d’outils OpenClaw, assistants de politique d’outils de plan runtime, classification des résultats de terminal, assistants de formatage/détail de progression d’outils et utilitaires de résultat de tentative
plugin-sdk/provider-zai-endpointFaçade obsolète de détection de point de terminaison appartenant au fournisseur Z.AI ; utilisez l’API publique du plugin Z.AI
plugin-sdk/async-lock-runtimeAssistant de verrou asynchrone local au processus pour les petits fichiers d’état runtime
plugin-sdk/channel-activity-runtimeAssistant de télémétrie d’activité de canal
plugin-sdk/concurrency-runtimeAssistant de concurrence bornée de tâches asynchrones
plugin-sdk/dedupe-runtimeAssistants de cache de déduplication en mémoire
plugin-sdk/delivery-queue-runtimeAssistant de drainage des livraisons sortantes en attente
plugin-sdk/file-access-runtimeAssistants de chemins sécurisés pour fichiers locaux et sources multimédias
plugin-sdk/heartbeat-runtimeAssistants de réveil, d’événement et de visibilité Heartbeat
plugin-sdk/number-runtimeAssistant de coercition numérique
plugin-sdk/secure-random-runtimeAssistants de jetons/UUID sécurisés
plugin-sdk/system-event-runtimeAssistants de file d’événements système
plugin-sdk/transport-ready-runtimeAssistant d’attente de disponibilité du transport
plugin-sdk/infra-runtimeShim de compatibilité obsolète ; utilisez les sous-chemins runtime ciblés ci-dessus
plugin-sdk/collection-runtimePetits assistants de cache borné
plugin-sdk/diagnostic-runtimeAssistants d’indicateur de diagnostic, d’événement et de contexte de trace
plugin-sdk/error-runtimeAssistants de graphe d’erreurs, de formatage et de classification d’erreurs partagée, isApprovalNotFoundError
plugin-sdk/fetch-runtimeFetch enveloppé, proxy, option EnvHttpProxyAgent et assistants de lookup épinglé
plugin-sdk/runtime-fetchFetch runtime compatible dispatcher sans importations de proxy/guarded-fetch
plugin-sdk/response-limit-runtimeLecteur borné de corps de réponse sans la surface runtime multimédia générale
plugin-sdk/session-binding-runtimeÉtat de liaison de la conversation courante sans routage de liaison configuré ni magasins d’association
plugin-sdk/session-store-runtimeAssistants de magasin de sessions sans importations générales d’écriture/maintenance de configuration
plugin-sdk/context-visibility-runtimeRésolution de visibilité du contexte et filtrage de contexte supplémentaire sans importations générales de configuration/sécurité
plugin-sdk/string-coerce-runtimeAssistants ciblés de coercition et de normalisation de chaînes/enregistrements primitifs sans importations Markdown/journalisation
plugin-sdk/host-runtimeAssistants de normalisation de noms d’hôte et d’hôtes SCP
plugin-sdk/retry-runtimeAssistants de configuration de nouvelles tentatives et d’exécuteur de nouvelles tentatives
plugin-sdk/agent-runtimeAssistants de répertoire/identité/espace de travail d’agent, notamment resolveAgentDir, resolveDefaultAgentDir et l’export de compatibilité obsolète resolveOpenClawAgentDir
plugin-sdk/directory-runtimeRequête/déduplication de répertoires adossée à la configuration
plugin-sdk/keyed-async-queueKeyedAsyncQueue
Sous-cheminExports clés
plugin-sdk/media-runtimeAssistants partagés de récupération/transformation/stockage de médias, détection des dimensions vidéo basée sur ffprobe, et générateurs de charges utiles média
plugin-sdk/media-mimeNormalisation MIME ciblée, mappage des extensions de fichier, détection MIME, et assistants de type de média
plugin-sdk/media-storeAssistants ciblés de magasin de médias tels que saveMediaBuffer
plugin-sdk/media-generation-runtimeAssistants partagés de basculement de génération de médias, sélection de candidats, et messages de modèle manquant
plugin-sdk/media-understandingTypes de fournisseurs de compréhension des médias, plus exports d’assistants image/audio/extraction structurée destinés aux fournisseurs
plugin-sdk/text-chunkingAssistants de découpage/rendu de texte et de markdown, conversion de tableaux markdown, suppression de balises de directives, et utilitaires de texte sûr
plugin-sdk/text-chunkingAssistant de découpage du texte sortant
plugin-sdk/speechTypes de fournisseurs vocaux, plus exports de directives, registre, validation, générateur TTS compatible OpenAI, et assistants vocaux destinés aux fournisseurs
plugin-sdk/speech-coreTypes partagés de fournisseurs vocaux, registre, directive, normalisation, et exports d’assistants vocaux
plugin-sdk/realtime-transcriptionTypes de fournisseurs de transcription en temps réel, assistants de registre, et assistant partagé de session WebSocket
plugin-sdk/realtime-voiceTypes de fournisseurs de voix en temps réel et assistants de registre
plugin-sdk/image-generationTypes de fournisseurs de génération d’images, plus assistants d’assets d’image/d’URL de données et générateur de fournisseur d’images compatible OpenAI
plugin-sdk/image-generation-coreTypes partagés de génération d’images, basculement, authentification, et assistants de registre
plugin-sdk/music-generationTypes de fournisseurs/requêtes/résultats de génération de musique
plugin-sdk/music-generation-coreTypes partagés de génération de musique, assistants de basculement, recherche de fournisseur, et analyse de références de modèle
plugin-sdk/video-generationTypes de fournisseurs/requêtes/résultats de génération de vidéos
plugin-sdk/video-generation-coreTypes partagés de génération de vidéos, assistants de basculement, recherche de fournisseur, et analyse de références de modèle
plugin-sdk/webhook-targetsRegistre des cibles Webhook et assistants d’installation de routes
plugin-sdk/webhook-pathAlias de compatibilité obsolète ; utilisez plugin-sdk/webhook-ingress
plugin-sdk/web-mediaAssistants partagés de chargement de médias distants/locaux
plugin-sdk/zodRéexport de compatibilité obsolète ; importez zod depuis zod directement
plugin-sdk/testingBarrel de compatibilité obsolète propre au dépôt pour les anciens tests OpenClaw. Les nouveaux tests du dépôt doivent plutôt importer des sous-chemins de test locaux ciblés tels que plugin-sdk/agent-runtime-test-contracts, plugin-sdk/plugin-test-runtime, plugin-sdk/channel-test-helpers, plugin-sdk/test-env, ou plugin-sdk/test-fixtures
plugin-sdk/plugin-test-apiAssistant minimal createTestPluginApi propre au dépôt pour les tests unitaires d’enregistrement direct de plugins sans importer les passerelles d’assistants de test du dépôt
plugin-sdk/agent-runtime-test-contractsFixtures de contrat d’adaptateur agent-runtime natif propres au dépôt pour les tests d’authentification, livraison, repli, hooks d’outils, superposition de prompt, schéma, et projection de transcription
plugin-sdk/channel-test-helpersAssistants de test orientés canal propres au dépôt pour les contrats génériques d’actions/configuration/état, assertions de répertoires, cycle de vie de démarrage de compte, threading de configuration d’envoi, mocks runtime, problèmes d’état, livraison sortante, et enregistrement de hooks
plugin-sdk/channel-target-testingSuite partagée propre au dépôt de cas d’erreur de résolution de cible pour les tests de canal
plugin-sdk/plugin-test-contractsAssistants de contrats propres au dépôt pour package de plugin, enregistrement, artefact public, import direct, API runtime, et effets de bord d’import
plugin-sdk/provider-test-contractsAssistants de contrats propres au dépôt pour runtime de fournisseur, authentification, découverte, onboarding, catalogue, assistant de configuration, capacité média, politique de replay, audio live STT en temps réel, recherche/récupération web, et flux
plugin-sdk/provider-http-test-mocksMocks HTTP/auth Vitest opt-in propres au dépôt pour les tests de fournisseurs qui exercent plugin-sdk/provider-http
plugin-sdk/test-fixturesFixtures génériques propres au dépôt pour capture de runtime CLI, contexte de sandbox, rédacteur de skill, message d’agent, événement système, rechargement de module, chemin de plugin groupé, texte de terminal, découpage, jeton d’authentification, et cas typé
plugin-sdk/test-node-mocksAssistants de mocks ciblés des builtins Node propres au dépôt à utiliser dans les fabriques Vitest vi.mock("node:*")
Sous-cheminExports clés
plugin-sdk/memory-coreSurface d’assistants memory-core groupée pour les assistants de gestionnaire/configuration/fichier/CLI
plugin-sdk/memory-core-engine-runtimeFaçade runtime d’indexation/recherche mémoire
plugin-sdk/memory-core-host-engine-foundationExports du moteur de fondation de l’hôte mémoire
plugin-sdk/memory-core-host-engine-embeddingsContrats d’embeddings de l’hôte mémoire, accès au registre, fournisseur local, et assistants génériques de lots/distants
plugin-sdk/memory-core-host-engine-qmdExports du moteur QMD de l’hôte mémoire
plugin-sdk/memory-core-host-engine-storageExports du moteur de stockage de l’hôte mémoire
plugin-sdk/memory-core-host-multimodalAssistants multimodaux de l’hôte mémoire
plugin-sdk/memory-core-host-queryAssistants de requête de l’hôte mémoire
plugin-sdk/memory-core-host-secretAssistants de secrets de l’hôte mémoire
plugin-sdk/memory-core-host-eventsAlias de compatibilité obsolète ; utilisez plugin-sdk/memory-host-events
plugin-sdk/memory-core-host-statusAssistants d’état de l’hôte mémoire
plugin-sdk/memory-core-host-runtime-cliAssistants runtime CLI de l’hôte mémoire
plugin-sdk/memory-core-host-runtime-coreAssistants runtime de cœur de l’hôte mémoire
plugin-sdk/memory-core-host-runtime-filesAssistants fichier/runtime de l’hôte mémoire
plugin-sdk/memory-host-coreAlias neutre vis-à-vis des fournisseurs pour les assistants runtime de cœur de l’hôte mémoire
plugin-sdk/memory-host-eventsAlias neutre vis-à-vis des fournisseurs pour les assistants de journal d’événements de l’hôte mémoire
plugin-sdk/memory-host-filesAlias de compatibilité obsolète ; utilisez plugin-sdk/memory-core-host-runtime-files
plugin-sdk/memory-host-markdownAssistants partagés de markdown géré pour les plugins adjacents à la mémoire
plugin-sdk/memory-host-searchFaçade runtime de mémoire active pour l’accès au gestionnaire de recherche
plugin-sdk/memory-host-statusAlias de compatibilité obsolète ; utilisez plugin-sdk/memory-core-host-status
Il n’existe actuellement aucun sous-chemin SDK réservé aux assistants groupés. Les assistants propres à un propriétaire vivent dans le package de plugin propriétaire, tandis que les contrats d’hôte réutilisables utilisent des sous-chemins SDK génériques tels que plugin-sdk/gateway-runtime, plugin-sdk/security-runtime, et plugin-sdk/plugin-config-runtime.

​
Associés