Internal arsitektur Plugin

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.

​

Pipeline pemuatan

1. menemukan root Plugin kandidat
2. membaca manifes bundel native atau kompatibel dan metadata paket
3. menolak kandidat yang tidak aman
4. menormalkan konfigurasi Plugin (plugins.enabled, allow, deny, entries, slots, load.paths)
5. menentukan pengaktifan untuk setiap kandidat
6. memuat modul native yang diaktifkan: modul bundled bawaan memakai loader native; source TypeScript lokal pihak ketiga memakai fallback darurat Jiti
7. memanggil hook native register(api) dan mengumpulkan registrasi ke dalam registry Plugin
8. mengekspos registry ke perintah/permukaan runtime

​

Perilaku mengutamakan manifes

• mengidentifikasi Plugin
• menemukan channel/skills/skema konfigurasi atau kapabilitas bundel yang dideklarasikan
• memvalidasi plugins.entries.<id>.config
• memperkaya label/placeholder Control UI
• menampilkan metadata instalasi/katalog
• mempertahankan deskriptor aktivasi dan penyiapan murah tanpa memuat runtime Plugin

• pemuatan CLI mempersempit ke Plugin yang memiliki perintah utama yang diminta
• resolusi penyiapan/channel Plugin mempersempit ke Plugin yang memiliki id channel yang diminta
• resolusi penyiapan/runtime provider eksplisit mempersempit ke Plugin yang memiliki id provider yang diminta
• perencanaan startup Gateway memakai activation.onStartup untuk impor startup eksplisit dan opt-out startup; Plugin tanpa metadata startup hanya dimuat melalui pemicu aktivasi yang lebih sempit

​

Batas cache Plugin

• PluginLoaderCacheState dan registry runtime aktif yang kompatibel
• cache jiti/module dan cache loader permukaan publik yang dipakai untuk menghindari impor permukaan runtime yang sama berulang kali
• cache filesystem untuk artefak Plugin terinstal
• map per panggilan berumur pendek untuk normalisasi path atau resolusi duplikat

• hasil penemuan
• registry manifes langsung
• registry manifes yang direkonstruksi dari indeks Plugin terinstal
• lookup owner provider, penekanan model, kebijakan provider, atau metadata artefak publik
• jawaban turunan manifes lainnya ketika manifes, indeks terinstal, atau load path yang berubah harus terlihat pada pembacaan metadata berikutnya

​

Model registry

• record Plugin (identitas, source, origin, status, diagnostik)
• tool
• hook lama dan hook bertipe
• channel
• provider
• handler RPC Gateway
• rute HTTP
• registrar CLI
• layanan latar belakang
• perintah milik Plugin

• modul Plugin -> registrasi registry
• runtime core -> konsumsi registry

​

Callback binding 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 terselesaikan untuk permintaan yang disetujui
• request: ringkasan permintaan asli, petunjuk detach, id pengirim, dan metadata percakapan

​

Hook runtime provider

• Metadata manifes untuk lookup murah sebelum runtime: setup.providers[].envVars, kompatibilitas usang providerAuthEnvVars, providerAuthAliases, providerAuthChoices, dan channelEnvVars.
• Hook waktu konfigurasi: catalog (discovery lama) plus applyConfigDefaults.
• Hook runtime: lebih dari 40 hook opsional yang mencakup auth, resolusi model, pembungkus stream, tingkat thinking, kebijakan replay, dan endpoint usage. Lihat daftar lengkap di Urutan dan penggunaan hook.

​

Urutan dan penggunaan hook

​

Contoh penyedia

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

​

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 permukaan file/catatan suara.
• Menggunakan konfigurasi core messages.tts dan pemilihan penyedia.
• Mengembalikan buffer audio PCM + laju sampel. Plugin harus melakukan resample/encode untuk penyedia.
• listVoices bersifat opsional per penyedia. Gunakan untuk pemilih suara atau alur penyiapan milik vendor.
• Daftar suara dapat menyertakan metadata yang lebih kaya seperti locale, gender, dan tag kepribadian untuk pemilih yang sadar penyedia.
• OpenAI dan ElevenLabs mendukung telephony saat ini. 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,
    };
  },
});

• Simpan kebijakan TTS, fallback, dan pengiriman balasan di core.
• Gunakan penyedia speech untuk perilaku sintesis milik vendor.
• Input Microsoft lama edge dinormalkan ke id penyedia microsoft.
• Model kepemilikan yang disarankan berorientasi perusahaan: satu Plugin vendor dapat memiliki penyedia teks, speech, gambar, dan media 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: "..." }),
});

