​

Internal Plugin

​

Model kapabilitas publik

​

Sikap kompatibilitas eksternal

• plugin eksternal yang sudah ada: pertahankan integrasi berbasis hook tetap berfungsi; perlakukan ini sebagai baseline kompatibilitas
• plugin bundled/native baru: utamakan pendaftaran kapabilitas yang eksplisit daripada akses vendor-spesifik ke internal atau desain hook-only baru
• plugin eksternal yang mengadopsi pendaftaran kapabilitas: diperbolehkan, tetapi perlakukan surface helper khusus kapabilitas sebagai sesuatu yang berkembang kecuali dokumentasi secara eksplisit menandai kontrak sebagai stabil

• API pendaftaran kapabilitas adalah arah yang dituju
• hook legacy tetap menjadi jalur paling aman tanpa kerusakan untuk plugin eksternal selama masa transisi
• tidak semua subpath helper yang diekspor setara; pilih kontrak sempit yang didokumentasikan, bukan ekspor helper insidental

​

Bentuk plugin

• plain-capability — mendaftarkan tepat satu tipe kapabilitas (misalnya plugin provider-only seperti mistral)
• hybrid-capability — mendaftarkan beberapa tipe kapabilitas (misalnya openai memiliki inferensi teks, ucapan, pemahaman media, dan pembuatan gambar)
• hook-only — hanya mendaftarkan hook (tertik atau kustom), tanpa kapabilitas, tool, perintah, atau layanan
• non-capability — mendaftarkan tool, perintah, layanan, atau rute tetapi tanpa kapabilitas

​

Hook legacy

• pertahankan agar tetap berfungsi
• dokumentasikan sebagai legacy
• utamakan before_model_resolve untuk pekerjaan override model/provider
• utamakan before_prompt_build untuk pekerjaan mutasi prompt
• hapus hanya setelah penggunaan nyata menurun dan cakupan fixture membuktikan keamanan migrasi

​

Sinyal kompatibilitas

​

Ikhtisar arsitektur

1. Manifest + discovery OpenClaw menemukan kandidat plugin dari path yang dikonfigurasi, root workspace, root extension global, dan extension bundled. Discovery membaca manifest native openclaw.plugin.json serta manifest bundle yang didukung terlebih dahulu.
2. Enablement + validation Core memutuskan apakah plugin yang ditemukan diaktifkan, dinonaktifkan, diblokir, atau dipilih untuk slot eksklusif seperti memory.
3. Runtime loading Plugin OpenClaw native dimuat in-process melalui jiti dan mendaftarkan kapabilitas ke registri pusat. Bundle yang kompatibel dinormalisasi menjadi catatan registri tanpa mengimpor kode runtime.
4. Surface consumption Bagian lain dari OpenClaw membaca registri untuk mengekspos tool, channel, penyiapan provider, hook, rute HTTP, perintah CLI, dan layanan.

• metadata saat parse berasal dari registerCli(..., { descriptors: [...] })
• modul CLI plugin yang sebenarnya dapat tetap lazy dan mendaftar pada pemanggilan pertama

• discovery + validasi konfigurasi harus bekerja dari metadata manifest/schema tanpa mengeksekusi kode plugin
• perilaku runtime native berasal dari jalur register(api) modul plugin

​

Plugin channel dan tool pesan bersama

• core memiliki host tool message bersama, wiring prompt, pembukuan sesi/thread, dan dispatch eksekusi
• plugin channel memiliki discovery aksi berscope, discovery kapabilitas, dan fragmen schema khusus channel
• plugin channel memiliki grammar percakapan sesi khusus provider, seperti bagaimana id percakapan mengodekan id thread atau mewarisi dari percakapan induk
• plugin channel mengeksekusi aksi akhir melalui adaptor aksi mereka

• accountId
• currentChannelId
• currentThreadTs
• currentMessageId
• sessionKey
• sessionId
• agentId
• requesterSenderId inbound tepercaya

• outbound.sendPoll adalah baseline bersama untuk channel yang cocok dengan model poll umum
• actions.handleAction("poll") adalah jalur yang diutamakan untuk semantik poll khusus channel atau param poll tambahan

​

Model kepemilikan kapabilitas

• plugin perusahaan biasanya harus memiliki semua surface OpenClaw yang menghadap perusahaan tersebut
• plugin fitur biasanya harus memiliki seluruh surface fitur yang diperkenalkannya
• channel harus mengonsumsi kapabilitas core bersama alih-alih mengimplementasikan ulang perilaku provider secara ad hoc

• plugin openai bundled memiliki perilaku model-provider OpenAI dan perilaku ucapan + suara realtime + pemahaman media + pembuatan gambar OpenAI
• plugin elevenlabs bundled memiliki perilaku ucapan ElevenLabs
• plugin microsoft bundled memiliki perilaku ucapan Microsoft
• plugin google bundled memiliki perilaku model-provider Google ditambah perilaku pemahaman media + pembuatan gambar + pencarian web Google
• plugin firecrawl bundled memiliki perilaku pengambilan web Firecrawl
• plugin minimax, mistral, moonshot, dan zai bundled memiliki backend pemahaman media mereka
• plugin qwen bundled memiliki perilaku text-provider Qwen ditambah perilaku pemahaman media dan pembuatan video
• plugin voice-call adalah plugin fitur: plugin ini memiliki transport panggilan, tool, CLI, rute, dan bridging media-stream Twilio, tetapi plugin ini mengonsumsi kapabilitas ucapan bersama ditambah transkripsi realtime dan suara realtime alih-alih mengimpor plugin vendor secara langsung

