Pluginアーキテクチャ内部

​

ロードパイプライン

1. 候補 Plugin ルートを検出する
2. ネイティブまたは互換バンドルのマニフェストとパッケージメタデータを読み取る
3. 安全でない候補を拒否する
4. Plugin 設定（plugins.enabled、allow、deny、entries, slots、load.paths）を正規化する
5. 各候補の有効化を判断する
6. 有効化されたネイティブモジュールをロードする: ビルド済みのバンドルモジュールはネイティブローダーを使用し、 サードパーティのローカルソース TypeScript は緊急用の Jiti フォールバックを使用する
7. ネイティブの register(api) フックを呼び出し、登録内容を Plugin レジストリに収集する
8. コマンド/ランタイム面にレジストリを公開する

• 解決されたエントリが Plugin ルートの外へ出る
• パス（またはそのルートディレクトリ）が world-writable である
• 非バンドル Plugin で、パスの所有者が現在の uid（または root）と一致しない

​

マニフェスト優先の動作

• Plugin を識別する
• 宣言されたチャンネル/Skills/設定スキーマまたはバンドル capability を検出する
• plugins.entries.<id>.config を検証する
• Control UI のラベル/プレースホルダーを補強する
• インストール/カタログメタデータを表示する
• Plugin ランタイムをロードせずに、軽量な activation と setup 記述子を保持する

• CLI ロードは、要求されたプライマリコマンドを所有する Plugin に絞り込む
• チャンネル setup/Plugin 解決は、要求されたチャンネル id を所有する Plugin に絞り込む
• 明示的なプロバイダー setup/ランタイム解決は、要求されたプロバイダー id を所有する Plugin に絞り込む
• Gateway 起動計画は、明示的な起動時インポートに activation.onStartup を使用する。起動メタデータのない Plugin は、より狭い activation トリガーを通じてのみロードされる

​

Plugin キャッシュ境界

• PluginLoaderCacheState と互換性のあるアクティブランタイムレジストリ
• 同じランタイム面を繰り返しインポートするのを避けるために使われる jiti/module キャッシュと public-surface ローダーキャッシュ
• インストール済み Plugin アーティファクト用のファイルシステムキャッシュ
• パス正規化や重複解決用の短命な呼び出し単位マップ

• 検出結果
• 直接のマニフェストレジストリ
• インストール済み Plugin インデックスから再構築されたマニフェストレジストリ
• プロバイダー所有者 lookup、モデル抑制、プロバイダーポリシー、public-artifact メタデータ
• 変更されたマニフェスト、インストール済みインデックス、ロードパスが次のメタデータ読み取りで見えるべき、その他のマニフェスト由来の回答

​

レジストリモデル

• Plugin モジュール -> レジストリ登録
• コアランタイム -> レジストリ消費

​

会話バインディングコールバック

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" または "denied"
• decision: "allow-once"、"allow-always"、または "deny"
• binding: 承認されたリクエストの解決済みバインディング
• request: 元のリクエスト概要、detach hint、sender id、会話メタデータ

​

プロバイダーランタイムフック

• 安価なランタイム前 lookup のためのマニフェストメタデータ: setup.providers[].envVars、非推奨の互換性 providerAuthEnvVars、 providerAuthAliases、providerAuthChoices、channelEnvVars。
• 設定時フック: catalog（レガシー discovery）と applyConfigDefaults。
• ランタイムフック: 認証、モデル解決、ストリームラップ、thinking levels、replay policy、使用量エンドポイントをカバーする 40 個以上の任意フック。フックの順序と使い方を参照してください。

​

フックの順序と使い方

​

プロバイダー例

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

​

組み込み例

​

ランタイムヘルパー

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 は、ファイル/ボイスメモ表示面向けの通常のコア TTS 出力ペイロードを返します。
• コアの messages.tts 設定とプロバイダー選択を使用します。
• PCM 音声バッファ + サンプルレートを返します。Pluginはプロバイダー向けにリサンプリング/エンコードする必要があります。
• listVoices はプロバイダーごとに任意です。ベンダー所有の音声ピッカーやセットアップフローで使用します。
• 音声一覧には、ロケール、性別、性格タグなど、プロバイダー対応ピッカー向けのより豊富なメタデータを含められます。
• OpenAI と ElevenLabs は現在テレフォニーに対応しています。Microsoft は対応していません。

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 ポリシー、フォールバック、返信配信はコアに保持します。
• ベンダー所有の合成挙動には音声プロバイダーを使用します。
• レガシー Microsoft edge 入力は microsoft プロバイダー ID に正規化されます。
• 推奨される所有モデルは企業指向です。OpenClaw がそれらの機能契約を追加するにつれ、1 つのベンダーPluginがテキスト、音声、画像、将来のメディアプロバイダーを所有できます。

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