• Simpan orkestrasi, fallback, config, dan pengabelan channel di core.
• Simpan perilaku vendor di Plugin penyedia.
• Ekspansi aditif harus tetap bertipe: metode opsional baru, bidang 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 menggunakan 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 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.* adalah permukaan bersama yang disarankan untuk pemahaman gambar/audio/video.
• extractStructuredWithModel(...) adalah seam yang dihadapkan ke Plugin untuk ekstraksi terbatas milik penyedia yang mengutamakan gambar. Sertakan setidaknya satu input gambar; input teks adalah konteks tambahan. Plugin produk memiliki rute dan skemanya, sementara OpenClaw memiliki batas penyedia/runtime.
• Menggunakan konfigurasi audio media-understanding core (tools.media.audio) dan urutan fallback penyedia.
• Mengembalikan { text: undefined } saat tidak ada keluaran transkripsi yang dihasilkan (misalnya input dilewati/tidak didukung).
• api.runtime.stt.transcribeAudioFile(...) tetap tersedia 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-run opsional, bukan perubahan sesi persisten.
• OpenClaw hanya menghormati bidang override tersebut untuk pemanggil tepercaya.
• Untuk run fallback milik Plugin, operator harus ikut serta 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 mengizinkan target apa pun secara eksplisit.
• Run subagent Plugin yang tidak tepercaya tetap berfungsi, tetapi permintaan override ditolak alih-alih diam-diam memakai fallback.
• Sesi subagent yang dibuat Plugin diberi tag dengan id Plugin pembuat. Fallback api.runtime.subagent.deleteSession(...) hanya dapat menghapus sesi yang dimiliki tersebut; penghapusan sesi arbitrer tetap memerlukan permintaan Gateway dengan cakupan admin.

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

• Simpan pemilihan penyedia, resolusi kredensial, dan semantik permintaan bersama di core.
• Gunakan penyedia pencarian web untuk transport pencarian khusus vendor.
• api.runtime.webSearch.* adalah permukaan bersama yang disarankan untuk Plugin fitur/channel yang membutuhkan 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(...): menghasilkan gambar menggunakan rantai penyedia pembuatan gambar yang dikonfigurasi.
• listProviders(...): mencantumkan penyedia 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 verifikasi auth/webhook yang dikelola Plugin.
• match: opsional. "exact" (default) atau "prefix".
• replaceExisting: opsional. Mengizinkan Plugin yang sama mengganti pendaftaran rute miliknya yang sudah ada.
• handler: kembalikan true saat rute menangani permintaan.

• api.registerHttpHandler(...) telah dihapus dan akan menyebabkan kesalahan pemuatan Plugin. Gunakan api.registerHttpRoute(...) sebagai gantinya.
• Rute Plugin harus mendeklarasikan auth secara eksplisit.
• Konflik path + match yang persis ditolak kecuali replaceExisting: true, dan satu Plugin tidak dapat menggantikan rute Plugin lain.
• Rute yang tumpang tindih dengan tingkat auth berbeda ditolak. Pertahankan rantai fallback exact/prefix hanya pada tingkat auth yang sama.
• Rute auth: "plugin" tidak menerima cakupan runtime operator secara otomatis. Rute ini ditujukan untuk Webhook/verifikasi tanda tangan yang dikelola Plugin, bukan panggilan pembantu Gateway yang memiliki hak istimewa.
• Rute auth: "gateway" berjalan di dalam cakupan runtime permintaan Gateway, tetapi cakupan tersebut sengaja dibuat konservatif:
  • auth bearer rahasia bersama (gateway.auth.mode = "token" / "password") menjaga cakupan runtime rute Plugin tetap dipatok ke operator.write, meskipun pemanggil mengirim x-openclaw-scopes
  • mode HTTP pembawa identitas tepercaya (misalnya trusted-proxy atau gateway.auth.mode = "none" pada ingress privat) menghormati x-openclaw-scopes hanya ketika header tersebut hadir secara eksplisit
  • jika x-openclaw-scopes tidak ada pada permintaan rute Plugin pembawa identitas tersebut, cakupan runtime kembali ke operator.write
• Aturan praktis: jangan berasumsi bahwa rute Plugin dengan auth gateway adalah permukaan admin implisit. Jika rute Anda memerlukan perilaku khusus admin, wajibkan mode auth pembawa identitas dan dokumentasikan kontrak header x-openclaw-scopes yang eksplisit.

