Ana içeriğe atla

​
Plugin SDK Geçişi

OpenClaw, geniş bir geriye dönük uyumluluk katmanından odaklı, belgelenmiş import’lara sahip modern bir plugin mimarisine geçti. Eklentiniz yeni mimariden önce oluşturulduysa, bu kılavuz geçiş yapmanıza yardımcı olur.

​
Neler değişiyor

Eski plugin sistemi, eklentilerin tek bir giriş noktasından ihtiyaç duydukları her şeyi içe aktarmasına izin veren iki geniş yüzey sağlıyordu:
  • openclaw/plugin-sdk/compat — onlarca yardımcıyı yeniden dışa aktaran tek bir import. Yeni plugin mimarisi oluşturulurken eski hook tabanlı eklentilerin çalışmaya devam etmesi için sunulmuştu.
  • openclaw/extension-api — eklentilere gömülü ajan çalıştırıcısı gibi host tarafı yardımcılarına doğrudan erişim veren bir köprü.
Her iki yüzey de artık deprecated durumdadır. Çalışma zamanında hâlâ çalışırlar, ancak yeni eklentiler bunları kullanmamalıdır ve mevcut eklentiler bir sonraki büyük sürüm bunları kaldırmadan önce geçiş yapmalıdır.
Geriye dönük uyumluluk katmanı gelecekteki büyük bir sürümde kaldırılacaktır. Hâlâ bu yüzeylerden import yapan eklentiler bu gerçekleştiğinde bozulacaktır.

​
Bu neden değişti

Eski yaklaşım sorunlara yol açıyordu:
  • Yavaş başlangıç — tek bir yardımcıyı içe aktarmak onlarca alakasız modülü yüklüyordu
  • Döngüsel bağımlılıklar — geniş yeniden dışa aktarmalar import döngüleri oluşturmayı kolaylaştırıyordu
  • Belirsiz API yüzeyi — hangi dışa aktarımların kararlı, hangilerinin dahili olduğunu anlamanın bir yolu yoktu
Modern plugin SDK bunu düzeltir: her import yolu (openclaw/plugin-sdk/\<subpath\>) net bir amaca ve belgelenmiş sözleşmeye sahip küçük, kendi kendine yeterli bir modüldür. Paketle gelen kanallar için eski sağlayıcı kolaylık yüzeyleri de artık yok. openclaw/plugin-sdk/slack, openclaw/plugin-sdk/discord, openclaw/plugin-sdk/signal, openclaw/plugin-sdk/whatsapp, kanal markalı yardımcı yüzeyleri ve openclaw/plugin-sdk/telegram-core gibi import’lar, kararlı plugin sözleşmeleri değil, özel mono-repo kısayollarıydı. Bunun yerine dar ve genel SDK alt yollarını kullanın. Paketli plugin çalışma alanı içinde, sağlayıcıya ait yardımcıları ilgili pluginin kendi api.ts veya runtime-api.ts dosyasında tutun. Mevcut paketli sağlayıcı örnekleri:
  • Anthropic, Claude’a özgü akış yardımcılarını kendi api.ts / contract-api.ts yüzeyinde tutar
  • OpenAI, sağlayıcı oluşturucularını, varsayılan model yardımcılarını ve gerçek zamanlı sağlayıcı oluşturucularını kendi api.ts dosyasında tutar
  • OpenRouter, sağlayıcı oluşturucu ile onboarding/config yardımcılarını kendi api.ts dosyasında tutar

​
Nasıl geçiş yapılır

1

Windows sarmalayıcı geri dönüş davranışını denetleyin

Eklentiniz openclaw/plugin-sdk/windows-spawn kullanıyorsa, çözümlenemeyen Windows .cmd/.bat sarmalayıcıları artık açıkça allowShellFallback: true geçmediğiniz sürece güvenli şekilde başarısız olur.
// Önce
const program = applyWindowsSpawnProgramPolicy({ candidate });

// Sonra
const program = applyWindowsSpawnProgramPolicy({
  candidate,
  // Bunu yalnızca shell aracılı geri dönüşü bilerek kabul eden
  // güvenilir uyumluluk çağıranları için ayarlayın.
  allowShellFallback: true,
});
Çağıranınız bilinçli olarak shell geri dönüşüne dayanmıyorsa, allowShellFallback ayarlamayın ve bunun yerine fırlatılan hatayı yönetin.
2