• オーケストレーション、フォールバック、設定、チャネル配線はコアに保持します。
• ベンダー挙動はプロバイダーPluginに保持します。
• 追加的な拡張は型付きのままにします。新しい任意メソッド、新しい任意結果フィールド、新しい任意機能を使用します。
• 動画生成もすでに同じパターンに従っています:
  • コアが機能契約とランタイムヘルパーを所有する
  • ベンダーPluginが api.registerVideoGenerationProvider(...) を登録する
  • 機能/チャネルPluginが 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.* は、画像/音声/動画理解向けの推奨共有表示面です。
• extractStructuredWithModel(...) は、境界付けられたプロバイダー所有の画像優先抽出に対するPlugin向け境界です。少なくとも 1 つの画像入力を含めます。テキスト入力は補足コンテキストです。プロダクトPluginがそれぞれのルートとスキーマを所有し、OpenClaw がプロバイダー/ランタイム境界を所有します。
• コアのメディア理解音声設定（tools.media.audio）とプロバイダーフォールバック順序を使用します。
• 文字起こし出力が生成されない場合（たとえばスキップ/非対応入力）は { text: undefined } を返します。
• api.runtime.stt.transcribeAudioFile(...) は互換エイリアスとして残ります。

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 と model は実行ごとの任意オーバーライドであり、永続的なセッション変更ではありません。
• OpenClaw は信頼済み呼び出し元に対してのみ、それらのオーバーライドフィールドを尊重します。
• Plugin所有のフォールバック実行については、オペレーターが plugins.entries.<id>.subagent.allowModelOverride: true でオプトインする必要があります。
• plugins.entries.<id>.subagent.allowedModels を使用して、信頼済みPluginを特定の正規 provider/model ターゲットに制限します。または、任意のターゲットを明示的に許可するには "*" を使用します。
• 信頼されていないPluginのサブエージェント実行も動作しますが、オーバーライド要求はサイレントにフォールバックするのではなく拒否されます。
• Pluginが作成したサブエージェントセッションには、作成元Plugin ID がタグ付けされます。フォールバックの api.runtime.subagent.deleteSession(...) は、それらの所有セッションのみを削除できます。任意のセッション削除には、引き続き管理者スコープの Gateway リクエストが必要です。

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

• プロバイダー選択、資格情報解決、共有リクエストセマンティクスはコアに保持します。
• ベンダー固有の検索トランスポートには Web 検索プロバイダーを使用します。
• api.runtime.webSearch.* は、エージェントツールラッパーに依存せずに検索挙動を必要とする機能/チャネルPlugin向けの推奨共有表示面です。

​

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(...): 設定された画像生成プロバイダーチェーンを使用して画像を生成します。
• listProviders(...): 利用可能な画像生成プロバイダーとその機能を一覧表示します。

​

Gateway HTTP ルート

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

• path: Gateway HTTP サーバー配下のルートパス。
• auth: 必須、"gateway" または "plugin"。通常の Gateway 認証を要求するには "gateway" を使用し、Plugin 管理の認証/Webhook 検証には "plugin" を使用します。
• match: 任意。"exact"（デフォルト）または "prefix"。
• handleUpgrade: 同じルート上の WebSocket アップグレードリクエスト用の任意ハンドラー。
• replaceExisting: 任意。同じ Plugin が自身の既存ルート登録を置き換えることを許可します。
• handler: ルートがリクエストを処理した場合に true を返します。

