Plugin mimarisinin iç işleyişi

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.

​

Yükleme işlem hattı

1. aday Plugin köklerini keşfeder
2. yerel veya uyumlu bundle manifestlerini ve package metadata’sını 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. etkin yerel modülleri yükler: derlenmiş paketli modüller yerel bir loader kullanır; üçüncü taraf yerel kaynak TypeScript acil durum Jiti fallback’ini kullanır
7. yerel register(api) hook’larını çağırır ve kayıtları Plugin registry’sinde toplar
8. registry’yi komutlara/runtime yüzeylerine açar

​

Manifest öncelikli davranış

• Plugin’i tanımlamak
• bildirilen channels/skills/config schema veya bundle capability’lerini keşfetmek
• plugins.entries.<id>.config değerini doğrulamak
• Control UI etiketlerini/placeholder’larını zenginleştirmek
• kurulum/katalog metadata’sını göstermek
• Plugin runtime’ını yüklemeden ucuz aktivasyon ve kurulum descriptor’larını korumak

• CLI yüklemesi, istenen primary command’a sahip Plugin’lerle sınırlandırılır
• channel setup/Plugin çözümlemesi, istenen channel id’ye sahip Plugin’lerle sınırlandırılır
• açık provider setup/runtime çözümlemesi, istenen provider id’ye sahip Plugin’lerle sınırlandırılır
• Gateway başlangıç planlaması, açık başlangıç import’ları ve başlangıç opt-out’ları için activation.onStartup kullanır; başlangıç metadata’sı olmayan Plugin’ler yalnızca daha dar aktivasyon tetikleyicileriyle yüklenir

​

Plugin cache sınırı

• PluginLoaderCacheState ve uyumlu etkin runtime registry’leri
• aynı runtime yüzeyini tekrar tekrar import etmekten kaçınmak için kullanılan jiti/module cache’leri ve public-surface loader cache’leri
• kurulu Plugin artifact’leri için filesystem cache’leri
• path normalizasyonu veya duplicate çözümlemesi için kısa ömürlü çağrı başına map’ler

• keşif sonuçları
• doğrudan manifest registry’leri
• kurulu Plugin index’inden yeniden oluşturulan manifest registry’leri
• provider owner lookup, model suppression, provider policy veya public-artifact metadata’sı
• değişen bir manifest, kurulu index veya load path’in bir sonraki metadata okumasında görünür olması gereken manifest’ten türetilmiş diğer herhangi bir yanıt

​

Registry modeli

• Plugin kayıtları (identity, source, origin, status, diagnostics)
• tools
• legacy hook’lar ve typed hook’lar
• channels
• providers
• gateway RPC handler’ları
• HTTP rotaları
• CLI registrar’ları
• background service’leri
• Plugin’e ait commands

• Plugin module -> registry registration
• core runtime -> registry consumption

​

Conversation binding callback’leri

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: onaylanan request’ler için çözümlenmiş binding
• request: özgün request özeti, detach ipucu, sender id ve conversation metadata’sı

​

Provider runtime hook’ları

• Ucuz pre-runtime lookup için manifest metadata’sı: setup.providers[].envVars, kullanımdan kaldırılmış uyumluluk providerAuthEnvVars, providerAuthAliases, providerAuthChoices ve channelEnvVars.
• Config-time hook’ları: catalog (legacy discovery) artı applyConfigDefaults.
• Runtime hook’ları: auth, model resolution, stream wrapping, thinking levels, replay policy ve usage endpoint’lerini kapsayan 40+ 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/ses notu yüzeyleri için normal çekirdek TTS çıktı yükünü döndürür.
• Çekirdek messages.tts yapılandırmasını ve sağlayıcı seçimini kullanır.
• PCM ses arabelleği + örnekleme hızı döndürür. Plugin’ler sağlayıcılar için yeniden örnekleme/kodlama yapmalıdır.
• listVoices sağlayıcı başına isteğe bağlıdır. Tedarikçi tarafından sahip olunan ses seçiciler veya kurulum akışları için kullanın.
• Ses listeleri, sağlayıcıdan haberdar seçiciler için yerel ayar, cinsiyet ve kişilik etiketleri gibi daha zengin meta veriler 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ı, geri dönüşü ve yanıt teslimini çekirdekte tutun.
• Tedarikçiye ait 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: tek bir tedarikçi Plugin’i, OpenClaw bu yetenek sözleşmelerini ekledikçe metin, konuşma, görüntü ve gelecekteki medya sağlayıcılarını üstlenebilir.

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

