Plugin mimarisinin iç yapısı

Documentation Index

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

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

​

Yükleme hattı

1. aday Plugin köklerini keşfeder
2. yerel veya uyumlu paket bildirimlerini ve paket meta verilerini okur
3. güvenli olmayan adayları reddeder
4. Plugin yapılandırmasını normalleştirir (plugins.enabled, allow, deny, entries, slots, load.paths)
5. her aday için etkinleştirmeye karar verir
6. etkinleştirilmiş yerel modülleri yükler: yerleşik paketlenmiş modüller yerel yükleyici kullanır; üçüncü taraf yerel kaynak TypeScript, acil durum Jiti yedeğini kullanır
7. yerel register(api) hook’larını çağırır ve kayıtları Plugin kayıt defterinde toplar
8. kayıt defterini komutlara/çalışma zamanı yüzeylerine açar

​

Bildirim öncelikli davranış

• Plugin’i tanımlamak
• bildirilen kanalları/Skills’leri/yapılandırma şemasını veya paket yeteneklerini keşfetmek
• plugins.entries.<id>.config değerini doğrulamak
• Control UI etiketlerini/yer tutucularını zenginleştirmek
• kurulum/katalog meta verilerini göstermek
• Plugin çalışma zamanını yüklemeden ucuz etkinleştirme ve kurulum tanımlayıcılarını korumak

• CLI yükleme, istenen birincil komutun sahibi olan Plugin’lere daraltılır
• kanal kurulumu/Plugin çözümleme, istenen kanal kimliğinin sahibi olan Plugin’lere daraltılır
• açık sağlayıcı kurulumu/çalışma zamanı çözümleme, istenen sağlayıcı kimliğinin sahibi olan Plugin’lere daraltılır
• Gateway başlangıç planlaması, açık başlangıç içe aktarmaları ve başlangıç devre dışı bırakmaları için activation.onStartup kullanır; başlangıç meta verisi olmayan Plugin’ler yalnızca daha dar etkinleştirme tetikleyicileri üzerinden yüklenir

​

Plugin önbellek sınırı

• PluginLoaderCacheState ve uyumlu etkin çalışma zamanı kayıt defterleri
• aynı çalışma zamanı yüzeyinin tekrar tekrar içe aktarılmasını önlemek için kullanılan jiti/modül önbellekleri ve herkese açık yüzey yükleyici önbellekleri
• kurulu Plugin yapıları için dosya sistemi önbellekleri
• yol normalleştirme veya yinelenen çözümleme için kısa ömürlü çağrı başına haritalar

• keşif sonuçları
• doğrudan bildirim kayıt defterleri
• kurulu Plugin dizininden yeniden oluşturulan bildirim kayıt defterleri
• sağlayıcı sahibi araması, model bastırma, sağlayıcı ilkesi veya herkese açık yapı meta verileri
• değiştirilmiş bir bildirimin, kurulu dizinin veya yükleme yolunun bir sonraki meta veri okumasında görünür olması gereken diğer tüm bildirimden türetilmiş yanıtlar

​

Kayıt defteri modeli

• Plugin kayıtları (kimlik, kaynak, köken, durum, tanılama)
• araçlar
• eski hook’lar ve türlendirilmiş hook’lar
• kanallar
• sağlayıcılar
• Gateway RPC işleyicileri
• HTTP rotaları
• CLI kaydedicileri
• arka plan hizmetleri
• Plugin’e ait komutlar

• Plugin modülü -> kayıt defteri kaydı
• çekirdek çalışma zamanı -> kayıt defteri tüketimi

​

Konuşma bağlama geri çağrıları

export default {
  id: "my-plugin",
  register(api) {
    api.onConversationBindingResolved(async (event) => {
      if (event.status === "approved") {
        // A binding now exists for this plugin + conversation.
        console.log(event.binding?.conversationId);
        return;
      }

      // The request was denied; clear any local pending state.
      console.log(event.request.conversation.conversationId);
    });
  },
};