• OpenAI berada dalam satu plugin meskipun mencakup model teks, ucapan, gambar, dan video di masa depan
• vendor lain dapat melakukan hal yang sama untuk cakupan surface miliknya sendiri
• channel tidak peduli plugin vendor mana yang memiliki provider; mereka mengonsumsi kontrak kapabilitas bersama yang diekspos oleh core

• plugin = batas kepemilikan
• capability = kontrak core yang dapat diimplementasikan atau dikonsumsi oleh beberapa plugin

1. definisikan kapabilitas yang belum ada di core
2. ekspos kapabilitas itu melalui API/runtime plugin dengan cara yang tertik
3. hubungkan channel/fitur ke kapabilitas itu
4. biarkan plugin vendor mendaftarkan implementasi

​

Pelapisan kapabilitas

• lapisan kapabilitas core: orkestrasi bersama, kebijakan, fallback, konfigurasi aturan merge, semantik pengiriman, dan kontrak bertipe
• lapisan plugin vendor: API vendor-spesifik, autentikasi, katalog model, ucapan sintesis, pembuatan gambar, backend video masa depan, endpoint penggunaan
• lapisan plugin channel/fitur: integrasi Slack/Discord/voice-call/dll. yang mengonsumsi kapabilitas core dan menyajikannya pada suatu surface

• core memiliki kebijakan TTS saat balasan, urutan fallback, preferensi, dan pengiriman channel
• openai, elevenlabs, dan microsoft memiliki implementasi sintesis
• voice-call mengonsumsi helper runtime TTS teleponi

​

Contoh plugin perusahaan multi-kapabilitas

import type { OpenClawPluginDefinition } from "openclaw/plugin-sdk/plugin-entry";
import {
  describeImageWithModel,
  transcribeOpenAiCompatibleAudio,
} from "openclaw/plugin-sdk/media-understanding";

const plugin: OpenClawPluginDefinition = {
  id: "exampleai",
  name: "ExampleAI",
  register(api) {
    api.registerProvider({
      id: "exampleai",
      // auth/model catalog/runtime hooks
    });

    api.registerSpeechProvider({
      id: "exampleai",
      // vendor speech config — implement the SpeechProviderPlugin interface directly
    });

    api.registerMediaUnderstandingProvider({
      id: "exampleai",
      capabilities: ["image", "audio", "video"],
      async describeImage(req) {
        return describeImageWithModel({
          provider: "exampleai",
          model: req.model,
          input: req.input,
        });
      },
      async transcribeAudio(req) {
        return transcribeOpenAiCompatibleAudio({
          provider: "exampleai",
          model: req.model,
          input: req.input,
        });
      },
    });

    api.registerWebSearchProvider(
      createPluginBackedWebSearchProvider({
        id: "exampleai-search",
        // credential + fetch logic
      }),
    );
  },
};

export default plugin;

• satu plugin memiliki surface vendor
• core tetap memiliki kontrak kapabilitas
• channel dan plugin fitur mengonsumsi helper api.runtime.*, bukan kode vendor
• pengujian kontrak dapat menegaskan bahwa plugin telah mendaftarkan kapabilitas yang diklaimnya sebagai miliknya

​

Contoh kapabilitas: pemahaman video

1. core mendefinisikan kontrak pemahaman media
2. plugin vendor mendaftarkan describeImage, transcribeAudio, dan describeVideo sesuai kebutuhan
3. channel dan plugin fitur mengonsumsi perilaku core bersama alih-alih menghubungkan langsung ke kode vendor

​

Kontrak dan enforcement

• penulis plugin mendapatkan satu standar internal yang stabil
• core dapat menolak kepemilikan ganda seperti dua plugin yang mendaftarkan id provider yang sama
• startup dapat menampilkan diagnostik yang dapat ditindaklanjuti untuk pendaftaran yang malformed
• pengujian kontrak dapat menegakkan kepemilikan plugin bundled dan mencegah drift diam-diam

1. enforcement pendaftaran runtime Registri plugin memvalidasi pendaftaran saat plugin dimuat. Contoh: id provider ganda, id speech provider ganda, dan pendaftaran yang malformed menghasilkan diagnostik plugin alih-alih perilaku yang tidak terdefinisi.
2. pengujian kontrak Plugin bundled ditangkap dalam registri kontrak selama pengujian berjalan sehingga OpenClaw dapat menegaskan kepemilikan secara eksplisit. Saat ini ini digunakan untuk model provider, speech provider, web search provider, dan kepemilikan pendaftaran bundled.

​

Apa yang termasuk dalam sebuah kontrak

• bertipe
• kecil
• spesifik terhadap kapabilitas
• dimiliki oleh core
• dapat digunakan ulang oleh beberapa plugin
• dapat dikonsumsi oleh channel/fitur tanpa pengetahuan vendor

• kebijakan vendor-spesifik yang tersembunyi di core
• jalur lolos plugin sekali pakai yang melewati registri
• kode channel yang langsung masuk ke implementasi vendor
• objek runtime ad hoc yang bukan bagian dari OpenClawPluginApi atau api.runtime

​

Model eksekusi

• plugin native dapat mendaftarkan tool, network handler, hook, dan layanan
• bug pada plugin native dapat membuat gateway crash atau tidak stabil
• plugin native yang berbahaya setara dengan eksekusi kode arbitrer di dalam proses OpenClaw

