Plugin SDK geçişi

OpenClaw, geniş bir geriye dönük uyumluluk katmanını küçük ve odaklı içe aktarımlardan oluşturulan modern bir plugin mimarisiyle değiştirdi. Plugin'iniz bu değişiklikten önce oluşturulduysa bu kılavuz, onu güncel sözleşmelere geçirmenizi sağlar.

Neler değişti

Önceden son derece geniş olan çeşitli içe aktarım yüzeyleri, plugin'lerin tek bir giriş noktasından neredeyse her şeye erişmesine olanak tanıyordu:

• openclaw/plugin-sdk ve openclaw/plugin-sdk/compat - odaklı SDK oluşturulurken düzinelerce yardımcıyı yeniden dışa aktarıyordu. Her iki kök de artık kaldırıldı; bunun yerine belgelenmiş bir alt yolu içe aktarın.
• openclaw/plugin-sdk/infra-runtime - sistem olaylarını, heartbeat durumunu, teslimat kuyruklarını, fetch/proxy yardımcılarını, dosya yardımcılarını, onay türlerini ve ilgisiz yardımcı programları bir araya getiren geniş kapsamlı bir barrel.
• openclaw/plugin-sdk/config-runtime - yalnızca sonraki uyumluluk dönemi için tutulan geniş kapsamlı bir yapılandırma barrel'ı; doğrudan çalışma zamanı yükleme/yazma yardımcıları kaldırıldı.
• openclaw/extension-api - plugin'lere gömülü agent çalıştırıcısı gibi ana makine tarafındaki yardımcılara doğrudan erişim sağlayan, kaldırılmış bir köprü.
• api.registerEmbeddedExtensionFactory(...) - tool_result gibi gömülü çalıştırıcı olaylarını gözlemleyen, yalnızca gömülü çalıştırıcıya yönelik kaldırılmış bir hook. Bunun yerine agent araç sonucu ara yazılımını kullanın (bkz. Gömülü araç sonucu uzantılarını ara yazılıma taşıma).

Kök SDK, uyumluluk barrel'ı, uzantı köprüsü ve gömülü uzantı fabrikası kaldırıldı. infra-runtime ve config-runtime yalnızca ayrı olarak kaydedilmiş sonraki dönemleri için kalır; yeni plugin'ler odaklı alt yolları kullanmalıdır.

OpenClaw, belgelenmiş plugin davranışını bir alternatif sunduğu değişiklikle aynı anda kaldırmaz veya yeniden yorumlamaz. Sözleşmeyi bozan değişiklikler önce bir uyumluluk bağdaştırıcısından, tanılamalardan, belgelerden ve bir kullanımdan kaldırma döneminden geçer. Bu; SDK içe aktarımları, manifest alanları, kurulum API'leri, hook'lar ve çalışma zamanı kaydı davranışı için geçerlidir.

Nedenleri

• Yavaş başlangıç - tek bir yardımcının içe aktarılması, ilgisiz düzinelerce modülü yüklüyordu.
• Döngüsel bağımlılıklar - geniş kapsamlı yeniden dışa aktarımlar, içe aktarım döngülerinin oluşturulmasını kolaylaştırıyordu.
• Belirsiz API yüzeyi - kararlı dışa aktarımları dahili olanlardan ayırt etmenin bir yolu yoktu.

Artık her openclaw/plugin-sdk/<subpath>, belgelenmiş bir sözleşmeye sahip küçük ve bağımsız bir modüldür.

Paketle gelen kanallara yönelik eski sağlayıcı kolaylık katmanları da kaldırıldı; kanala özgü yardımcı kısayollar kararlı plugin sözleşmeleri değil, özel mono-repo kolaylıklarıydı. Bunun yerine dar kapsamlı genel SDK alt yollarını kullanın. Paketle gelen plugin çalışma alanında, sağlayıcının sahip olduğu yardımcıları ilgili plugin'in kendi api.ts veya runtime-api.ts konumunda tutun:

• Anthropic, Claude'a özgü akış yardımcılarını kendi api.ts / contract-api.ts katmanında 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 konumunda tutar.
• OpenRouter, sağlayıcı oluşturucusunu ve ilk katılım/yapılandırma yardımcılarını kendi api.ts konumunda tutar.

Uyumluluk politikası

Harici plugin uyumluluk çalışmaları şu sırayı izler:

1. Yeni sözleşmeyi ekleyin.
2. Eski davranışı bir uyumluluk bağdaştırıcısı üzerinden bağlı tutun.
3. Eski yolu ve alternatifini belirten bir tanılama veya uyarı yayınlayın.
4. Testlerde her iki yolu da kapsayın.
5. Kullanımdan kaldırma ve geçiş yolunu belgeleyin.
6. Yalnızca duyurulan geçiş döneminden sonra, genellikle büyük bir sürümde kaldırın.

Bir manifest alanı hâlâ kabul ediliyorsa belgeler ve tanılamalar aksini söyleyene kadar kullanmaya devam edin. Yeni kod, belgelenmiş alternatifi tercih etmelidir; mevcut plugin'ler olağan küçük sürümler sırasında bozulmamalıdır.

Yayımlanmış kanal kurulumu uyumluluğu

2026.7.1 üzerinden yayımlanan Slack, Discord, Signal ve Microsoft Teams paketleri, kanala özgü yapılandırma şemalarını openclaw/plugin-sdk/bundled-channel-config-schema konumundan içe aktarır. Yayımlanmış Slack ve Discord paketleri ayrıca openclaw/plugin-sdk/setup-runtime konumundan createLegacyCompatChannelDmPolicy ve promptLegacyChannelAllowFromForAccount öğelerini içe aktarır.

Bu dışa aktarımlar, kullanımdan kaldırılmış çalışma zamanı uyumluluk bağdaştırıcıları olarak kullanılmaya devam eder. Yeni ve yeniden yayımlanan plugin'ler, channel-config-schema ve setup-runtime konumundaki genel temel öğeleri kullanarak yapılandırma şemalarının ve kurulum politikalarının sahipliğini yerel olarak üstlenmelidir. Uyumluluk dışa aktarımları yalnızca desteklenen en düşük yayımlanmış paket sürümleri artık bunları içe aktarmadığında kaldırılabilir.

Kanal kurulumu giriş alanı uyumluluğu

ChannelSetupInput artık yalnızca kanallar arası kurulum zarfını kalıcı olarak türlü tutar. Kanala özgü alanlar, plugin yazarları bu alanları plugin'e özgü kurulum giriş türlerine taşırken mevcut harici plugin'lerin derlenmeye devam etmesi için kullanımdan kaldırılmış bir uyumluluk katmanında türlü kalır.

OpenClaw büyük sürümler yayımlamaz. 2026-07-22 tarihinde yapılan bir kayıt defteri taraması, ağaç dışındaki 426 yayımlanmış kanal plugin'ini inceledi ve okuyucusu olmayan 21 alanı kaldırdı. Tutulan 22 alanın her birinin bilinen bir yayımlanmış okuyucusu vardır. Sonraki her alan, hiçbir yayımlanmış plugin onu okumaz okumaz silinir; plugin yazarları plugin'e özgü kurulum giriş türlerine geçtikçe tutulan küme küçülür.

Aynı tarama, yayımlanmış bağımlısı olmayan 23 eski bildirilmemiş bağdaştırıcı yükseltme anahtarını kaldırdı. Altı yaygın anahtar ve yalnızca kuruluma yönelik rooms anahtarı kalır. Yayımlanmış plugin'ler singleAccountKeysToMove bildirdikçe bu küme de küçülür.

Paylaşılan türde indeks imzası yoktur. Plugin'in sahip olduğu anahtarlar çalışma zamanı giriş nesnelerinde bulunmaya devam edebilir; bunları plugin'e özgü bir kesişimde bildirin veya sahibi olan plugin'in kurulum şeması üzerinden daraltın.