Deprecated import'ları bulun

Eklentinizde deprecated iki yüzeyden herhangi birinden yapılan import’ları arayın:
grep -r "plugin-sdk/compat" my-plugin/
grep -r "openclaw/extension-api" my-plugin/
3

Odaklı import'larla değiştirin

Eski yüzeydeki her dışa aktarma, belirli bir modern import yoluna eşlenir:
// Önce (deprecated geriye dönük uyumluluk katmanı)
import {
  createChannelReplyPipeline,
  createPluginRuntimeStore,
  resolveControlCommandGate,
} from "openclaw/plugin-sdk/compat";

// Sonra (modern odaklı import'lar)
import { createChannelReplyPipeline } from "openclaw/plugin-sdk/channel-reply-pipeline";
import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
import { resolveControlCommandGate } from "openclaw/plugin-sdk/command-auth";
Host tarafı yardımcılar için, doğrudan import yapmak yerine enjekte edilen plugin çalışma zamanını kullanın:
// Önce (deprecated extension-api köprüsü)
import { runEmbeddedPiAgent } from "openclaw/extension-api";
const result = await runEmbeddedPiAgent({ sessionId, prompt });

// Sonra (enjekte edilen çalışma zamanı)
const result = await api.runtime.agent.runEmbeddedPiAgent({ sessionId, prompt });
Aynı desen diğer eski köprü yardımcıları için de geçerlidir:
Eski importModern karşılığı
resolveAgentDirapi.runtime.agent.resolveAgentDir
resolveAgentWorkspaceDirapi.runtime.agent.resolveAgentWorkspaceDir
resolveAgentIdentityapi.runtime.agent.resolveAgentIdentity
resolveThinkingDefaultapi.runtime.agent.resolveThinkingDefault
resolveAgentTimeoutMsapi.runtime.agent.resolveAgentTimeoutMs
ensureAgentWorkspaceapi.runtime.agent.ensureAgentWorkspace
session store helpersapi.runtime.agent.session.*
4

Derleyin ve test edin

pnpm build
pnpm test -- my-plugin/

​
Import yolu başvurusu