• status: "approved" veya "denied"
• decision: "allow-once", "allow-always" veya "deny"
• binding: onaylanmış istekler için çözümlenmiş bağlama
• request: özgün istek özeti, ayırma ipucu, gönderici kimliği ve konuşma meta verileri

​

Sağlayıcı çalışma zamanı hook’ları

• Ucuz çalışma zamanı öncesi arama için bildirim meta verileri: setup.providers[].envVars, kullanım dışı uyumluluk providerAuthEnvVars, providerAuthAliases, providerAuthChoices ve channelEnvVars.
• Yapılandırma zamanı hook’ları: catalog (eski discovery) artı applyConfigDefaults.
• Çalışma zamanı hook’ları: kimlik doğrulama, model çözümleme, akış sarma, düşünme düzeyleri, yeniden oynatma ilkesi ve kullanım uç noktalarını kapsayan 40’tan fazla isteğe bağlı hook. Tam liste için Hook sırası ve kullanımı bölümüne bakın.

​

Hook sırası ve kullanımı

​

Sağlayıcı örneği

api.registerProvider({
  id: "example-proxy",
  label: "Example Proxy",
  auth: [],
  catalog: {
    order: "simple",
    run: async (ctx) => {
      const apiKey = ctx.resolveProviderApiKey("example-proxy").apiKey;
      if (!apiKey) {
        return null;
      }
      return {
        provider: {
          baseUrl: "https://proxy.example.com/v1",
          apiKey,
          api: "openai-completions",
          models: [{ id: "auto", name: "Auto" }],
        },
      };
    },
  },
  resolveDynamicModel: (ctx) => ({
    id: ctx.modelId,
    name: ctx.modelId,
    provider: "example-proxy",
    api: "openai-completions",
    baseUrl: "https://proxy.example.com/v1",
    reasoning: false,
    input: ["text"],
    cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
    contextWindow: 128000,
    maxTokens: 8192,
  }),
  prepareRuntimeAuth: async (ctx) => {
    const exchanged = await exchangeToken(ctx.apiKey);
    return {
      apiKey: exchanged.token,
      baseUrl: exchanged.baseUrl,
      expiresAt: exchanged.expiresAt,
    };
  },
  resolveUsageAuth: async (ctx) => {
    const auth = await ctx.resolveOAuthToken();
    return auth ? { token: auth.token } : null;
  },
  fetchUsageSnapshot: async (ctx) => {
    return await fetchExampleProxyUsage(ctx.token, ctx.timeoutMs, ctx.fetchFn);
  },
});

​

Yerleşik örnekler

​

Çalışma zamanı yardımcıları

const clip = await api.runtime.tts.textToSpeech({
  text: "Hello from OpenClaw",
  cfg: api.config,
});

const result = await api.runtime.tts.textToSpeechTelephony({
  text: "Hello from OpenClaw",
  cfg: api.config,
});

const voices = await api.runtime.tts.listVoices({
  provider: "elevenlabs",
  cfg: api.config,
});

• textToSpeech, dosya/sesli not yüzeyleri için normal çekirdek TTS çıktı payload’unu döndürür.
• Çekirdek messages.tts yapılandırmasını ve sağlayıcı seçimini kullanır.
• PCM ses buffer’ı + örnekleme hızını döndürür. Plugin’ler sağlayıcılar için yeniden örneklemeli/kodlamalıdır.
• listVoices sağlayıcı başına isteğe bağlıdır. Tedarikçinin sahip olduğu ses seçiciler veya kurulum akışları için kullanın.
• Ses listeleri; locale, cinsiyet ve kişilik etiketleri gibi sağlayıcı farkında seçiciler için daha zengin metadata içerebilir.
• OpenAI ve ElevenLabs bugün telefoniyi destekler. Microsoft desteklemez.

api.registerSpeechProvider({
  id: "acme-speech",
  label: "Acme Speech",
  isConfigured: ({ config }) => Boolean(config.messages?.tts),
  synthesize: async (req) => {
    return {
      audioBuffer: Buffer.from([]),
      outputFormat: "mp3",
      fileExtension: ".mp3",
      voiceCompatible: false,
    };
  },
});