Eski bildirilmemiş bağdaştırıcı yükseltme katmanı, okuyucuya dayalı aynı politikayı izler. Plugin'in ek yükseltme anahtarına ihtiyaç duymadığı durumlarda boş bir dizi de dahil olmak üzere singleAccountKeysToMove öğesini bildirin; böylece paylaşılan geri dönüş mekanizması her seferinde bir anahtar olacak şekilde kullanımdan kaldırılabilir.

Okuyucuları doğrulama

1. Her nextCursor ile https://clawhub.ai/api/v1/packages?family=code-plugin&limit=100 içinde sayfalar arasında ilerleyin ve categories alanında channels bulunan paketleri tutun.
2. npm search --json --searchlimit=1000 "openclaw channel plugin" içindeki npm adaylarını ekleyin. openclaw/plugin-sdk/channel-setup, openclaw/plugin-sdk/setup ve openclaw/plugin-sdk/core için GitHub kod aramalarından yalnızca kaynak kodu bulunan adayları ekleyin.
3. Her adayın yayımlanmış en son sürümünü çözümleyin. npm pack <package>@<version> --json --pack-destination <temp-dir> komutunu çalıştırın, paketi açın ve doğrudan veya yapı çözümlemeli alan okumaları için gönderilmiş dist JavaScript kodunu ve bildirimlerini inceleyin. Bir paketin npm sürümü yoksa ClawHub yapıtını indirin.
4. Paketi, sürümü, alanı veya yükseltme anahtarını ve eşleşen dosyayı kaydedin. Bir alan veya anahtar yalnızca hiçbir yayımlanmış plugin yapıtı onu okumadığında silinebilir. Tutulan alan ve anahtar listelerinin yanındaki kod açıklamalarında bulunan okuyucu adlarını taramayla eşitlenmiş halde tutun.

Bu yalnızca bir kaynak/tür uyumluluk kaydıdır. Çalışma zamanı kurulum giriş nesneleri ve kurulum davranışı değişmediğinden çalışma zamanı bağdaştırıcısı veya uyumluluk kayıt defteri girdisi yoktur.

Geçerli geçiş kuyruğunu pnpm plugins:boundary-report ile denetleyin:

pnpm plugins:boundary-report:ci, üç hata bayrağının tümüyle çalışır. Kullanımdan kaldırılmış kayıtlarda genellikle belirsiz bir "sonraki büyük sürüm" ifadesi yerine açık bir removeAfter tarihi bulunur. Sahibi tarafından tarihi onaylanmamış bir kayıtta removeAfter bulunmaz, no-date olarak görünür ve hiçbir zaman kaldırılmaya uygun olmaz. Rapor, kullanımdan kaldırılmış kayıtları tarihe göre gruplandırır, yerel kod/belge referanslarını sayar, sahipler arası ayrılmış SDK içe aktarımlarını gösterir ve özel bellek ana makinesi SDK köprüsünü özetler. Ayrılmış SDK alt yollarının izlenen sahip kullanımları olmalıdır; kullanılmayan ayrılmış dışa aktarımlar genel SDK'dan kaldırılmalıdır.

Eski medya projeksiyonu

media-legacy-projection uyumluluk kaydı; eski paralel medya alanlarını, yük oluşturucularını, hook meta verisi takma adlarını ve medya şablonu adlarını kapsar. Onaylanmış removeAfter tarihi 2026-10-01'dir (önce olgular yaklaşımına dayalı alternatiflerin gönderilmesinden iki sürüm treni sonrası). Kaldırma işlemi ayrıca o tarihte yayımlanmış plugin yapıtlarının temiz bir şekilde taranmasını gerektirir; bu tarihten önce geçiş yapın.

Kanal girişi için tekil/çoğul MediaPath, MediaUrl, MediaType, MediaPaths, MediaUrls, MediaTypes, MediaTranscribedIndexes, MediaWorkspaceDir ve MediaStaged öğelerini sıralı olgularla değiştirin:

 const media = toInboundMediaFacts([  { path: saved.path, url: nativeUrl, contentType: saved.contentType, messageId },]); const ctx = finalizeInboundContext({ Body: caption, media });