• api.registerHttpHandler(...) は削除され、Plugin 読み込みエラーの原因になります。代わりに api.registerHttpRoute(...) を使用してください。
• Plugin ルートは auth を明示的に宣言する必要があります。
• 完全一致する path + match の競合は、replaceExisting: true でない限り拒否されます。また、ある Plugin が別の Plugin のルートを置き換えることはできません。
• 異なる auth レベルで重複するルートは拒否されます。exact/prefix のフォールスルーチェーンは、同じ認証レベル内のみにしてください。
• auth: "plugin" ルートは、オペレーターランタイムスコープを自動的には受け取りません。これは Plugin 管理の Webhook/署名検証用であり、特権的な Gateway ヘルパー呼び出し用ではありません。
• auth: "gateway" ルートは、Gateway リクエストランタイムスコープ内で実行されます。デフォルトのサーフェス（gatewayRuntimeScopeSurface: "write-default"）は意図的に保守的です:
  • 共有シークレットの bearer 認証（gateway.auth.mode = "token" / "password"）および信頼済みプロキシ以外の認証方式は、呼び出し元が x-openclaw-scopes を送信しても、単一の operator.write スコープを取得します
  • 明示的な x-openclaw-scopes ヘッダーのない trusted-proxy 呼び出し元も、従来の operator.write のみのサーフェスを維持します
  • x-openclaw-scopes を送信する trusted-proxy 呼び出し元は、代わりに宣言されたスコープを取得します
  • ルートは gatewayRuntimeScopeSurface: "trusted-operator" にオプトインすることで、ID を伴う認証モードでは常に x-openclaw-scopes を尊重できます（ヘッダーがない場合は完全な CLI デフォルトスコープセットにフォールバックします）
• 実用上のルール: Gateway 認証の Plugin ルートを暗黙の管理者サーフェスと見なさないでください。ルートに管理者専用の動作が必要な場合は、trusted-operator スコープサーフェスにオプトインし、ID を伴う認証モードを要求し、明示的な x-openclaw-scopes ヘッダー契約を文書化してください。

​

Plugin SDK インポートパス

• index.js — バンドル済み Plugin エントリー
• api.js — ヘルパー/型 barrel
• runtime-api.js — ランタイム専用 barrel
• setup-entry.js — セットアップ Plugin エントリー

​

メッセージツールスキーマ

• セマンティックなプレゼンテーションブロック（text, context, divider, buttons, select）用の presentation
• ピン留め配信リクエスト用の delivery-pin

​

チャネルターゲット解決

• messaging.inferTargetChatType({ to }) は、ディレクトリ検索の前に、正規化されたターゲットを direct、group、channel のどれとして扱うべきかを決定します。
• messaging.targetResolver.looksLikeId(raw, normalized) は、入力がディレクトリ検索ではなく ID らしい解決へ直接進むべきかどうかをコアに伝えます。
• messaging.targetResolver.reservedLiterals は、そのプロバイダーのチャネル/セッション参照である裸の単語を列挙します。解決では、予約リテラルを拒否する前に設定済みディレクトリエントリーを保持し、その後ディレクトリミスでは fail closed します。
• messaging.targetResolver.resolveTarget(...) は、正規化後またはディレクトリミス後に、コアが最終的なプロバイダー所有の解決を必要とする場合の Plugin フォールバックです。
• messaging.resolveOutboundSessionRoute(...) は、ターゲット解決後のプロバイダー固有セッションルート構築を所有します。

• ピア/グループを検索する前に行うべきカテゴリ判断には inferTargetChatType を使用します。
• 「これを明示的/ネイティブターゲット ID として扱う」チェックには looksLikeId を使用します。
• 広範なディレクトリ検索ではなく、プロバイダー固有の正規化フォールバックには resolveTarget を使用します。
• チャット ID、スレッド ID、JID、ハンドル、ルーム ID などのプロバイダーネイティブ ID は、汎用 SDK フィールドではなく、target 値またはプロバイダー固有 params 内に保持してください。

​

設定に基づくディレクトリ

• allowlist 駆動の DM ピア
• 設定済みチャネル/グループマップ
• アカウントスコープの静的ディレクトリフォールバック

• クエリフィルタリング
• 制限の適用
• 重複排除/正規化ヘルパー
• ChannelDirectoryEntry[] の構築

​

プロバイダーカタログ

• 1 つのプロバイダーエントリー用の { provider }
• 複数のプロバイダーエントリー用の { providers }

• simple: プレーンな API キーまたは env 駆動のプロバイダー
• profile: 認証プロファイルが存在すると現れるプロバイダー
• paired: 複数の関連プロバイダーエントリーを合成するプロバイダー
• late: 他の暗黙プロバイダー後の最後のパス

• discovery はレガシーエイリアスとして引き続き動作しますが、非推奨警告を出します
• catalog と discovery の両方が登録されている場合、OpenClaw は catalog を使用し、警告を出します
• augmentModelCatalog は非推奨です。バンドル済みプロバイダーは registerModelCatalogProvider を通じて補足行を公開するべきです

​

読み取り専用チャネル検査