Import yoluAmaçTemel dışa aktarımlar
plugin-sdk/plugin-entryKanonik plugin giriş yardımcısıdefinePluginEntry
plugin-sdk/coreKanal giriş tanımları/oluşturucuları için eski şemsiye yeniden dışa aktarmadefineChannelPluginEntry, createChatChannelPlugin
plugin-sdk/config-schemaKök config şeması dışa aktarımıOpenClawSchema
plugin-sdk/provider-entryTek sağlayıcılı giriş yardımcısıdefineSingleProviderPluginEntry
plugin-sdk/channel-coreOdaklı kanal giriş tanımları ve oluşturucularıdefineChannelPluginEntry, defineSetupPluginEntry, createChatChannelPlugin, createChannelPluginBase
plugin-sdk/setupPaylaşılan kurulum sihirbazı yardımcılarıAllowlist istemleri, kurulum durumu oluşturucuları
plugin-sdk/setup-runtimeKurulum zamanı çalışma zamanı yardımcılarıImport için güvenli kurulum yama bağdaştırıcıları, lookup-note yardımcıları, promptResolvedAllowFrom, splitSetupEntries, devredilmiş kurulum proxy’leri
plugin-sdk/setup-adapter-runtimeKurulum bağdaştırıcı yardımcılarıcreateEnvPatchedAccountSetupAdapter
plugin-sdk/setup-toolsKurulum araç yardımcılarıformatCliCommand, detectBinary, extractArchive, resolveBrewExecutable, formatDocsLink, CONFIG_DIR
plugin-sdk/account-coreÇoklu hesap yardımcılarıHesap listesi/config/işlem geçidi yardımcıları
plugin-sdk/account-idHesap kimliği yardımcılarıDEFAULT_ACCOUNT_ID, hesap kimliği normalleştirme
plugin-sdk/account-resolutionHesap arama yardımcılarıHesap arama + varsayılan geri dönüş yardımcıları
plugin-sdk/account-helpersDar hesap yardımcılarıHesap listesi/hesap işlemi yardımcıları
plugin-sdk/channel-setupKurulum sihirbazı bağdaştırıcılarıcreateOptionalChannelSetupSurface, createOptionalChannelSetupAdapter, createOptionalChannelSetupWizard, ayrıca DEFAULT_ACCOUNT_ID, createTopLevelChannelDmPolicy, setSetupChannelEnabled, splitSetupEntries
plugin-sdk/channel-pairingDM eşleştirme ilkel bileşenlericreateChannelPairingController
plugin-sdk/channel-reply-pipelineYanıt öneki + yazıyor entegrasyonucreateChannelReplyPipeline
plugin-sdk/channel-config-helpersConfig bağdaştırıcı fabrikalarıcreateHybridChannelConfigAdapter
plugin-sdk/channel-config-schemaConfig şeması oluşturucularıKanal config şeması türleri
plugin-sdk/telegram-command-configTelegram komut config yardımcılarıKomut adı normalleştirme, açıklama kırpma, yinelenen/çakışma doğrulaması
plugin-sdk/channel-policyGrup/DM ilkesi çözümlemeresolveChannelGroupRequireMention
plugin-sdk/channel-lifecycleHesap durumu takibicreateAccountStatusSink
plugin-sdk/inbound-envelopeGelen zarf yardımcılarıPaylaşılan rota + zarf oluşturucu yardımcıları
plugin-sdk/inbound-reply-dispatchGelen yanıt yardımcılarıPaylaşılan kaydetme ve dispatch yardımcıları
plugin-sdk/messaging-targetsMesaj hedefi ayrıştırmaHedef ayrıştırma/eşleme yardımcıları
plugin-sdk/outbound-mediaGiden medya yardımcılarıPaylaşılan giden medya yükleme
plugin-sdk/outbound-runtimeGiden çalışma zamanı yardımcılarıGiden kimlik/gönderim temsilci yardımcıları
plugin-sdk/thread-bindings-runtimeThread-binding yardımcılarıThread-binding yaşam döngüsü ve bağdaştırıcı yardımcıları
plugin-sdk/agent-media-payloadEski medya payload yardımcılarıEski alan düzenleri için ajan medya payload oluşturucusu
plugin-sdk/channel-runtimeDeprecated uyumluluk shim’iYalnızca eski kanal çalışma zamanı araçları
plugin-sdk/channel-send-resultGönderim sonucu türleriYanıt sonuç türleri
plugin-sdk/runtime-storeKalıcı plugin depolamasıcreatePluginRuntimeStore
plugin-sdk/runtimeGeniş çalışma zamanı yardımcılarıÇalışma zamanı/günlükleme/yedekleme/plugin kurulum yardımcıları
plugin-sdk/runtime-envDar çalışma zamanı ortam yardımcılarıLogger/çalışma zamanı ortamı, zaman aşımı, retry ve backoff yardımcıları
plugin-sdk/plugin-runtimePaylaşılan plugin çalışma zamanı yardımcılarıPlugin komutları/hook’lar/http/etkileşimli yardımcılar
plugin-sdk/hook-runtimeHook hattı yardımcılarıPaylaşılan webhook/dahili hook hattı yardımcıları
plugin-sdk/lazy-runtimeLazy çalışma zamanı yardımcılarıcreateLazyRuntimeModule, createLazyRuntimeMethod, createLazyRuntimeMethodBinder, createLazyRuntimeNamedExport, createLazyRuntimeSurface
plugin-sdk/process-runtimeSüreç yardımcılarıPaylaşılan exec yardımcıları
plugin-sdk/cli-runtimeCLI çalışma zamanı yardımcılarıKomut biçimlendirme, bekleme, sürüm yardımcıları
plugin-sdk/gateway-runtimeGateway yardımcılarıGateway istemcisi ve kanal durumu yama yardımcıları
plugin-sdk/config-runtimeConfig yardımcılarıConfig yükleme/yazma yardımcıları
plugin-sdk/telegram-command-configTelegram komut yardımcılarıPaketli Telegram sözleşme yüzeyi kullanılamadığında geri dönüş için kararlı Telegram komut doğrulama yardımcıları
plugin-sdk/approval-runtimeOnay istemi yardımcılarıExec/plugin onay payload’ı, onay yeteneği/profili yardımcıları, yerel onay yönlendirme/çalışma zamanı yardımcıları
plugin-sdk/approval-auth-runtimeOnay kimlik doğrulama yardımcılarıOnaylayan çözümleme, aynı sohbette işlem kimlik doğrulaması
plugin-sdk/approval-client-runtimeOnay istemci yardımcılarıYerel exec onay profili/filtre yardımcıları
plugin-sdk/approval-delivery-runtimeOnay teslim yardımcılarıYerel onay yeteneği/teslim bağdaştırıcıları
plugin-sdk/approval-native-runtimeOnay hedef yardımcılarıYerel onay hedefi/hesap bağlama yardımcıları
plugin-sdk/approval-reply-runtimeOnay yanıt yardımcılarıExec/plugin onay yanıt payload yardımcıları
plugin-sdk/security-runtimeGüvenlik yardımcılarıPaylaşılan güven, DM geçitleme, harici içerik ve secret collection yardımcıları
plugin-sdk/ssrf-policySSRF ilkesi yardımcılarıHost allowlist ve özel ağ ilkesi yardımcıları
plugin-sdk/ssrf-runtimeSSRF çalışma zamanı yardımcılarıPinned-dispatcher, guarded fetch, SSRF ilkesi yardımcıları
plugin-sdk/collection-runtimeSınırlı önbellek yardımcılarıpruneMapToMaxSize
plugin-sdk/diagnostic-runtimeTanılama geçidi yardımcılarıisDiagnosticFlagEnabled, isDiagnosticsEnabled
plugin-sdk/error-runtimeHata biçimlendirme yardımcılarıformatUncaughtError, isApprovalNotFoundError, hata grafiği yardımcıları
plugin-sdk/fetch-runtimeSarmalanmış fetch/proxy yardımcılarıresolveFetch, proxy yardımcıları
plugin-sdk/host-runtimeHost normalleştirme yardımcılarınormalizeHostname, normalizeScpRemoteHost
plugin-sdk/retry-runtimeRetry yardımcılarıRetryConfig, retryAsync, ilke çalıştırıcıları
plugin-sdk/allow-fromAllowlist biçimlendirmeformatAllowFromLowercase
plugin-sdk/allowlist-resolutionAllowlist girdi eşlememapAllowlistResolutionInputs
plugin-sdk/command-authKomut geçitleme ve komut yüzeyi yardımcılarıresolveControlCommandGate, gönderici yetkilendirme yardımcıları, komut kayıt yardımcıları
plugin-sdk/secret-inputSecret girdi ayrıştırmaSecret girdi yardımcıları
plugin-sdk/webhook-ingressWebhook istek yardımcılarıWebhook hedef araçları
plugin-sdk/webhook-request-guardsWebhook gövdesi koruma yardımcılarıİstek gövdesi okuma/sınırlama yardımcıları
plugin-sdk/reply-runtimePaylaşılan yanıt çalışma zamanıGelen dispatch, heartbeat, yanıt planlayıcı, parçalama
plugin-sdk/reply-dispatch-runtimeDar yanıt dispatch yardımcılarıSonlandırma + sağlayıcı dispatch yardımcıları
plugin-sdk/reply-historyYanıt geçmişi yardımcılarıbuildHistoryContext, buildPendingHistoryContextFromMap, recordPendingHistoryEntry, clearHistoryEntriesIfEnabled
plugin-sdk/reply-referenceYanıt referansı planlamacreateReplyReferencePlanner
plugin-sdk/reply-chunkingYanıt parça yardımcılarıMetin/markdown parçalama yardımcıları
plugin-sdk/session-store-runtimeSession store yardımcılarıDepo yolu + updated-at yardımcıları
plugin-sdk/state-pathsDurum yolu yardımcılarıDurum ve OAuth dizin yardımcıları
plugin-sdk/routingYönlendirme/session-key yardımcılarıresolveAgentRoute, buildAgentSessionKey, resolveDefaultAgentBoundAccountId, session-key normalleştirme yardımcıları
plugin-sdk/status-helpersKanal durumu yardımcılarıKanal/hesap durumu özet oluşturucuları, çalışma zamanı durumu varsayılanları, issue meta veri yardımcıları
plugin-sdk/target-resolver-runtimeHedef çözümleyici yardımcılarıPaylaşılan hedef çözümleyici yardımcıları
plugin-sdk/string-normalization-runtimeDize normalleştirme yardımcılarıSlug/dize normalleştirme yardımcıları
plugin-sdk/request-urlİstek URL yardımcılarıİstek benzeri girdilerden dize URL çıkarma
plugin-sdk/run-commandZamanlanmış komut yardımcılarıNormalize stdout/stderr ile zamanlanmış komut çalıştırıcısı
plugin-sdk/param-readersParam okuyucularYaygın araç/CLI param okuyucuları
plugin-sdk/tool-sendAraç gönderimi çıkarmaAraç argümanlarından kanonik gönderim hedef alanlarını çıkarır
plugin-sdk/temp-pathGeçici yol yardımcılarıPaylaşılan geçici indirme yolu yardımcıları
plugin-sdk/logging-coreGünlükleme yardımcılarıAlt sistem logger ve sansürleme yardımcıları
plugin-sdk/markdown-table-runtimeMarkdown tablo yardımcılarıMarkdown tablo modu yardımcıları
plugin-sdk/reply-payloadMesaj yanıt türleriYanıt payload türleri
plugin-sdk/provider-setupDerlenmiş yerel/self-hosted sağlayıcı kurulum yardımcılarıSelf-hosted sağlayıcı keşif/config yardımcıları
plugin-sdk/self-hosted-provider-setupOdaklı OpenAI uyumlu self-hosted sağlayıcı kurulum yardımcılarıAynı self-hosted sağlayıcı keşif/config yardımcıları
plugin-sdk/provider-auth-runtimeSağlayıcı çalışma zamanı kimlik doğrulama yardımcılarıÇalışma zamanı API anahtarı çözümleme yardımcıları
plugin-sdk/provider-auth-api-keySağlayıcı API anahtarı kurulum yardımcılarıAPI anahtarı onboarding/profil yazma yardımcıları
plugin-sdk/provider-auth-resultSağlayıcı auth-result yardımcılarıStandart OAuth auth-result oluşturucusu
plugin-sdk/provider-auth-loginSağlayıcı etkileşimli giriş yardımcılarıPaylaşılan etkileşimli giriş yardımcıları
plugin-sdk/provider-env-varsSağlayıcı ortam değişkeni yardımcılarıSağlayıcı kimlik doğrulama ortam değişkeni arama yardımcıları
plugin-sdk/provider-model-sharedPaylaşılan sağlayıcı model/replay yardımcılarıProviderReplayFamily, buildProviderReplayFamilyHooks, normalizeModelCompat, paylaşılan replay-policy oluşturucuları, sağlayıcı endpoint yardımcıları ve model-id normalleştirme yardımcıları
plugin-sdk/provider-catalog-sharedPaylaşılan sağlayıcı katalog yardımcılarıfindCatalogTemplate, buildSingleProviderApiKeyCatalog, supportsNativeStreamingUsageCompat, applyProviderNativeStreamingUsageCompat
plugin-sdk/provider-onboardSağlayıcı onboarding yamalarıOnboarding config yardımcıları
plugin-sdk/provider-httpSağlayıcı HTTP yardımcılarıGenel sağlayıcı HTTP/endpoint yetenek yardımcıları
plugin-sdk/provider-web-fetchSağlayıcı web-fetch yardımcılarıWeb-fetch sağlayıcı kayıt/önbellek yardımcıları
plugin-sdk/provider-web-searchSağlayıcı web-search yardımcılarıWeb-search sağlayıcı kayıt/önbellek/config yardımcıları
plugin-sdk/provider-toolsSağlayıcı araç/şema uyumluluk yardımcılarıProviderToolCompatFamily, buildProviderToolCompatFamilyHooks, Gemini şema temizleme + diagnostics ve resolveXaiModelCompatPatch / applyXaiModelCompat gibi xAI uyumluluk yardımcıları
plugin-sdk/provider-usageSağlayıcı kullanım yardımcılarıfetchClaudeUsage, fetchGeminiUsage, fetchGithubCopilotUsage ve diğer sağlayıcı kullanım yardımcıları
plugin-sdk/provider-streamSağlayıcı akış sarmalayıcı yardımcılarıProviderStreamFamily, buildProviderStreamFamilyHooks, composeProviderStreamWrappers, akış sarmalayıcı türleri ve paylaşılan Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot sarmalayıcı yardımcıları
plugin-sdk/keyed-async-queueSıralı async kuyrukKeyedAsyncQueue
plugin-sdk/media-runtimePaylaşılan medya yardımcılarıMedya fetch/transform/store yardımcıları ve medya payload oluşturucuları
plugin-sdk/media-understandingMedya anlama yardımcılarıMedya anlama sağlayıcı türleri ve sağlayıcıya dönük görsel/ses yardımcı dışa aktarımları
plugin-sdk/text-runtimePaylaşılan metin yardımcılarıAsistana görünür metin temizleme, markdown render/parçalama/tablo yardımcıları, sansürleme yardımcıları, yönerge etiketi yardımcıları, güvenli metin yardımcıları ve ilgili metin/günlükleme yardımcıları
plugin-sdk/text-chunkingMetin parçalama yardımcılarıGiden metin parçalama yardımcısı
plugin-sdk/speechKonuşma yardımcılarıKonuşma sağlayıcı türleri ve sağlayıcıya dönük yönerge, kayıt ve doğrulama yardımcıları
plugin-sdk/speech-corePaylaşılan konuşma çekirdeğiKonuşma sağlayıcı türleri, kayıt, yönergeler, normalleştirme
plugin-sdk/realtime-transcriptionGerçek zamanlı transkripsiyon yardımcılarıSağlayıcı türleri ve kayıt yardımcıları
plugin-sdk/realtime-voiceGerçek zamanlı ses yardımcılarıSağlayıcı türleri ve kayıt yardımcıları
plugin-sdk/image-generation-corePaylaşılan görsel oluşturma çekirdeğiGörsel oluşturma türleri, failover, kimlik doğrulama ve kayıt yardımcıları
plugin-sdk/video-generationVideo oluşturma yardımcılarıVideo oluşturma sağlayıcı/istek/sonuç türleri
plugin-sdk/video-generation-corePaylaşılan video oluşturma çekirdeğiVideo oluşturma türleri, failover yardımcıları, sağlayıcı arama ve model-ref ayrıştırma
plugin-sdk/interactive-runtimeEtkileşimli yanıt yardımcılarıEtkileşimli yanıt payload normalleştirme/indirgeme
plugin-sdk/channel-config-primitivesKanal config ilkel bileşenleriDar kanal config-schema ilkel bileşenleri
plugin-sdk/channel-config-writesKanal config yazma yardımcılarıKanal config yazma yetkilendirme yardımcıları
plugin-sdk/channel-plugin-commonPaylaşılan kanal prelude’uPaylaşılan kanal plugin prelude dışa aktarımları
plugin-sdk/channel-statusKanal durumu yardımcılarıPaylaşılan kanal durumu anlık görüntü/özet yardımcıları
plugin-sdk/allowlist-config-editAllowlist config yardımcılarıAllowlist config düzenleme/okuma yardımcıları
plugin-sdk/group-accessGrup erişim yardımcılarıPaylaşılan grup erişim kararı yardımcıları
plugin-sdk/direct-dmDoğrudan DM yardımcılarıPaylaşılan doğrudan DM kimlik doğrulama/koruma yardımcıları
plugin-sdk/extension-sharedPaylaşılan uzantı yardımcılarıPasif kanal/durum yardımcısı ilkel bileşenleri
plugin-sdk/webhook-targetsWebhook hedef yardımcılarıWebhook hedef kaydı ve rota kurulum yardımcıları
plugin-sdk/webhook-pathWebhook yol yardımcılarıWebhook yol normalleştirme yardımcıları
plugin-sdk/web-mediaPaylaşılan web medya yardımcılarıUzak/yerel medya yükleme yardımcıları
plugin-sdk/zodZod yeniden dışa aktarımıPlugin SDK kullanıcıları için yeniden dışa aktarılan zod
plugin-sdk/memory-corePaketli memory-core yardımcılarıMemory manager/config/file/CLI yardımcı yüzeyi
plugin-sdk/memory-core-engine-runtimeBellek motoru çalışma zamanı cephesiBellek indeks/arama çalışma zamanı cephesi
plugin-sdk/memory-core-host-engine-foundationBellek host foundation motoruBellek host foundation motor dışa aktarımları
plugin-sdk/memory-core-host-engine-embeddingsBellek host embedding motoruBellek host embedding motor dışa aktarımları
plugin-sdk/memory-core-host-engine-qmdBellek host QMD motoruBellek host QMD motor dışa aktarımları
plugin-sdk/memory-core-host-engine-storageBellek host storage motoruBellek host storage motor dışa aktarımları
plugin-sdk/memory-core-host-multimodalBellek host multimodal yardımcılarıBellek host multimodal yardımcıları
plugin-sdk/memory-core-host-queryBellek host query yardımcılarıBellek host query yardımcıları
plugin-sdk/memory-core-host-secretBellek host secret yardımcılarıBellek host secret yardımcıları
plugin-sdk/memory-core-host-statusBellek host durum yardımcılarıBellek host durum yardımcıları
plugin-sdk/memory-core-host-runtime-cliBellek host CLI çalışma zamanıBellek host CLI çalışma zamanı yardımcıları
plugin-sdk/memory-core-host-runtime-coreBellek host çekirdek çalışma zamanıBellek host çekirdek çalışma zamanı yardımcıları
plugin-sdk/memory-core-host-runtime-filesBellek host dosya/çalışma zamanı yardımcılarıBellek host dosya/çalışma zamanı yardımcıları
plugin-sdk/memory-lancedbPaketli memory-lancedb yardımcılarıMemory-lancedb yardımcı yüzeyi
plugin-sdk/testingTest araçlarıTest yardımcıları ve mock’lar
Bu tablo kasıtlı olarak tam SDK yüzeyi değil, yaygın geçiş alt kümesidir. 200’den fazla giriş noktasının tam listesi scripts/lib/plugin-sdk-entrypoints.json dosyasında bulunur. Bu liste hâlâ plugin-sdk/feishu, plugin-sdk/feishu-setup, plugin-sdk/zalo, plugin-sdk/zalo-setup ve plugin-sdk/matrix* gibi bazı paketli plugin yardımcı yüzeylerini içerir. Bunlar paketli plugin bakımı ve uyumluluk için dışa aktarılmaya devam eder, ancak yaygın geçiş tablosuna bilerek dahil edilmemiştir ve yeni plugin kodu için önerilen hedef değildir. Aynı kural şu diğer paketli yardımcı aileleri için de geçerlidir:
  • browser destek yardımcıları: plugin-sdk/browser-config-support, plugin-sdk/browser-support
  • Matrix: plugin-sdk/matrix*
  • LINE: plugin-sdk/line*
  • IRC: plugin-sdk/irc*
  • plugin-sdk/googlechat, plugin-sdk/zalouser, plugin-sdk/bluebubbles*, plugin-sdk/mattermost*, plugin-sdk/msteams, plugin-sdk/nextcloud-talk, plugin-sdk/nostr, plugin-sdk/tlon, plugin-sdk/twitch, plugin-sdk/github-copilot-login, plugin-sdk/github-copilot-token, plugin-sdk/diagnostics-otel, plugin-sdk/diffs, plugin-sdk/llm-task, plugin-sdk/thread-ownership ve plugin-sdk/voice-call gibi paketli yardımcı/plugin yüzeyleri