inbound_claim ve message_received hook'larında event.media kullanın. Uzak medya yerel olarak hazırlanmadıysa kimlik/tanılama için event.originalMedia kullanın ve event.media öğesini bekleyin; event.mediaStagingPending bu durumu ayırt eder. event.metadata öğesinden kullanımdan kaldırılmış tekil/çoğul özellikleri okumayın.

CLI medya modelleri için {{MediaPath}}, {{MediaUrl}}, {{MediaType}} ve {{MediaDir}} öğelerini {{AttachmentPath}}, {{AttachmentUrl}}, {{AttachmentContentType}} ve {{AttachmentDir}} ile değiştirin. Ek konumunun önemli olduğu durumlarda {{AttachmentIndex}} kullanın.

Yerel medya okuma politikası için openclaw/plugin-sdk/media-local-roots konumundan getAgentScopedMediaLocalRoots(...) veya getAgentScopedMediaLocalRootsForSources(...) öğesini içe aktarın. openclaw/plugin-sdk/agent-media-payload facade'ı ve onun buildAgentMediaPayload(...) projeksiyonu kullanımdan kaldırılmıştır.

Geçiş yapma

await api.runtime.config.mutateConfigFile({  afterWrite: { mode: "auto" },  mutate(draft) {    draft.plugins ??= {};  },});

// OpenClaw çalışma zamanı araçları ve Codex çalışma zamanı dinamik araçları (sonuç// dönüştürülebilir). Codex'e özgü araç sonuçları da gözlem amacıyla aktarılır,// ancak dönüştürülmüş çıktıları modele hiçbir zaman ulaşmaz: Codex// PostToolUse kancası sözleşmesi yerel bir araç yanıtının yerini alamaz.api.registerAgentToolResultMiddleware(async (event) => {  return compactToolResult(event);}, {  runtimes: ["openclaw", "codex"],});

{  "contracts": {    "agentToolResultMiddleware": ["openclaw", "codex"]  }}

// Önceconst program = applyWindowsSpawnProgramPolicy({ candidate }); // Sonraconst program = applyWindowsSpawnProgramPolicy({  candidate,  // Bunu yalnızca kabuk aracılı geri dönüşü kasıtlı olarak kabul eden  // güvenilir uyumluluk çağıranları için ayarlayın.  allowShellFallback: true,});

grep -r "plugin-sdk/compat" my-plugin/grep -r "plugin-sdk/infra-runtime" my-plugin/grep -r "plugin-sdk/config-runtime" my-plugin/grep -r "openclaw/extension-api" my-plugin/

// Önce (kullanımdan kaldırılmış geriye dönük uyumluluk katmanı)import {  createChannelReplyPipeline,  createPluginRuntimeStore,  resolveControlCommandGate,} from "openclaw/plugin-sdk/compat"; // Sonra (modern odaklı içe aktarmalar)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";

// Önce (kullanımdan kaldırılmış extension-api köprüsü)import { runEmbeddedAgent } from "openclaw/extension-api";const result = await runEmbeddedAgent({ sessionId, prompt }); // Sonra (eklenen çalışma zamanı)const result = await api.runtime.agent.runEmbeddedAgent({ sessionId, prompt });

pnpm buildpnpm test my-plugin/

İçe aktarma yolu başvurusu

İçe aktarılabilir SDK alt yolları için doğruluk kaynağı, genel paket dışa aktarma eşlemesidir. SDK genel bakışı bölümünden bağlantı verilen konuya özgü SDK kılavuzlarını kullanın ve belgelenmiş en dar genel alt yolu tercih edin. scripts/lib/plugin-sdk-entrypoints.json içindeki derleyici envanteri, paketlenmiş Plugin'leri derlemek için kullanılan özel-yerel girdileri de içerir; bunların burada bulunması onları genel paket dışa aktarımları yapmaz.