• resolveAccount(...) はランタイム経路です。資格情報が完全に具体化されていると仮定でき、必要なシークレットがない場合は即座に失敗できます。
• openclaw status、openclaw status --all、 openclaw channels status、openclaw channels resolve、doctor/設定 修復フローなどの読み取り専用コマンド経路は、設定を説明するだけのためにランタイム資格情報を具体化する必要があるべきではありません。

• 説明的なアカウント状態のみを返します。
• enabled と configured を保持します。
• 関連する場合は、次のような資格情報ソース/ステータスフィールドを含めます:
  • tokenSource, tokenStatus
  • botTokenSource, botTokenStatus
  • appTokenSource, appTokenStatus
  • signingSecretSource, signingSecretStatus
• 読み取り専用の可用性を報告するだけなら、生のトークン値を返す必要はありません。ステータス系コマンドには、tokenStatus: "available"（および一致する source フィールド）を返せば十分です。
• 資格情報が SecretRef 経由で設定されているものの、現在のコマンド経路で利用できない場合は configured_unavailable を使用します。

​

パッケージパック

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

• チャンネル登録自体
• Gateway が listen を開始する前に利用可能である必要がある HTTP ルート
• 同じ期間中に存在している必要がある Gateway メソッド、ツール、またはサービス

• singleAccountKeysToMove
• namedAccountPromotionKeys
• resolveSingleAccountPromotionTarget(...)

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

​

チャンネルカタログメタデータ

{
  "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: よりリッチなカタログ/ステータスサーフェス向けの副ラベル
• docsLabel: docs リンクのリンクテキストを上書き
• preferOver: このカタログエントリが上回るべき、より低優先度の Plugin/チャンネル id
• selectionDocsPrefix, selectionDocsOmitLabel, selectionExtras: 選択サーフェスのコピー制御
• markdownCapable: 送信フォーマット判断のために、チャンネルを markdown 対応としてマーク
• exposure.configured: false に設定した場合、設定済みチャンネル一覧サーフェスからチャンネルを非表示
• exposure.setup: false に設定した場合、対話型セットアップ/設定ピッカーからチャンネルを非表示
• exposure.docs: docs ナビゲーションサーフェス向けにチャンネルを internal/private としてマーク
• showConfigured / showInSetup: 互換性のためにまだ受け入れられるレガシーエイリアス。exposure を優先
• quickstartAllowFrom: 標準クイックスタート allowFrom フローへチャンネルをオプトイン
• forceAccountBinding: アカウントが 1 つしか存在しない場合でも、明示的なアカウント binding を要求
• preferSessionLookupForAnnounceTarget: announce target の解決時に session lookup を優先

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

​

コンテキストエンジン Plugin

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

​

新しい capability の追加

1. core contract を定義します。 core が所有すべき shared behavior を決めます: policy、fallback、config merge、lifecycle、channel-facing semantics、 runtime helper shape。
2. typed plugin registration/runtime surface を追加します。 OpenClawPluginApi や api.runtime を、最小限で有用な typed capability surface で拡張します。
3. core + channel/feature consumer を結線します。 チャンネルと feature Plugin は、 vendor 実装を直接 import するのではなく、core 経由で新しい capability を consume するべきです。
4. vendor implementation を登録します。 その後、vendor Plugin が capability に対して backend を登録します。
5. contract coverage を追加します。 ownership と registration shape が 時間が経っても明示的なままになるよう、テストを追加します。

​

capability チェックリスト

• src/<capability>/types.ts のコア契約型
• src/<capability>/runtime.ts のコアランナー/ランタイムヘルパー
• src/plugins/types.ts の Plugin API 登録サーフェス
• src/plugins/registry.ts の Plugin レジストリ接続
• 機能/チャネル Plugin が利用する必要がある場合の src/plugins/runtime/* における Plugin ランタイム公開
• src/test-utils/plugin-registration.ts のキャプチャ/テストヘルパー
• src/plugins/contracts/registry.ts の所有権/契約アサーション
• docs/ のオペレーター/Plugin ドキュメント

​

ケイパビリティテンプレート

// 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(pluginManifest.contracts?.videoGenerationProviders).toEqual(["openai"]);

• コアはケイパビリティ契約 + オーケストレーションを所有する
• ベンダー Plugin はベンダー実装を所有する
• 機能/チャネル Plugin はランタイムヘルパーを利用する
• 契約テストは所有権を明示的に保つ

​

関連

• Plugin アーキテクチャ — 公開ケイパビリティモデルと形状
• Plugin SDK サブパス
• Plugin SDK セットアップ
• Plugin の構築