• plugins.allow mempercayai id plugin, bukan asal sumbernya.
• Plugin workspace dengan id yang sama seperti plugin bundled dengan sengaja membayangi salinan bundled ketika plugin workspace itu diaktifkan/masuk allowlist.
• Ini normal dan berguna untuk pengembangan lokal, pengujian patch, dan hotfix.

​

Batas ekspor

• subpath helper khusus plugin bundled
• subpath plumbing runtime yang tidak dimaksudkan sebagai API publik
• helper kemudahan vendor-spesifik
• helper penyiapan/onboarding yang merupakan detail implementasi

​

Pipeline pemuatan

1. menemukan root plugin kandidat
2. membaca manifest native atau bundle yang kompatibel dan metadata paket
3. menolak kandidat yang tidak aman
4. menormalisasi konfigurasi plugin (plugins.enabled, allow, deny, entries, slots, load.paths)
5. memutuskan enablement untuk setiap kandidat
6. memuat modul native yang diaktifkan melalui jiti
7. memanggil hook native register(api) (atau activate(api) — alias legacy) dan mengumpulkan pendaftaran ke dalam registri plugin
8. mengekspos registri ke surface perintah/runtime

​

Perilaku manifest-first

• mengidentifikasi plugin
• menemukan channel/Skills/schema konfigurasi yang dideklarasikan atau kapabilitas bundle
• memvalidasi plugins.entries.<id>.config
• menambah label/placeholder Control UI
• menampilkan metadata instalasi/katalog
• mempertahankan descriptor aktivasi dan penyiapan yang ringan tanpa memuat runtime plugin

• pemuatan CLI dipersempit ke plugin yang memiliki perintah utama yang diminta
• resolusi setup/plugin channel dipersempit ke plugin yang memiliki id channel yang diminta
• resolusi setup/runtime provider eksplisit dipersempit ke plugin yang memiliki id provider yang diminta

​

Apa yang di-cache oleh loader

• hasil discovery
• data registri manifest
• registri plugin yang dimuat

• Setel OPENCLAW_DISABLE_PLUGIN_DISCOVERY_CACHE=1 atau OPENCLAW_DISABLE_PLUGIN_MANIFEST_CACHE=1 untuk menonaktifkan cache ini.
• Sesuaikan jendela cache dengan OPENCLAW_PLUGIN_DISCOVERY_CACHE_MS dan OPENCLAW_PLUGIN_MANIFEST_CACHE_MS.

​

Model registri

• catatan plugin (identitas, sumber, asal, status, diagnostik)
• tool
• hook legacy dan hook bertipe
• channel
• provider
• handler RPC Gateway
• rute HTTP
• registrar CLI
• layanan latar belakang
• perintah milik plugin

• modul plugin -> pendaftaran registri
• runtime core -> konsumsi registri

​

Callback pengikatan percakapan

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" atau "denied"
• decision: "allow-once", "allow-always", atau "deny"
• binding: binding yang telah diselesaikan untuk permintaan yang disetujui
• request: ringkasan permintaan asli, petunjuk detach, id pengirim, dan metadata percakapan

​

Hook runtime provider

• metadata manifest: providerAuthEnvVars untuk lookup auth env provider yang ringan sebelum runtime dimuat, providerAuthAliases untuk varian provider yang berbagi auth, channelEnvVars untuk lookup env/setup channel yang ringan sebelum runtime dimuat, ditambah providerAuthChoices untuk label onboarding/pilihan auth yang ringan dan metadata flag CLI sebelum runtime dimuat
• hook saat konfigurasi: catalog / discovery legacy ditambah applyConfigDefaults
• hook runtime: normalizeModelId, normalizeTransport, normalizeConfig, applyNativeStreamingUsageCompat, resolveConfigApiKey, resolveSyntheticAuth, resolveExternalAuthProfiles, shouldDeferSyntheticProfileAuth, resolveDynamicModel, prepareDynamicModel, normalizeResolvedModel, contributeResolvedModelCompat, capabilities, normalizeToolSchemas, inspectToolSchemas, resolveReasoningOutputMode, prepareExtraParams, createStreamFn, wrapStreamFn, resolveTransportTurnState, resolveWebSocketSessionPolicy, formatApiKey, refreshOAuth, buildAuthDoctorHint, matchesContextOverflowError, classifyFailoverReason, isCacheTtlEligible, buildMissingAuthMessage, suppressBuiltInModel, augmentModelCatalog, isBinaryThinking, supportsXHighThinking, resolveDefaultThinkingLevel, isModernModelRef, prepareRuntimeAuth, resolveUsageAuth, fetchUsageSnapshot, createEmbeddingProvider, buildReplayPolicy, sanitizeReplayHistory, validateReplayTurns, onModelSelected

​

Urutan hook dan penggunaannya

​

Contoh provider

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);
  },
});

​

Contoh bawaan