• Orkestrasyonu, geri dönüşü, yapılandırmayı ve kanal kablolamasını çekirdekte tutun.
• Tedarikçi davranışını sağlayıcı Plugin’inde tutun.
• Eklemeli genişleme türlendirilmiş kalmalıdır: yeni isteğe bağlı yöntemler, yeni isteğe bağlı sonuç alanları, yeni isteğe bağlı yetenekler.
• Video üretimi zaten aynı kalıbı izler:
  • çekirdek, yetenek sözleşmesini ve çalışma zamanı yardımcısını üstlenir
  • tedarikçi Plugin’leri api.registerVideoGenerationProvider(...) kaydeder
  • özellik/kanal Plugin’leri api.runtime.videoGeneration.* kullanır

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 extraction = await api.runtime.mediaUnderstanding.extractStructuredWithModel({
  provider: "codex",
  model: "gpt-5.5",
  input: [
    {
      type: "image",
      buffer: receiptImageBuffer,
      fileName: "receipt.png",
      mime: "image/png",
    },
    { type: "text", text: "Use the printed fields as the source of truth." },
  ],
  instructions: "Return entities and searchable tags.",
  schemaName: "example.evidence",
  jsonSchema: {
    type: "object",
    properties: {
      entities: { type: "array", items: { type: "string" } },
      tags: { type: "array", items: { type: "string" } },
    },
  },
  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.
• extractStructuredWithModel(...), sınırlandırılmış sağlayıcıya ait görüntü öncelikli çıkarım için Plugin’e dönük sınırdır. En az bir görüntü girdisi ekleyin; metin girdileri tamamlayıcı bağlamdır. Ürün Plugin’leri kendi rotalarını ve şemalarını üstlenirken OpenClaw sağlayıcı/çalışma zamanı sınırını üstlenir.
• Çekirdek medya anlama ses yapılandırmasını (tools.media.audio) ve sağlayıcı geri dönüş sırasını kullanır.
• Hiçbir döküm çıktısı üretilmediğinde (örneğin atlanan/desteklenmeyen girdi) { text: undefined } döndürür.
• 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ı geçersiz kılmalardır.
• OpenClaw bu geçersiz kılma alanlarını yalnızca güvenilir çağıranlar için dikkate alır.
• Plugin’e ait geri dönüş çalıştırmaları için operatörler plugins.entries.<id>.subagent.allowModelOverride: true ile açıkça kabul etmelidir.
• Güvenilir Plugin’leri belirli kanonik 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üvenilmeyen Plugin alt ajan çalıştırmaları yine çalışır, ancak geçersiz kılma istekleri sessizce geri düşmek yerine reddedilir.
• Plugin tarafından oluşturulan alt ajan oturumları, oluşturan Plugin kimliğiyle etiketlenir. Geri dönüş api.runtime.subagent.deleteSession(...) yalnızca bu sahip olunan oturumları silebilir; rastgele oturum silme hâlâ yönetici kapsamlı 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 taşımaları için web arama sağlayıcılarını kullanın.
• api.runtime.webSearch.*, ajan araç sarmalayıcısına bağlı kalmadan 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ış görüntü üretimi sağlayıcı zincirini kullanarak bir görüntü üretir.
• listProviders(...): kullanılabilir görüntü üretimi sağlayıcılarını ve yeteneklerini listeler.

​

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: zorunlu. Normal Gateway kimlik doğrulamasını gerektirmek için "gateway" veya Plugin tarafından yönetilen kimlik doğrulaması/Webhook doğrulaması için "plugin" kullanın.
• match: isteğe bağlı. "exact" (varsayılan) veya "prefix".
• replaceExisting: isteğe bağlı. 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ıkça reddedilir ve bir Plugin başka bir Plugin’in rotasının yerine geçemez.
• Farklı auth düzeylerine sahip örtüşen rotalar reddedilir. exact/prefix geri düşüş zincirlerini yalnızca aynı kimlik doğrulama 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 özellikle tutucu tasarlanmıştır:
  • paylaşılan gizli bearer kimlik doğrulaması (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 girişte trusted-proxy veya gateway.auth.mode = "none"), yalnızca üstbilgi açıkça mevcut olduğunda x-openclaw-scopes değerini dikkate alır
  • bu kimlik taşıyan Plugin rotası isteklerinde x-openclaw-scopes yoksa, çalışma zamanı kapsamı operator.write değerine geri düşer
• Pratik kural: gateway kimlik doğrulamalı bir 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 kimlik doğrulama modu gerektirin ve açık x-openclaw-scopes üstbilgi sözleşmesini belgeleyin.

​

Plugin SDK içe aktarma yolları

• index.js — paketlenmiş Plugin girişi
• api.js — yardımcı/tür 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 hedef çö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), bir girdinin dizin araması yerine doğrudan kimlik benzeri çözümlemeye geçip geçmemesi gerektiğini çekirdeğe söyler.
• messaging.targetResolver.resolveTarget(...), çekirdeğin normalleştirmeden sonra veya dizin kaçırmasından sonra son sağlayıcıya ait çözümlemeye ihtiyaç duyması halinde Plugin geri düşüşüdür.
• messaging.resolveOutboundSessionRoute(...), 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 kimliği olarak ele al” kontrolleri için looksLikeId kullanın.
• Geniş dizin araması için değil, sağlayıcıya özgü normalleştirme geri düşüşü için resolveTarget kullanın.
• Sohbet kimlikleri, iş parçacığı kimlikleri, JID’ler, tanıtıcılar ve oda kimlikleri gibi sağlayıcıya özgü yerel kimlikleri genel SDK alanlarında değil, target değerleri veya sağlayıcıya özgü parametreler içinde tutun.

​

Yapılandırma destekli dizinler

• izin listesi odaklı DM eşleri
• yapılandırılmış kanal/grup eşlemeleri
• hesaba kapsamlı statik dizin geri düşüşleri

• sorgu filtreleme
• sınır uygulaması
• 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: kimlik doğrulama profilleri olduğunda görünen sağlayıcılar
• paired: birden çok ilişkili sağlayıcı girdisi sentezleyen sağlayıcılar
• late: son geçiş, diğer örtük sağlayıcılardan sonra

• discovery eski bir takma ad olarak çalışmaya devam eder, ancak kullanımdan kaldırma uyarısı yayar
• hem catalog hem de 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 aracılığıyla 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 gibi salt okunur komut yolları ve doctor/yapılandırma onarım akışları, yalnızca yapılandırmayı açıklamak için çalışma zamanı kimlik bilgilerini somutlaştırmaya ihtiyaç duymamalıdır.

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

​

Paket paketleri

{
  "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 HTTP rotaları
• aynı zaman aralığında var olması gereken 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 meta verileri

{
  "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: doküman 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 id’leri
• selectionDocsPrefix, selectionDocsOmitLabel, selectionExtras: seçim-yüzeyi metin denetimleri
• markdownCapable: giden biçimlendirme kararları için kanalı markdown-yetenekli 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 kurulum/yapılandırma seçicilerinden gizler
• exposure.docs: doküman gezinme yüzeyleri için kanalı dahili/özel olarak işaretler
• showConfigured / showInSetup: uyumluluk için hâlâ kabul edilen eski takma adlar; exposure tercih edin
• quickstartAllowFrom: kanalı standart hızlı başlangıç allowFrom akışına dahil eder
• forceAccountBinding: yalnızca bir hesap mevcut olsa bile açık hesap bağlamayı zorunlu kılar
• preferSessionLookupForAnnounceTarget: duyuru hedefleri çözümlenirken oturum aramayı tercih eder

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

​

Bağlam motoru 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 yetenek ekleme

1. çekirdek sözleşmesini tanımlayın Çekirdeğin hangi paylaşılan davranışa sahip olması gerektiğine karar verin: ilke, geri dönüş, yapılandırma birleştirme, yaşam döngüsü, kanala dönük semantik ve çalışma zamanı yardımcı şekli.
2. tipli plugin kaydı/çalışma zamanı yüzeyleri ekleyin OpenClawPluginApi ve/veya api.runtime öğesini en küçük kullanışlı tipli yetenek yüzeyiyle genişletin.
3. çekirdek + kanal/özellik tüketicilerini bağlayın Kanallar ve özellik plugin’leri yeni yeteneği, bir satıcı uygulamasını doğrudan içe aktarmak yerine çekirdek üzerinden tüketmelidir.
4. satıcı uygulamalarını kaydedin Ardından satıcı plugin’leri kendi arka uçlarını yeteneğe kaydeder.
5. sözleşme kapsamı ekleyin Sahiplik ve kayıt şeklinin zaman içinde açık kalması için testler ekleyin.

​

Yetenek denetim listesi

• src/<capability>/types.ts içindeki çekirdek sözleşme türleri
• src/<capability>/runtime.ts içindeki çekirdek çalıştırıcı/çalışma zamanı yardımcısı
• src/plugins/types.ts içindeki plugin API kayıt yüzeyi
• src/plugins/registry.ts içindeki plugin kayıt defteri bağlaması
• özellik/kanal plugin’lerinin tüketmesi gerektiğinde src/plugins/runtime/* içindeki plugin çalışma zamanı açığa çıkarımı
• src/test-utils/plugin-registration.ts içindeki yakalama/test yardımcıları
• src/plugins/contracts/registry.ts içindeki sahiplik/sözleşme doğrulamaları
• docs/ içindeki operatör/plugin dokümanları

​

Yetenek şablonu

// 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, yetenek sözleşmesine + orkestrasyona sahiptir
• satıcı plugin’leri satıcı uygulamalarına sahiptir
• özellik/kanal plugin’leri çalışma zamanı yardımcılarını tüketir
• sözleşme testleri sahipliği açık tutar

​

İlgili

• Plugin mimarisi — genel yetenek modeli ve şekiller
• Plugin SDK alt yolları
• Plugin SDK kurulumu
• Plugin oluşturma