• TTS politikasını, fallback’i ve yanıt teslimini çekirdekte tutun.
• Tedarikçinin sahip olduğu sentez davranışı için konuşma sağlayıcılarını kullanın.
• Eski Microsoft edge girdisi microsoft sağlayıcı kimliğine normalleştirilir.
• Tercih edilen sahiplik modeli şirket odaklıdır: OpenClaw bu capability contract’ları ekledikçe tek bir tedarikçi plugin’i metin, konuşma, görüntü ve gelecekteki medya sağlayıcılarını sahiplenebilir.

api.registerMediaUnderstandingProvider({
  id: "google",
  capabilities: ["image", "audio", "video"],
  describeImage: async (req) => ({ text: "..." }),
  transcribeAudio: async (req) => ({ text: "..." }),
  describeVideo: async (req) => ({ text: "..." }),
});

• Orkestrasyonu, fallback’i, yapılandırmayı ve kanal bağlantılarını çekirdekte tutun.
• Tedarikçi davranışını sağlayıcı plugin’inde tutun.
• Eklemeli genişleme typed kalmalıdır: yeni isteğe bağlı yöntemler, yeni isteğe bağlı sonuç alanları, yeni isteğe bağlı capabilities.
• Video oluşturma zaten aynı deseni izler:
  • çekirdek capability contract’ına ve çalışma zamanı yardımcısına sahiptir
  • tedarikçi plugin’leri api.registerVideoGenerationProvider(...) kaydeder
  • özellik/kanal plugin’leri api.runtime.videoGeneration.* tüketir

const image = await api.runtime.mediaUnderstanding.describeImageFile({
  filePath: "/tmp/inbound-photo.jpg",
  cfg: api.config,
  agentDir: "/tmp/agent",
});

const video = await api.runtime.mediaUnderstanding.describeVideoFile({
  filePath: "/tmp/inbound-video.mp4",
  cfg: api.config,
});

const { text } = await api.runtime.mediaUnderstanding.transcribeAudioFile({
  filePath: "/tmp/inbound-audio.ogg",
  cfg: api.config,
  // Optional when MIME cannot be inferred reliably:
  mime: "audio/ogg",
});

• api.runtime.mediaUnderstanding.*, görüntü/ses/video anlama için tercih edilen paylaşılan yüzeydir.
• Çekirdek media-understanding ses yapılandırmasını (tools.media.audio) ve sağlayıcı fallback sırasını kullanır.
• Transkripsiyon çıktısı üretilmediğinde { text: undefined } döndürür (örneğin atlanan/desteklenmeyen girdi).
• api.runtime.stt.transcribeAudioFile(...) uyumluluk alias’ı olarak kalır.

const result = await api.runtime.subagent.run({
  sessionKey: "agent:main:subagent:search-helper",
  message: "Expand this query into focused follow-up searches.",
  provider: "openai",
  model: "gpt-4.1-mini",
  deliver: false,
});

• provider ve model, kalıcı oturum değişiklikleri değil, çalıştırma başına isteğe bağlı override’lardır.
• OpenClaw bu override alanlarını yalnızca güvenilir çağıranlar için dikkate alır.
• Plugin’e ait fallback çalıştırmaları için operatörler plugins.entries.<id>.subagent.allowModelOverride: true ile katılmalıdır.
• Güvenilir plugin’leri belirli canonical provider/model hedefleriyle sınırlamak için plugins.entries.<id>.subagent.allowedModels kullanın veya herhangi bir hedefe açıkça izin vermek için "*" kullanın.
• Güvenilir olmayan plugin alt aracı çalıştırmaları yine çalışır, ancak override istekleri sessizce fallback yapmak yerine reddedilir.
• Plugin tarafından oluşturulan alt aracı oturumları, oluşturan plugin kimliğiyle etiketlenir. Fallback api.runtime.subagent.deleteSession(...) yalnızca bu sahip olunan oturumları silebilir; rastgele oturum silme yine admin kapsamlı bir Gateway isteği gerektirir.