plugin-sdk/github-copilot-token şu anda dar token yardımcısı yüzeyini sunar: DEFAULT_COPILOT_API_BASE_URL, deriveCopilotApiBaseUrlFromToken ve resolveCopilotApiToken. Yapılacak işe en uygun en dar import’u kullanın. Bir dışa aktarım bulamıyorsanız, src/plugin-sdk/ içindeki kaynağı kontrol edin veya Discord’da sorun.

​
Kaldırma zaman çizelgesi

Ne zamanNe olur
ŞimdiDeprecated yüzeyler çalışma zamanı uyarıları üretir
Bir sonraki büyük sürümDeprecated yüzeyler kaldırılır; bunları hâlâ kullanan eklentiler başarısız olur
Tüm çekirdek eklentiler zaten geçirildi. Harici eklentiler bir sonraki büyük sürümden önce geçiş yapmalıdır.

​
Uyarıları geçici olarak bastırma

Geçiş üzerinde çalışırken şu ortam değişkenlerini ayarlayın: 
OPENCLAW_SUPPRESS_PLUGIN_SDK_COMPAT_WARNING=1 openclaw gateway run
OPENCLAW_SUPPRESS_EXTENSION_API_WARNING=1 openclaw gateway run
Bu geçici bir kaçış kapağıdır, kalıcı bir çözüm değildir.

​
İlgili