• Anthropic menggunakan resolveDynamicModel, capabilities, buildAuthDoctorHint, resolveUsageAuth, fetchUsageSnapshot, isCacheTtlEligible, resolveDefaultThinkingLevel, applyConfigDefaults, isModernModelRef, dan wrapStreamFn karena plugin ini memiliki forward-compat Claude 4.6, petunjuk keluarga provider, panduan perbaikan auth, integrasi endpoint penggunaan, kelayakan prompt-cache, default konfigurasi yang sadar auth, kebijakan thinking default/adaptif Claude, dan pembentukan stream khusus Anthropic untuk beta header, /fast / serviceTier, dan context1m.
• Helper stream khusus Claude milik Anthropic untuk saat ini tetap berada di seam api.ts / contract-api.ts publik milik plugin bundled itu sendiri. Surface paket tersebut mengekspor wrapAnthropicProviderStream, resolveAnthropicBetas, resolveAnthropicFastMode, resolveAnthropicServiceTier, dan builder wrapper Anthropic tingkat lebih rendah alih-alih memperluas SDK generik di sekitar aturan beta-header satu provider.
• OpenAI menggunakan resolveDynamicModel, normalizeResolvedModel, dan capabilities ditambah buildMissingAuthMessage, suppressBuiltInModel, augmentModelCatalog, supportsXHighThinking, dan isModernModelRef karena plugin ini memiliki forward-compat GPT-5.4, normalisasi langsung OpenAI openai-completions -> openai-responses, petunjuk auth yang sadar Codex, suppressi Spark, baris daftar OpenAI synthetic, dan kebijakan thinking / live-model GPT-5; keluarga stream openai-responses-defaults memiliki wrapper OpenAI Responses native bersama untuk attribution header, /fast/serviceTier, text verbosity, pencarian web native Codex, pembentukan payload reasoning-compat, dan manajemen konteks Responses.
• OpenRouter menggunakan catalog ditambah resolveDynamicModel dan prepareDynamicModel karena provider ini bersifat pass-through dan dapat mengekspos model id baru sebelum katalog statis OpenClaw diperbarui; plugin ini juga menggunakan capabilities, wrapStreamFn, dan isCacheTtlEligible untuk menjaga header permintaan spesifik provider, metadata routing, patch reasoning, dan kebijakan prompt-cache tetap berada di luar core. Kebijakan replay-nya berasal dari keluarga passthrough-gemini, sedangkan keluarga stream openrouter-thinking memiliki injeksi reasoning proksi dan skip model yang tidak didukung / auto.
• GitHub Copilot menggunakan catalog, auth, resolveDynamicModel, dan capabilities ditambah prepareRuntimeAuth dan fetchUsageSnapshot karena plugin ini memerlukan device login milik provider, perilaku fallback model, keunikan transkrip Claude, pertukaran token GitHub -> token Copilot, dan endpoint penggunaan milik provider.
• OpenAI Codex menggunakan catalog, resolveDynamicModel, normalizeResolvedModel, refreshOAuth, dan augmentModelCatalog ditambah prepareExtraParams, resolveUsageAuth, dan fetchUsageSnapshot karena plugin ini masih berjalan di atas transport OpenAI core tetapi memiliki normalisasi transport/base URL, kebijakan fallback refresh OAuth, pilihan transport default, baris katalog Codex synthetic, dan integrasi endpoint penggunaan ChatGPT; plugin ini berbagi keluarga stream openai-responses-defaults yang sama dengan OpenAI langsung.
• Google AI Studio dan Gemini CLI OAuth menggunakan resolveDynamicModel, buildReplayPolicy, sanitizeReplayHistory, resolveReasoningOutputMode, wrapStreamFn, dan isModernModelRef karena keluarga replay google-gemini memiliki fallback forward-compat Gemini 3.1, validasi replay Gemini native, sanitasi replay bootstrap, mode output reasoning bertag, dan pencocokan model modern, sedangkan keluarga stream google-thinking memiliki normalisasi payload thinking Gemini; Gemini CLI OAuth juga menggunakan formatApiKey, resolveUsageAuth, dan fetchUsageSnapshot untuk formatting token, parsing token, dan wiring endpoint kuota.
• Anthropic Vertex menggunakan buildReplayPolicy melalui keluarga replay anthropic-by-model sehingga pembersihan replay khusus Claude tetap dibatasi pada id Claude alih-alih setiap transport anthropic-messages.
• Amazon Bedrock menggunakan buildReplayPolicy, matchesContextOverflowError, classifyFailoverReason, dan resolveDefaultThinkingLevel karena plugin ini memiliki klasifikasi error throttle/not-ready/context-overflow khusus Bedrock untuk lalu lintas Anthropic-on-Bedrock; kebijakan replay-nya tetap berbagi guard anthropic-by-model khusus Claude yang sama.
• OpenRouter, Kilocode, Opencode, dan Opencode Go menggunakan buildReplayPolicy melalui keluarga replay passthrough-gemini karena mereka memproksikan model Gemini melalui transport yang kompatibel dengan OpenAI dan memerlukan sanitasi thought-signature Gemini tanpa validasi replay Gemini native atau penulisan ulang bootstrap.
• MiniMax menggunakan buildReplayPolicy melalui keluarga replay hybrid-anthropic-openai karena satu provider memiliki semantik pesan Anthropic dan OpenAI-compatible; plugin ini mempertahankan penghapusan blok thinking khusus Claude di sisi Anthropic sambil meng-override mode output reasoning kembali ke native, dan keluarga stream minimax-fast-mode memiliki penulisan ulang model fast-mode pada jalur stream bersama.
• Moonshot menggunakan catalog ditambah wrapStreamFn karena plugin ini masih menggunakan transport OpenAI bersama tetapi memerlukan normalisasi payload thinking milik provider; keluarga stream moonshot-thinking memetakan konfigurasi ditambah state /think ke payload binary thinking native-nya.
• Kilocode menggunakan catalog, capabilities, wrapStreamFn, dan isCacheTtlEligible karena plugin ini memerlukan header permintaan milik provider, normalisasi payload reasoning, petunjuk transkrip Gemini, dan pengaturan cache-TTL Anthropic; keluarga stream kilocode-thinking menjaga injeksi thinking Kilo tetap berada pada jalur stream proksi bersama sambil melewati kilo/auto dan model id proksi lain yang tidak mendukung payload reasoning eksplisit.
• Z.AI menggunakan resolveDynamicModel, prepareExtraParams, wrapStreamFn, isCacheTtlEligible, isBinaryThinking, isModernModelRef, resolveUsageAuth, dan fetchUsageSnapshot karena plugin ini memiliki fallback GLM-5, default tool_stream, UX binary thinking, pencocokan model modern, dan pengambilan auth penggunaan + kuota; keluarga stream tool-stream-default-on menjaga wrapper tool_stream default-on tetap berada di luar glue tulisan tangan per-provider.
• xAI menggunakan normalizeResolvedModel, normalizeTransport, contributeResolvedModelCompat, prepareExtraParams, wrapStreamFn, resolveSyntheticAuth, resolveDynamicModel, dan isModernModelRef karena plugin ini memiliki normalisasi transport xAI Responses native, penulisan ulang alias fast-mode Grok, default tool_stream, pembersihan strict-tool / payload reasoning, penggunaan ulang auth fallback untuk tool milik plugin, resolusi model Grok forward-compat, dan patch kompatibilitas milik provider seperti profil tool-schema xAI, keyword schema yang tidak didukung, web_search native, dan decoding argumen tool-call entitas HTML.
• Mistral, OpenCode Zen, dan OpenCode Go hanya menggunakan capabilities untuk menjaga keunikan transkrip/tooling tetap berada di luar core.
• Provider bundled yang hanya katalog seperti byteplus, cloudflare-ai-gateway, huggingface, kimi-coding, nvidia, qianfan, synthetic, together, venice, vercel-ai-gateway, dan volcengine menggunakan catalog saja.
• Qwen menggunakan catalog untuk text provider-nya ditambah pendaftaran shared media-understanding dan video-generation untuk surface multimodal-nya.
• MiniMax dan Xiaomi menggunakan catalog ditambah hook penggunaan karena perilaku /usage mereka dimiliki plugin meskipun inferensi tetap berjalan melalui transport bersama.