const providers = api.runtime.webSearch.listProviders({
  config: api.config,
});

const result = await api.runtime.webSearch.search({
  config: api.config,
  args: {
    query: "OpenClaw plugin runtime helpers",
    count: 5,
  },
});

• Sağlayıcı seçimini, kimlik bilgisi çözümlemesini ve paylaşılan istek semantiğini çekirdekte tutun.
• Tedarikçiye özgü arama aktarımları için web-search sağlayıcılarını kullanın.
• api.runtime.webSearch.*, aracı araç wrapper’ına bağımlı olmadan arama davranışına ihtiyaç duyan özellik/kanal plugin’leri için tercih edilen paylaşılan yüzeydir.

​

api.runtime.imageGeneration

const result = await api.runtime.imageGeneration.generate({
  config: api.config,
  args: { prompt: "A friendly lobster mascot", size: "1024x1024" },
});

const providers = api.runtime.imageGeneration.listProviders({
  config: api.config,
});

• generate(...): yapılandırılmış image-generation sağlayıcı zincirini kullanarak bir görüntü oluşturun.
• listProviders(...): kullanılabilir image-generation sağlayıcılarını ve capabilities’lerini listeleyin.

​

Gateway HTTP rotaları

api.registerHttpRoute({
  path: "/acme/webhook",
  auth: "plugin",
  match: "exact",
  handler: async (_req, res) => {
    res.statusCode = 200;
    res.end("ok");
    return true;
  },
});

• path: Gateway HTTP sunucusu altındaki rota yolu.
• auth: zorunludur. Normal gateway kimlik doğrulamasını gerektirmek için "gateway" veya plugin tarafından yönetilen kimlik doğrulama/webhook doğrulaması için "plugin" kullanın.
• match: isteğe bağlıdır. "exact" (varsayılan) veya "prefix".
• replaceExisting: isteğe bağlıdır. Aynı plugin’in kendi mevcut rota kaydını değiştirmesine izin verir.
• handler: rota isteği işlediğinde true döndürün.

• api.registerHttpHandler(...) kaldırıldı ve Plugin yükleme hatasına neden olur. Bunun yerine api.registerHttpRoute(...) kullanın.
• Plugin rotaları auth değerini açıkça bildirmelidir.
• Tam path + match çakışmaları, replaceExisting: true olmadığı sürece reddedilir ve bir Plugin başka bir Plugin’in rotasını değiştiremez.
• Farklı auth düzeylerine sahip çakışan rotalar reddedilir. exact/prefix fallthrough zincirlerini yalnızca aynı auth düzeyinde tutun.
• auth: "plugin" rotaları, operatör çalışma zamanı kapsamlarını otomatik olarak almaz. Bunlar ayrıcalıklı Gateway yardımcı çağrıları için değil, Plugin tarafından yönetilen Webhook’lar/imza doğrulaması içindir.
• auth: "gateway" rotaları bir Gateway isteği çalışma zamanı kapsamı içinde çalışır, ancak bu kapsam bilinçli olarak tutucudur:
  • paylaşılan-gizli bearer auth (gateway.auth.mode = "token" / "password"), çağıran x-openclaw-scopes gönderse bile Plugin rotası çalışma zamanı kapsamlarını operator.write değerine sabitler
  • güvenilir kimlik taşıyan HTTP modları (örneğin özel bir ingress üzerinde trusted-proxy veya gateway.auth.mode = "none"), x-openclaw-scopes değerini yalnızca başlık açıkça mevcut olduğunda dikkate alır
  • bu kimlik taşıyan Plugin rotası isteklerinde x-openclaw-scopes yoksa, çalışma zamanı kapsamı operator.write değerine geri döner