Bu tablo, tam SDK yüzeyi değil, yaygın geçiş alt kümesidir. Derleyici giriş noktası envanteri scripts/lib/plugin-sdk-entrypoints.json içindedir; paket dışa aktarımları genel alt kümeden oluşturulur.

Açıkça belgelenmiş uyumluluk cepheleri dışında, paketlenmiş Plugin'lere ayrılmış yardımcı yüzeyler genel SDK dışa aktarma eşlemesinden kaldırılmıştır. Buna, yayımlanmış @openclaw/discord paketini hâlâ doğrudan içe aktaran harici Plugin'ler için tutulan, kullanımdan kaldırılmış plugin-sdk/discord uyumluluk katmanı dahildir. Sahibe özgü yardımcılar, sahibi olan Plugin paketinin içinde bulunur; paylaşılan ana makine davranışı plugin-sdk/gateway-runtime, plugin-sdk/security-runtime ve eklenen Plugin API'si gibi genel SDK sözleşmeleri üzerinden taşınır.

İşle eşleşen en dar içe aktarmayı kullanın. Bir dışa aktarım bulamıyorsanız src/plugin-sdk/ kaynağını kontrol edin veya hangi genel sözleşmenin buna sahip olması gerektiğini bakımcılara sorun.

Kaldırılan uyumluluk yüzeyleri

Temmuz 2026 taraması; kök SDK ve uyumluluk toplu dışa aktarımlarını, uzantı API'si köprüsünü, süresi dolmuş SDK alt yol takma adlarını, kullanılmayan SDK alt yollarını ve yalnızca paketlenmiş modüllere yönelik genel SDK dışa aktarımlarını kaldırdı. Yalnızca paketlenmiş modüller, özel-yerel derleme eşlemeleri aracılığıyla depo sahiplerinin kullanımına açık kalır; yayımlanmış paketten içe aktarılamazlar.

İşlem geneli API sağlayıcısı yayımlama

registerApiProvider(...) ve unregisterApiProviders(...), openclaw/plugin-sdk/llm üzerinden kaldırıldı. Bunlar API aktarımlarını işlem geneli durumda yayımlıyordu; yaşam döngüsünün sahibi olduğu model çalışma zamanları da bunları hazırlanan her kayıt defterine kopyalamak zorunda kalıyordu.

Sağlayıcı Plugin'leri metin çıkarımı sağlayıcılarını api.registerProvider(...) aracılığıyla kaydetmelidir. Bir ApiRegistry oluşturan ana makineye ait kod ve testler, sağlayıcı sahipliğinin ve kapatma işleminin hazırlanan çalışma zamanı kapsamında kalması için doğrudan bu kayıt defterine kaydolmalıdır.

Özel test toplu dışa aktarımı

openclaw/plugin-sdk/testing depoya özeldi ve yayımlanan paket yapılarının dışında bırakılıyordu; bu nedenle gelecekteki 2026-07-28 removeAfter tarihinden önce kaldırıldı. Depo testleri plugin-sdk/plugin-test-runtime, plugin-sdk/channel-test-helpers, plugin-sdk/channel-target-testing, plugin-sdk/test-env ve plugin-sdk/test-fixtures gibi odaklı alt yolları kullanır.

Geçiş başvurusu

Bu eşlemeler hem Temmuz 2026'da kaldırılan yüzeyleri hem de daha sonraki dönemde etkin olan kullanımdan kaldırmaları kapsar. Bir eşleme, geçiş rehberidir; eski yüzeyin hâlâ kullanılabilir olduğunun kanıtı değildir. Güncel durum için uyumluluk kayıt defterine ve kaldırma zaman çizelgesine başvurun.

// Önceimport { buildHelpMessage } from "openclaw/plugin-sdk/command-auth"; // Sonraimport { buildHelpMessage } from "openclaw/plugin-sdk/command-status";