​

Helper runtime

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 mengembalikan payload keluaran TTS core normal untuk surface file/catatan suara.
• Menggunakan konfigurasi core messages.tts dan pemilihan provider.
• Mengembalikan buffer audio PCM + sample rate. Plugin harus melakukan resample/encode untuk provider.
• listVoices bersifat opsional per provider. Gunakan ini untuk voice picker milik vendor atau alur setup.
• Daftar suara dapat mencakup metadata yang lebih kaya seperti locale, gender, dan tag personality untuk picker yang sadar provider.
• OpenAI dan ElevenLabs saat ini mendukung teleponi. Microsoft tidak.

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,
    };
  },
});

• Pertahankan kebijakan TTS, fallback, dan pengiriman balasan di core.
• Gunakan speech provider untuk perilaku sintesis milik vendor.
• Input edge Microsoft legacy dinormalisasi ke id provider microsoft.
• Model kepemilikan yang diutamakan berorientasi perusahaan: satu plugin vendor dapat memiliki provider teks, ucapan, gambar, dan media di masa depan saat OpenClaw menambahkan kontrak kapabilitas tersebut.

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

• Pertahankan orkestrasi, fallback, konfigurasi, dan wiring channel di core.
• Pertahankan perilaku vendor di plugin provider.
• Ekspansi aditif harus tetap bertipe: metode opsional baru, field hasil opsional baru, kapabilitas opsional baru.
• Pembuatan video sudah mengikuti pola yang sama:
  • core memiliki kontrak kapabilitas dan helper runtime
  • plugin vendor mendaftarkan api.registerVideoGenerationProvider(...)
  • plugin fitur/channel mengonsumsi api.runtime.videoGeneration.*

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.* adalah surface bersama yang diutamakan untuk pemahaman gambar/audio/video.
• Menggunakan konfigurasi audio media-understanding core (tools.media.audio) dan urutan fallback provider.
• Mengembalikan { text: undefined } ketika tidak ada keluaran transkripsi yang dihasilkan (misalnya input dilewati/tidak didukung).
• api.runtime.stt.transcribeAudioFile(...) tetap ada sebagai alias kompatibilitas.

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 dan model adalah override per eksekusi yang opsional, bukan perubahan sesi yang persisten.
• OpenClaw hanya menghormati field override tersebut untuk pemanggil tepercaya.
• Untuk eksekusi fallback milik plugin, operator harus melakukan opt-in dengan plugins.entries.<id>.subagent.allowModelOverride: true.
• Gunakan plugins.entries.<id>.subagent.allowedModels untuk membatasi plugin tepercaya ke target kanonis provider/model tertentu, atau "*" untuk secara eksplisit mengizinkan target apa pun.
• Eksekusi subagen plugin yang tidak tepercaya tetap berfungsi, tetapi permintaan override ditolak alih-alih diam-diam fallback.

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,
  },
});

• Pertahankan pemilihan provider, resolusi kredensial, dan semantik permintaan bersama di core.
• Gunakan web-search provider untuk transport pencarian vendor-spesifik.
• api.runtime.webSearch.* adalah surface bersama yang diutamakan untuk plugin fitur/channel yang memerlukan perilaku pencarian tanpa bergantung pada wrapper tool agen.

​

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(...): hasilkan gambar menggunakan rantai provider pembuatan gambar yang dikonfigurasi.
• listProviders(...): daftar provider pembuatan gambar yang tersedia dan kapabilitasnya.

​

Rute HTTP Gateway

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