• Pratik kural: gateway-auth Plugin rotasının örtük bir yönetici yüzeyi olduğunu varsaymayın. Rotanız yöneticiye özel davranış gerektiriyorsa, kimlik taşıyan bir auth modu gerektirin ve açık x-openclaw-scopes başlığı sözleşmesini belgeleyin.

​

Plugin SDK içe aktarma yolları

• index.js — paketlenmiş Plugin girişi
• api.js — yardımcı/tip barrel’ı
• runtime-api.js — yalnızca çalışma zamanı barrel’ı
• setup-entry.js — kurulum Plugin girişi

​

Mesaj aracı şemaları

• semantik sunum blokları (text, context, divider, buttons, select) için presentation
• sabitlenmiş teslim istekleri için delivery-pin

​

Kanal hedefi çözümleme

• messaging.inferTargetChatType({ to }), normalleştirilmiş bir hedefin dizin aramasından önce direct, group veya channel olarak ele alınıp alınmayacağına karar verir.
• messaging.targetResolver.looksLikeId(raw, normalized), çekirdeğe bir girdinin dizin araması yerine doğrudan id-benzeri çözümlemeye atlanıp atlanmaması gerektiğini bildirir.
• messaging.targetResolver.resolveTarget(...), çekirdeğin normalleştirmeden sonra veya bir dizin kaçırmasından sonra sağlayıcıya ait nihai bir çözümlemeye ihtiyaç duyduğu durumda Plugin fallback’idir.
• messaging.resolveOutboundSessionRoute(...), bir hedef çözümlendikten sonra sağlayıcıya özgü oturum rotası oluşturmayı üstlenir.

• Eşleri/grupları aramadan önce gerçekleşmesi gereken kategori kararları için inferTargetChatType kullanın.
• “bunu açık/yerel hedef id olarak ele al” kontrolleri için looksLikeId kullanın.
• Geniş dizin araması için değil, sağlayıcıya özgü normalleştirme fallback’i için resolveTarget kullanın.
• Sohbet id’leri, thread id’leri, JID’ler, handle’lar ve oda id’leri gibi sağlayıcıya özgü yerel id’leri genel SDK alanlarında değil, target değerleri veya sağlayıcıya özgü parametreler içinde tutun.

​

Config destekli dizinler

• allowlist odaklı DM eşleri
• yapılandırılmış kanal/grup haritaları
• hesaba kapsamlı statik dizin fallback’leri

• sorgu filtreleme
• limit uygulama
• tekilleştirme/normalleştirme yardımcıları
• ChannelDirectoryEntry[] oluşturma

​

Sağlayıcı katalogları

• tek bir sağlayıcı girdisi için { provider }
• birden çok sağlayıcı girdisi için { providers }

• simple: düz API anahtarı veya env odaklı sağlayıcılar
• profile: auth profilleri mevcut olduğunda görünen sağlayıcılar
• paired: birden çok ilişkili sağlayıcı girdisi sentezleyen sağlayıcılar
• late: diğer örtük sağlayıcılardan sonra son geçiş

• discovery eski bir alias olarak çalışmaya devam eder, ancak kullanımdan kaldırma uyarısı yayar
• hem catalog hem discovery kayıtlıysa OpenClaw catalog kullanır
• augmentModelCatalog kullanımdan kaldırılmıştır; paketlenmiş sağlayıcılar ek satırları registerModelCatalogProvider üzerinden yayımlamalıdır

​

Salt okunur kanal incelemesi

• resolveAccount(...) çalışma zamanı yoludur. Kimlik bilgilerinin tamamen somutlaştırıldığını varsaymasına izin verilir ve gerekli secret’lar eksik olduğunda hızlıca başarısız olabilir.
• openclaw status, openclaw status --all, openclaw channels status, openclaw channels resolve ve doctor/config onarım akışları gibi salt okunur komut yolları, yalnızca yapılandırmayı açıklamak için çalışma zamanı kimlik bilgilerini somutlaştırmak zorunda olmamalıdır.