// Önceapi.on("deactivate", async (event, ctx) => {  await stopPluginService(ctx);}); // Sonraapi.on("gateway_stop", async (event, ctx) => {  await stopPluginService(ctx);});

// Önceapi.on("subagent_spawning", async () => ({  status: "ok",  threadBindingReady: true,  deliveryOrigin: { channel: "discord", to: "channel:123", threadId: "456" },})); // Sonraapi.on("subagent_spawned", async (event) => {  await observeSubagentLaunch(event);});

{  "contracts": {    "externalAuthProviders": ["anthropic", "openai"]  }}

// Önceconst flow = api.runtime.tasks.flow.fromToolContext(ctx);// Sonraconst flow = api.runtime.tasks.managedFlows.fromToolContext(ctx);

// Önceimport type { OpenClawSchemaType } from "openclaw/plugin-sdk";// Sonraimport type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";

Talk ve gerçek zamanlı ses geçişi

Gerçek zamanlı ses, telefon, toplantı ve tarayıcı Talk kodu, openclaw/plugin-sdk/realtime-voice tarafından dışa aktarılan tek bir Talk oturum denetleyicisini paylaşır. Denetleyici; ortak Talk olay zarfının, etkin tur durumunun, yakalama durumunun, ses çıkışı durumunun, yakın tarihli olay geçmişinin ve eski tur reddinin sahibidir. Sağlayıcı Plugin'leri, satıcıya özgü gerçek zamanlı oturumların sahibidir. Tarayıcı toplantısı Plugin'leri; oturum, tarayıcı, ses, node ana makinesi, agent danışması ve sesli arama mekanikleri için openclaw/plugin-sdk/meeting-runtime kullanır, ardından URL kuralları, DOM betikleri, manuel eylem eşlemesi, altyazılar, oluşturma ve telefonla katılım planları için MeetingPlatformAdapter uygular. Platform REST API'leri, OAuth, yapıtlar, seçiciler ve aktarım adları Plugin'de kalır. Tarayıcı izin planları, istenen toplantı URL'sini alır; böylece her platform yalnızca tam olarak desteklediği kaynaklara izin verebilir. Oturum çalışma zamanları, tarayıcıdan ayrılmanın doğrulanmasının ardından platforma özgü canlı sağlık durumunu da normalleştirmelidir; geçmiş döküm alanları kalabilir ancak ayrıldıktan sonra altyazı ve ses hazırlığı etkin kalmamalıdır.

Paketle gelen tüm yüzeyler paylaşılan denetleyicide çalışır: tarayıcı aktarımı, yönetilen oda devri, sesli aramada gerçek zamanlı çalışma, sesli aramada akışlı STT, Google Meet gerçek zamanlı çalışma ve yerel bas-konuş. Gateway, hello-ok.features.events içinde tek bir canlı Talk olay kanalı duyurur: talk.event.

Yeni kod, düşük düzeyli bir bağdaştırıcı veya test fikstürü uygulamadığı sürece createTalkEventSequencer(...) işlevini doğrudan çağırmamalıdır. Tur kapsamındaki olayların tur kimliği olmadan yayımlanamaması, eski turnEnd / turnCancel çağrılarının daha yeni bir etkin turu temizleyememesi ve ses çıkışı yaşam döngüsü olaylarının telefon, toplantılar, tarayıcı aktarımı, yönetilen oda devri ve yerel Talk istemcileri genelinde tutarlı kalması için paylaşılan denetleyiciyi kullanın.

Genel API biçimi:

// Gateway'in sahip olduğu Talk oturumu API'si.await gateway.request("talk.session.create", {  mode: "realtime",  transport: "gateway-relay",  brain: "agent-consult",  sessionKey: "main",});await gateway.request("talk.session.appendAudio", { sessionId, audioBase64 });await gateway.request("talk.session.cancelOutput", { sessionId, reason: "barge-in" });await gateway.request("talk.session.submitToolResult", {  sessionId,  callId,  result: { status: "working" },  options: { willContinue: true },});await gateway.request("talk.session.submitToolResult", {  sessionId,  callId,  result: { status: "already_delivered" },  options: { suppressResponse: true },});await gateway.request("talk.session.submitToolResult", { sessionId, callId, result });await gateway.request("talk.session.close", { sessionId }); // İstemcinin sahip olduğu sağlayıcı oturumu API'si.await gateway.request("talk.client.create", {  mode: "realtime",  transport: "webrtc",  brain: "agent-consult",  sessionKey: "main",});await gateway.request("talk.client.toolCall", { sessionKey, callId, name, args });await gateway.request("talk.client.steer", { sessionKey, text, mode: "steer" });

Tarayıcının sahip olduğu WebRTC/sağlayıcı websocket oturumları talk.client.create kullanır; çünkü sağlayıcı anlaşmasının ve medya aktarımının sahibi tarayıcı, kimlik bilgilerinin, talimatların ve araç politikasının sahibi ise Gateway'dir. talk.session.*; Gateway aktarımı üzerinden gerçek zamanlı çalışma, Gateway aktarımı üzerinden döküm ve yönetilen oda yerel STT/TTS oturumları için Gateway tarafından yönetilen ortak yüzeydir.

Gerçek zamanlı seçicileri talk.provider / talk.providers yanına yerleştiren eski yapılandırmalar openclaw doctor --fix ile onarılmalıdır; çalışma zamanı Talk, konuşma/TTS sağlayıcı yapılandırmasını gerçek zamanlı sağlayıcı yapılandırması olarak yeniden yorumlamaz.

Desteklenen talk.session.create birleşimleri kasıtlı olarak sınırlıdır:

Eski talk.realtime.* / talk.transcription.* / talk.handoff.* ailelerinden geçiş yapan okuyucular için yöntem eşlemesi (tümü kaldırıldı):

Birleşik denetim söz dağarcığı da bilinçli olarak dardır:

Bunun çalışmasını sağlamak için çekirdeğe sağlayıcıya veya platforma özgü özel durumlar eklemeyin. Talk oturumu semantiğinin sahibi çekirdektir. Satıcı oturumu kurulumunun sahibi sağlayıcı Plugin'leridir. Telefon/toplantı bağdaştırıcılarının sahibi sesli arama ve Google Meet'tir. Cihaz yakalama/oynatma kullanıcı deneyiminin sahibi tarayıcı ve yerel uygulamalardır.

Kaldırma zaman çizelgesi

Aşağıdaki kalan genel SDK alt yollarının kayıt defteri destekli kaldırma zaman aralıkları vardır. 30 Temmuz satırları, bakımcıların erken yetkilendirdiği taramadan sonra kaldırıldı: kullanılmayan alt yollar silindi, önceki uyumluluk takma adları silindi ve yalnızca paketlenmiş modüller özel-yerel derleme eşlemelerine indirgendi.

Tüm çekirdek pluginler zaten geçirildi. Harici pluginler sonraki ana sürümden önce geçiş yapmalıdır. Plugininizin kullandığı yüzeylerde en yakında süresi dolacak uyumluluk kayıtlarını görmek için pnpm plugins:boundary-report komutunu çalıştırın.

Uyarıları geçici olarak bastırma

OPENCLAW_SUPPRESS_PLUGIN_SDK_COMPAT_WARNING=1 openclaw gateway runOPENCLAW_SUPPRESS_EXTENSION_API_WARNING=1 openclaw gateway run

Bu, kalıcı bir çözüm değil, geçici bir kaçış yoludur.

İlgili

• Başlarken - ilk plugininizi oluşturun
• SDK'ya Genel Bakış - tam alt yol içe aktarma referansı
• Kanal Pluginleri - kanal pluginleri oluşturma
• Sağlayıcı Pluginleri - sağlayıcı pluginleri oluşturma
• Plugin İç Yapısı - ayrıntılı mimari incelemesi
• Plugin Manifesti - manifest şeması referansı