• path: path rute di bawah server HTTP gateway.
• auth: wajib. Gunakan "gateway" untuk mewajibkan auth gateway normal, atau "plugin" untuk auth/verifikasi webhook yang dikelola plugin.
• match: opsional. "exact" (default) atau "prefix".
• replaceExisting: opsional. Memungkinkan plugin yang sama mengganti pendaftaran rute yang sudah ada miliknya sendiri.
• handler: kembalikan true saat rute menangani permintaan.

• api.registerHttpHandler(...) telah dihapus dan akan menyebabkan error saat pemuatan plugin. Gunakan api.registerHttpRoute(...) sebagai gantinya.
• Rute plugin harus mendeklarasikan auth secara eksplisit.
• Konflik path + match yang persis sama ditolak kecuali replaceExisting: true, dan satu plugin tidak dapat mengganti rute plugin lain.
• Rute yang tumpang tindih dengan level auth berbeda ditolak. Pertahankan rantai fallthrough exact/prefix hanya pada level auth yang sama.
• Rute auth: "plugin" tidak menerima scope runtime operator secara otomatis. Rute ini ditujukan untuk webhook/verifikasi tanda tangan yang dikelola plugin, bukan panggilan helper Gateway berprivileg.
• Rute auth: "gateway" berjalan di dalam scope runtime permintaan Gateway, tetapi scope itu sengaja konservatif:
  • auth bearer shared-secret (gateway.auth.mode = "token" / "password") menjaga scope runtime rute plugin tetap terkunci pada operator.write, bahkan jika pemanggil mengirim x-openclaw-scopes
  • mode HTTP tepercaya yang membawa identitas (misalnya trusted-proxy atau gateway.auth.mode = "none" pada ingress privat) menghormati x-openclaw-scopes hanya ketika header tersebut memang ada
  • jika x-openclaw-scopes tidak ada pada permintaan rute plugin yang membawa identitas tersebut, scope runtime fallback ke operator.write
• Aturan praktis: jangan menganggap rute plugin dengan auth gateway sebagai surface admin implisit. Jika rute Anda memerlukan perilaku khusus admin, wajibkan mode auth yang membawa identitas dan dokumentasikan kontrak header x-openclaw-scopes yang eksplisit.

​

Path impor Plugin SDK