• Yalnızca açıklayıcı hesap durumu döndürün.
• enabled ve configured değerlerini koruyun.
• İlgili olduğunda şu gibi kimlik bilgisi kaynağı/durum alanlarını dahil edin:
  • tokenSource, tokenStatus
  • botTokenSource, botTokenStatus
  • appTokenSource, appTokenStatus
  • signingSecretSource, signingSecretStatus
• Salt okunur kullanılabilirliği raporlamak için ham token değerlerini döndürmeniz gerekmez. tokenStatus: "available" (ve eşleşen kaynak alanını) döndürmek status tarzı komutlar için yeterlidir.
• Bir kimlik bilgisi SecretRef üzerinden yapılandırılmış ancak mevcut komut yolunda kullanılamıyorsa configured_unavailable kullanın.

​

Paket pack’leri

{
  "name": "my-pack",
  "openclaw": {
    "extensions": ["./src/safety.ts", "./src/tools.ts"],
    "setupEntry": "./src/setup-entry.ts"
  }
}

• kanal kaydının kendisi
• Gateway dinlemeye başlamadan önce kullanılabilir olması gereken tüm HTTP rotaları
• aynı zaman aralığında var olması gereken tüm Gateway yöntemleri, araçları veya hizmetleri

• singleAccountKeysToMove
• namedAccountPromotionKeys
• resolveSingleAccountPromotionTarget(...)

{
  "name": "@scope/my-channel",
  "openclaw": {
    "extensions": ["./index.ts"],
    "setupEntry": "./setup-entry.ts",
    "startup": {
      "deferConfiguredChannelFullLoadUntilAfterListen": true
    }
  }
}

​

Kanal katalog metadata’sı

{
  "name": "@openclaw/nextcloud-talk",
  "openclaw": {
    "extensions": ["./index.ts"],
    "channel": {
      "id": "nextcloud-talk",
      "label": "Nextcloud Talk",
      "selectionLabel": "Nextcloud Talk (self-hosted)",
      "docsPath": "/channels/nextcloud-talk",
      "docsLabel": "nextcloud-talk",
      "blurb": "Self-hosted chat via Nextcloud Talk webhook bots.",
      "order": 65,
      "aliases": ["nc-talk", "nc"]
    },
    "install": {
      "npmSpec": "@openclaw/nextcloud-talk",
      "localPath": "<bundled-plugin-local-path>",
      "defaultChoice": "npm"
    }
  }
}

• detailLabel: daha zengin katalog/durum yüzeyleri için ikincil etiket
• docsLabel: docs bağlantısı için bağlantı metnini geçersiz kılar
• preferOver: bu katalog girdisinin önüne geçmesi gereken daha düşük öncelikli Plugin/kanal kimlikleri
• selectionDocsPrefix, selectionDocsOmitLabel, selectionExtras: seçim-yüzeyi metin kontrolleri
• markdownCapable: giden biçimlendirme kararları için kanalı markdown-capable olarak işaretler
• exposure.configured: false olarak ayarlandığında kanalı yapılandırılmış-kanal listeleme yüzeylerinden gizler
• exposure.setup: false olarak ayarlandığında kanalı etkileşimli setup/configure seçicilerinden gizler
• exposure.docs: kanalı docs gezinme yüzeyleri için internal/private olarak işaretler
• showConfigured / showInSetup: uyumluluk için hâlâ kabul edilen eski alias’lar; exposure tercih edin
• quickstartAllowFrom: kanalı standart quickstart allowFrom akışına dahil eder
• forceAccountBinding: yalnızca bir hesap olsa bile açık hesap bağlamayı zorunlu kılar
• preferSessionLookupForAnnounceTarget: announce target’ları çözerken session lookup’ı tercih eder

• ~/.openclaw/mpm/plugins.json
• ~/.openclaw/mpm/catalog.json
• ~/.openclaw/plugins/catalog.json

​

Context engine Plugin’leri

import { buildMemorySystemPromptAddition } from "openclaw/plugin-sdk/core";