​

Jalur impor SDK Plugin

• index.js — entri Plugin bawaan
• api.js — barrel pembantu/tipe
• runtime-api.js — barrel khusus runtime
• setup-entry.js — entri Plugin setup

​

Skema tool pesan

• presentation untuk blok presentasi semantik (text, context, divider, buttons, select)
• delivery-pin untuk permintaan pengiriman yang dipin

​

Resolusi target channel

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

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

​

Direktori berbasis konfigurasi

• peer DM yang digerakkan allowlist
• peta channel/grup yang dikonfigurasi
• fallback direktori statis bercakupan akun

• pemfilteran kueri
• penerapan limit
• pembantu 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 menyintesis beberapa entri provider terkait
• late: pass terakhir, setelah provider implisit lain

• discovery masih berfungsi sebagai alias lama, tetapi memunculkan peringatan deprecation
• jika catalog dan discovery sama-sama didaftarkan, OpenClaw menggunakan catalog
• augmentModelCatalog tidak digunakan lagi; provider bawaan sebaiknya menerbitkan baris tambahan melalui registerModelCatalogProvider

​

Inspeksi channel hanya-baca

• resolveAccount(...) adalah jalur runtime. Jalur ini boleh berasumsi bahwa kredensial telah sepenuhnya dimaterialisasi dan dapat gagal cepat ketika rahasia yang diperlukan tidak ada.
• Jalur perintah hanya-baca seperti openclaw status, openclaw status --all, openclaw channels status, openclaw channels resolve, dan alur perbaikan doctor/konfigurasi sebaiknya tidak perlu mematerialisasi kredensial runtime hanya untuk mendeskripsikan konfigurasi.

• Kembalikan hanya status akun deskriptif.
• Pertahankan enabled dan configured.
• Sertakan field sumber/status kredensial bila relevan, seperti:
  • tokenSource, tokenStatus
  • botTokenSource, botTokenStatus
  • appTokenSource, appTokenStatus
  • signingSecretSource, signingSecretStatus
• Anda tidak perlu mengembalikan nilai token mentah hanya untuk melaporkan ketersediaan hanya-baca. Mengembalikan tokenStatus: "available" (dan field sumber yang cocok) sudah cukup untuk perintah bergaya status.
• Gunakan configured_unavailable ketika 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
• route HTTP apa pun yang harus tersedia sebelum gateway mulai mendengarkan
• metode, tool, atau layanan gateway 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": "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: label sekunder untuk permukaan katalog/status yang lebih kaya
• docsLabel: timpa teks tautan untuk tautan docs
• preferOver: id Plugin/channel berprioritas lebih rendah yang harus dikalahkan oleh entri katalog ini
• selectionDocsPrefix, selectionDocsOmitLabel, selectionExtras: kontrol salinan permukaan seleksi
• markdownCapable: menandai channel sebagai mampu markdown untuk keputusan pemformatan outbound
• exposure.configured: sembunyikan channel dari permukaan daftar channel yang dikonfigurasi ketika diatur ke false
• exposure.setup: sembunyikan channel dari pemilih setup/konfigurasi interaktif ketika diatur ke false
• exposure.docs: tandai channel sebagai internal/privat untuk permukaan navigasi docs
• showConfigured / showInSetup: alias legacy yang masih diterima untuk kompatibilitas; utamakan exposure
• quickstartAllowFrom: ikutkan channel ke flow quickstart standar allowFrom
• forceAccountBinding: wajibkan binding akun eksplisit bahkan ketika hanya ada satu akun
• preferSessionLookupForAnnounceTarget: utamakan lookup sesi saat me-resolve target pengumuman

• ~/.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", (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);
    },
  }));
}

​

Menambahkan kapabilitas baru

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

​

Checklist kapabilitas

• tipe kontrak core di src/<capability>/types.ts
• helper runner/runtime core di src/<capability>/runtime.ts
• permukaan registrasi API Plugin di src/plugins/types.ts
• wiring registry 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
• asersi kepemilikan/kontrak di src/plugins/contracts/registry.ts
• docs 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
• test kontrak menjaga kepemilikan tetap eksplisit

​

Terkait

• Arsitektur Plugin — model dan bentuk kapabilitas publik
• Subpath SDK Plugin
• Setup SDK Plugin
• Membangun Plugin