• openclaw/plugin-sdk/plugin-entry untuk primitif pendaftaran plugin.
• openclaw/plugin-sdk/core untuk kontrak umum bersama yang menghadap plugin.
• openclaw/plugin-sdk/config-schema untuk ekspor skema Zod root openclaw.json (OpenClawSchema).
• Primitif channel stabil seperti openclaw/plugin-sdk/channel-setup, openclaw/plugin-sdk/setup-runtime, openclaw/plugin-sdk/setup-adapter-runtime, openclaw/plugin-sdk/setup-tools, openclaw/plugin-sdk/channel-pairing, openclaw/plugin-sdk/channel-contract, openclaw/plugin-sdk/channel-feedback, openclaw/plugin-sdk/channel-inbound, openclaw/plugin-sdk/channel-lifecycle, openclaw/plugin-sdk/channel-reply-pipeline, openclaw/plugin-sdk/command-auth, openclaw/plugin-sdk/secret-input, dan openclaw/plugin-sdk/webhook-ingress untuk wiring setup/auth/balasan/webhook bersama. channel-inbound adalah rumah bersama untuk debounce, pencocokan mention, helper kebijakan mention inbound, pemformatan envelope, dan helper konteks envelope inbound. channel-setup adalah seam setup narrow optional-install. setup-runtime adalah surface setup yang aman untuk runtime yang digunakan oleh setupEntry / startup yang ditangguhkan, termasuk adaptor patch setup yang aman untuk impor. setup-adapter-runtime adalah seam adaptor account-setup yang sadar env. setup-tools adalah seam helper kecil untuk CLI/arsip/dokumen (formatCliCommand, detectBinary, extractArchive, resolveBrewExecutable, formatDocsLink, CONFIG_DIR).
• Subpath domain seperti openclaw/plugin-sdk/channel-config-helpers, openclaw/plugin-sdk/allow-from, openclaw/plugin-sdk/channel-config-schema, openclaw/plugin-sdk/telegram-command-config, openclaw/plugin-sdk/channel-policy, openclaw/plugin-sdk/approval-gateway-runtime, openclaw/plugin-sdk/approval-handler-adapter-runtime, openclaw/plugin-sdk/approval-handler-runtime, openclaw/plugin-sdk/approval-runtime, openclaw/plugin-sdk/config-runtime, openclaw/plugin-sdk/infra-runtime, openclaw/plugin-sdk/agent-runtime, openclaw/plugin-sdk/lazy-runtime, openclaw/plugin-sdk/reply-history, openclaw/plugin-sdk/routing, openclaw/plugin-sdk/status-helpers, openclaw/plugin-sdk/text-runtime, openclaw/plugin-sdk/runtime-store, dan openclaw/plugin-sdk/directory-runtime untuk helper runtime/konfigurasi bersama. telegram-command-config adalah seam publik sempit untuk normalisasi/validasi perintah kustom Telegram dan tetap tersedia meskipun surface kontrak Telegram bundled untuk sementara tidak tersedia. text-runtime adalah seam teks/markdown/logging bersama, termasuk penghapusan teks yang terlihat oleh asisten, helper render/chunking markdown, helper redaksi, helper directive-tag, dan utilitas safe-text.
• Seam channel yang spesifik persetujuan sebaiknya mengutamakan satu kontrak approvalCapability pada plugin. Core kemudian membaca auth, pengiriman, render, native-routing, dan perilaku lazy native-handler persetujuan melalui satu kapabilitas itu alih-alih mencampurkan perilaku persetujuan ke field plugin yang tidak terkait.
• openclaw/plugin-sdk/channel-runtime sudah deprecated dan hanya tersisa sebagai shim kompatibilitas untuk plugin lama. Kode baru sebaiknya mengimpor primitif generik yang lebih sempit, dan kode repo tidak boleh menambahkan impor baru terhadap shim tersebut.
• Internal extension bundled tetap privat. Plugin eksternal sebaiknya hanya menggunakan subpath openclaw/plugin-sdk/*. Kode core/test OpenClaw dapat menggunakan entry point publik repo di bawah root paket plugin seperti index.js, api.js, runtime-api.js, setup-entry.js, dan file yang discope sempit seperti login-qr-api.js. Jangan pernah mengimpor src/* dari paket plugin dari core atau dari extension lain.
• Pemisahan entry point repo: <plugin-package-root>/api.js adalah barrel helper/types, <plugin-package-root>/runtime-api.js adalah barrel khusus runtime, <plugin-package-root>/index.js adalah entry plugin bundled, dan <plugin-package-root>/setup-entry.js adalah entry plugin setup.
• Contoh provider bundled saat ini:
  • Anthropic menggunakan api.js / contract-api.js untuk helper stream Claude seperti wrapAnthropicProviderStream, helper beta-header, dan parsing service_tier.
  • OpenAI menggunakan api.js untuk builder provider, helper model default, dan builder provider realtime.
  • OpenRouter menggunakan api.js untuk builder provider-nya ditambah helper onboarding/config, sedangkan register.runtime.js masih dapat mengekspor ulang helper generik plugin-sdk/provider-stream untuk penggunaan lokal repo.
• Entry point publik yang dimuat melalui facade mengutamakan snapshot konfigurasi runtime aktif ketika ada, lalu fallback ke file konfigurasi yang di-resolve di disk ketika OpenClaw belum menyajikan snapshot runtime.
• Primitif generik bersama tetap menjadi kontrak SDK publik yang diutamakan. Sekumpulan kecil seam helper bermerek channel bundled yang dicadangkan untuk kompatibilitas masih ada. Perlakukan itu sebagai seam pemeliharaan bundled/kompatibilitas, bukan target impor pihak ketiga yang baru; kontrak lintas-channel baru tetap harus berada pada subpath generik plugin-sdk/* atau barrel api.js / runtime-api.js lokal plugin.

• Hindari barrel root openclaw/plugin-sdk untuk kode baru.
• Utamakan primitif stabil yang sempit terlebih dahulu. Subpath setup/pairing/reply/ feedback/contract/inbound/threading/command/secret-input/webhook/infra/ allowlist/status/message-tool yang lebih baru adalah kontrak yang dituju untuk pekerjaan plugin bundled dan eksternal yang baru. Parsing/pencocokan target berada di openclaw/plugin-sdk/channel-targets. Gerbang aksi pesan dan helper message-id reaksi berada di openclaw/plugin-sdk/channel-actions.
• Barrel helper khusus extension bundled tidak stabil secara default. Jika sebuah helper hanya dibutuhkan oleh extension bundled, simpan di balik seam api.js atau runtime-api.js lokal extension tersebut alih-alih mempromosikannya ke openclaw/plugin-sdk/<extension>.
• Seam helper bersama yang baru harus generik, bukan bermerek channel. Parsing target bersama berada di openclaw/plugin-sdk/channel-targets; internal khusus channel tetap berada di balik seam api.js atau runtime-api.js lokal plugin pemiliknya.
• Subpath spesifik kapabilitas seperti image-generation, media-understanding, dan speech ada karena plugin bundled/native menggunakannya saat ini. Keberadaannya sendiri tidak berarti setiap helper yang diekspor adalah kontrak eksternal jangka panjang yang dibekukan.

​

Skema message tool

• createMessageToolButtonsSchema() untuk payload gaya grid tombol
• createMessageToolCardSchema() untuk payload kartu terstruktur

​

Resolusi target channel

• messaging.inferTargetChatType({ to }) memutuskan apakah target yang telah dinormalisasi harus diperlakukan sebagai direct, group, atau channel sebelum lookup direktori.
• messaging.targetResolver.looksLikeId(raw, normalized) memberi tahu core apakah suatu input harus langsung dilewatkan ke resolusi mirip-id alih-alih pencarian direktori.
• messaging.targetResolver.resolveTarget(...) adalah fallback plugin saat core memerlukan resolusi akhir milik provider setelah normalisasi atau setelah direktori tidak menemukan hasil.
• messaging.resolveOutboundSessionRoute(...) memiliki konstruksi rute sesi khusus provider setelah sebuah target di-resolve.

• Gunakan inferTargetChatType untuk keputusan kategori yang harus terjadi sebelum pencarian peer/group.
• Gunakan looksLikeId untuk pemeriksaan “perlakukan ini sebagai id target eksplisit/native”.
• Gunakan resolveTarget untuk fallback normalisasi khusus provider, bukan untuk pencarian direktori yang luas.
• Pertahankan id native provider seperti chat id, thread id, JID, handle, dan room id di dalam nilai target atau param khusus provider, bukan di field SDK generik.

​

Direktori berbasis konfigurasi

• peer DM yang digerakkan allowlist
• peta channel/group yang dikonfigurasi
• fallback direktori statis yang dibatasi akun

• penyaringan kueri
• penerapan batas
• helper deduplikasi/normalisasi
• membangun ChannelDirectoryEntry[]

​

Katalog provider

• { provider } untuk satu entri provider
• { providers } untuk beberapa entri provider

• simple: provider biasa berbasis API key atau env
• profile: provider yang muncul ketika profil auth ada
• paired: provider yang mensintesis beberapa entri provider yang saling terkait
• late: pass terakhir, setelah provider implisit lainnya

• discovery tetap berfungsi sebagai alias legacy
• jika catalog dan discovery sama-sama didaftarkan, OpenClaw menggunakan catalog

​

Inspeksi channel read-only

• resolveAccount(...) adalah jalur runtime. Jalur ini boleh mengasumsikan kredensial telah sepenuhnya dimaterialisasi dan dapat gagal cepat ketika secret yang diperlukan tidak ada.
• Jalur perintah read-only seperti openclaw status, openclaw status --all, openclaw channels status, openclaw channels resolve, dan alur perbaikan doctor/config tidak seharusnya perlu mematerialisasi kredensial runtime hanya untuk mendeskripsikan konfigurasi.

• Hanya kembalikan state akun yang deskriptif.
• Pertahankan enabled dan configured.
• Sertakan field sumber/status kredensial jika relevan, seperti:
  • tokenSource, tokenStatus
  • botTokenSource, botTokenStatus
  • appTokenSource, appTokenStatus
  • signingSecretSource, signingSecretStatus
• Anda tidak perlu mengembalikan nilai token mentah hanya untuk melaporkan ketersediaan read-only. Mengembalikan tokenStatus: "available" (dan field sumber yang cocok) sudah cukup untuk perintah bergaya status.
• Gunakan configured_unavailable ketika sebuah kredensial dikonfigurasi melalui SecretRef tetapi tidak tersedia pada jalur perintah saat ini.

​

Paket pack

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

• pendaftaran channel itu sendiri
• rute HTTP apa pun yang harus tersedia sebelum gateway mulai mendengarkan
• metode gateway, tool, atau layanan apa pun yang harus ada selama jendela yang sama

• singleAccountKeysToMove
• namedAccountPromotionKeys
• resolveSingleAccountPromotionTarget(...)

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

​

Metadata katalog channel

{
  "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": "Chat self-hosted melalui bot webhook Nextcloud Talk.",
      "order": 65,
      "aliases": ["nc-talk", "nc"]
    },
    "install": {
      "npmSpec": "@openclaw/nextcloud-talk",
      "localPath": "<bundled-plugin-local-path>",
      "defaultChoice": "npm"
    }
  }
}

• detailLabel: label sekunder untuk surface katalog/status yang lebih kaya
• docsLabel: override teks tautan untuk tautan dokumen
• preferOver: id plugin/channel prioritas lebih rendah yang harus dikalahkan oleh entri katalog ini
• selectionDocsPrefix, selectionDocsOmitLabel, selectionExtras: kontrol copy surface pemilihan
• markdownCapable: menandai channel sebagai mampu markdown untuk keputusan pemformatan outbound
• exposure.configured: sembunyikan channel dari surface daftar channel yang dikonfigurasi ketika disetel ke false
• exposure.setup: sembunyikan channel dari picker setup/konfigurasi interaktif ketika disetel ke false
• exposure.docs: tandai channel sebagai internal/private untuk surface navigasi dokumen
• showConfigured / showInSetup: alias legacy masih diterima demi kompatibilitas; utamakan exposure
• quickstartAllowFrom: ikutsertakan channel ke alur allowFrom quickstart standar
• forceAccountBinding: wajibkan pengikatan akun eksplisit meskipun hanya ada satu akun
• preferSessionLookupForAnnounceTarget: utamakan lookup sesi saat me-resolve target announce

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

​

Plugin mesin konteks

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

export default function (api) {
  api.registerContextEngine("lossless-claw", () => ({
    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", () => ({
    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);
    },
  }));
}

​

Menambahkan kapabilitas baru

1. definisikan kontrak core Putuskan perilaku bersama apa yang harus dimiliki core: kebijakan, fallback, merge konfigurasi, lifecycle, semantik yang menghadap channel, dan bentuk helper runtime.
2. tambahkan surface pendaftaran/runtime plugin yang bertipe Perluas OpenClawPluginApi dan/atau api.runtime dengan surface kapabilitas bertipe terkecil yang berguna.
3. hubungkan konsumen core + channel/fitur Plugin channel dan fitur harus mengonsumsi kapabilitas baru melalui core, bukan dengan langsung mengimpor implementasi vendor.
4. daftarkan implementasi vendor Plugin vendor kemudian mendaftarkan backend mereka terhadap kapabilitas tersebut.
5. tambahkan cakupan kontrak Tambahkan pengujian agar bentuk kepemilikan dan pendaftaran tetap eksplisit seiring waktu.

​

Checklist kapabilitas

• tipe kontrak core di src/<capability>/types.ts
• helper runner/runtime core di src/<capability>/runtime.ts
• surface pendaftaran API plugin di src/plugins/types.ts
• wiring registri plugin di src/plugins/registry.ts
• eksposur runtime plugin di src/plugins/runtime/* ketika plugin fitur/channel perlu mengonsumsinya
• helper capture/test di src/test-utils/plugin-registration.ts
• assertion kepemilikan/kontrak di src/plugins/contracts/registry.ts
• dokumen operator/plugin di docs/

​

Templat kapabilitas

// 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"]);

• core memiliki kontrak kapabilitas + orkestrasi
• plugin vendor memiliki implementasi vendor
• plugin fitur/channel mengonsumsi helper runtime
• pengujian kontrak menjaga kepemilikan tetap eksplisit