export default function (api) {
  api.registerContextEngine("lossless-claw", (ctx) => ({
    info: { id: "lossless-claw", name: "Lossless Claw", ownsCompaction: true },
    async ingest() {
      return { ingested: true };
    },
    async assemble({ messages, availableTools, citationsMode }) {
      return {
        messages,
        estimatedTokens: 0,
        systemPromptAddition: buildMemorySystemPromptAddition({
          availableTools: availableTools ?? new Set(),
          citationsMode,
        }),
      };
    },
    async compact() {
      return { ok: true, compacted: false };
    },
  }));
}

import {
  buildMemorySystemPromptAddition,
  delegateCompactionToRuntime,
} from "openclaw/plugin-sdk/core";

export default function (api) {
  api.registerContextEngine("my-memory-engine", (ctx) => ({
    info: {
      id: "my-memory-engine",
      name: "My Memory Engine",
      ownsCompaction: false,
    },
    async ingest() {
      return { ingested: true };
    },
    async assemble({ messages, availableTools, citationsMode }) {
      return {
        messages,
        estimatedTokens: 0,
        systemPromptAddition: buildMemorySystemPromptAddition({
          availableTools: availableTools ?? new Set(),
          citationsMode,
        }),
      };
    },
    async compact(params) {
      return await delegateCompactionToRuntime(params);
    },
  }));
}

​

Yeni bir capability ekleme

1. çekirdek sözleşmeyi tanımlayın Çekirdeğin hangi ortak davranışa sahip olması gerektiğine karar verin: politika, fallback, config merge, lifecycle, kanala dönük semantik ve runtime helper şekli.
2. typed Plugin registration/runtime yüzeyleri ekleyin OpenClawPluginApi ve/veya api.runtime değerini en küçük kullanışlı typed capability yüzeyiyle genişletin.
3. çekirdek + kanal/özellik tüketicilerini bağlayın Kanallar ve özellik Plugin’leri, yeni capability’yi doğrudan bir vendor uygulamasını import ederek değil, çekirdek üzerinden tüketmelidir.
4. vendor uygulamalarını kaydedin Vendor Plugin’leri ardından backend’lerini capability’ye göre kaydeder.
5. sözleşme kapsamı ekleyin Sahiplik ve kayıt şeklinin zaman içinde açık kalması için testler ekleyin.

​

Capability checklist’i

• src/<capability>/types.ts içinde çekirdek sözleşme tipleri
• src/<capability>/runtime.ts içinde çekirdek runner/runtime helper
• src/plugins/types.ts içinde Plugin API registration yüzeyi
• src/plugins/registry.ts içinde Plugin registry wiring
• özellik/kanal Plugin’lerinin bunu tüketmesi gerektiğinde src/plugins/runtime/* içinde Plugin runtime exposure
• src/test-utils/plugin-registration.ts içinde capture/test helper’ları
• src/plugins/contracts/registry.ts içinde ownership/contract assertion’ları
• docs/ içinde operator/Plugin docs

​

Capability template’i

// core contract
export type VideoGenerationProviderPlugin = {
  id: string;
  label: string;
  generateVideo: (req: VideoGenerationRequest) => Promise<VideoGenerationResult>;
};

// plugin API
api.registerVideoGenerationProvider({
  id: "openai",
  label: "OpenAI",
  async generateVideo(req) {
    return await generateOpenAiVideo(req);
  },
});

// shared runtime helper for feature/channel plugins
const clip = await api.runtime.videoGeneration.generate({
  prompt: "Show the robot walking through the lab.",
  cfg,
});

expect(findVideoGenerationProviderIdsForPlugin("openai")).toEqual(["openai"]);

• çekirdek capability sözleşmesine + orkestrasyona sahiptir
• vendor Plugin’leri vendor uygulamalarına sahiptir
• özellik/kanal Plugin’leri runtime helper’ları tüketir
• contract test’leri sahipliği açık tutar

​

İlgili

• Plugin mimarisi — public capability modeli ve şekilleri
• Plugin SDK alt yolları
• Plugin SDK kurulumu
• Plugin oluşturma