插件架构内部机制

​

加载流水线

1. 发现候选插件根目录
2. 读取原生或兼容的捆绑包清单及软件包元数据
3. 拒绝不安全的候选项
4. 规范化插件配置（plugins.enabled、allow、deny、entries、 slots、load.paths）
5. 决定是否启用每个候选项
6. 加载已启用的原生模块：构建后的内置模块使用原生加载器； 第三方本地源代码 TypeScript 使用应急 Jiti 回退方案
7. 调用原生 register(api) 钩子，并将注册项收集到插件注册表中
8. 向命令/运行时界面公开注册表

• 其解析后的入口逸出插件根目录
• 其路径（或根目录）可由所有用户写入
• 对于非内置插件，路径所有权与当前 uid（或 root）不匹配

​

清单优先行为

• 识别插件
• 发现已声明的渠道/Skills/配置架构或捆绑包能力
• 验证 plugins.entries.<id>.config
• 补充 Control UI 标签/占位符
• 显示安装/目录元数据
• 保留轻量的激活和设置描述符，而不加载插件运行时

• CLI 加载将范围缩小到拥有所请求主命令的插件
• 渠道设置/插件解析将范围缩小到拥有所请求 渠道 ID 的插件
• 显式提供商设置/运行时解析将范围缩小到拥有所请求 提供商 ID 的插件
• Gateway 网关启动规划使用 activation.onStartup 进行显式启动 导入；没有启动元数据的插件仅通过范围更窄的 激活触发器加载

​

插件缓存边界

• PluginLoaderCacheState 和兼容的活动运行时注册表
• 用于避免重复导入同一运行时界面的 jiti/模块缓存和公共界面加载器缓存
• 已安装插件工件的文件系统缓存
• 用于路径规范化或重复项解析的短期单次调用映射

• 发现结果
• 直接清单注册表
• 根据已安装插件索引重建的清单注册表
• 提供商所有者查找、模型抑制、提供商策略或公共工件 元数据
• 任何其他清单派生的答案，其中已更改的清单、已安装索引 或加载路径应在下一次元数据读取时可见

​

注册表模型

• 插件模块 -> 注册表注册
• 核心运行时 -> 注册表使用

​

对话绑定回调

export default {
  id: "my-plugin",
  register(api) {
    api.onConversationBindingResolved(async (event) => {
      if (event.status === "approved") {
        // 此插件 + 对话现在已有一个绑定。
        console.log(event.binding?.conversationId);
        return;
      }

      // 请求已被拒绝；清除所有本地待处理状态。
      console.log(event.request.conversation.conversationId);
    });
  },
};

• status："approved" 或 "denied"
• decision："allow-once"、"allow-always" 或 "deny"
• binding：已获批请求解析后的绑定
• request：原始请求摘要、分离提示、发送者 ID 和 对话元数据

​

提供商运行时钩子

• 用于低成本运行时前查找的清单元数据： setup.providers[].envVars、providerAuthAliases、providerAuthChoices 和 channelConfigs。
• 配置时钩子：catalog 加 applyConfigDefaults。
• 运行时钩子：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 输出负载。
• 使用核心 tts 配置和提供商选择。
• 返回 PCM 音频缓冲区和采样率。插件必须为提供商重新采样/编码。
• listVoices 对每个提供商均为可选。可将其用于供应商自有的语音选择器或设置流程。
• 核心会向提供商的 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 添加这些能力契约，一个供应商插件可以负责文本、语音、图像以及未来的媒体提供商。

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

• 将编排、回退、配置和渠道接线保留在核心中。
• 将供应商行为保留在提供商插件中。
• 增量扩展应保持类型化：新增可选方法、新增可选结果字段、新增可选能力。
• 视频生成已遵循相同模式：
  • 核心负责能力契约和运行时辅助函数
  • 供应商插件注册 api.registerVideoGenerationProvider(...)
  • 功能/渠道插件使用 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.6-sol",
  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(...) 是面向插件的接口，用于由提供商负责、范围受限且以图像为主的提取。至少包含一个图像输入；文本输入仅作为补充上下文。产品插件负责其路由和 schema，而 OpenClaw 负责提供商/运行时边界。
• 使用核心媒体理解音频配置（tools.media.audio）和提供商回退顺序。
• 未产生转录输出时（例如输入被跳过/不受支持），返回 { text: undefined }。

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

• provider 和 model 是可选的单次运行覆盖项，而非持久会话更改。
• toolsAlsoAllow 接受由调用插件注册且归属唯一的精确工具名称。核心工具名称和有歧义的名称会被拒绝。它是在常规配置文件基础上的增量补充，但操作员的允许列表和拒绝规则仍具有最终决定权。
• OpenClaw 仅对受信任的调用方采用这些覆盖字段。
• 对于插件自有的回退运行，操作员必须通过 plugins.entries.<id>.subagent.allowModelOverride: true 明确选择启用。
• 使用 plugins.entries.<id>.subagent.allowedModels 将受信任插件限制到特定的规范 provider/model 目标，或使用 "*" 显式允许任意目标。
• 不受信任插件的子智能体运行仍可工作，但覆盖请求会被拒绝，而不是静默回退。
• 插件创建的子智能体会话会标记创建它的插件 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.* 是需要搜索行为但不依赖智能体工具包装器的功能/渠道插件的首选共享界面。

​

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 验证。
• match：可选。"exact"（默认）或 "prefix"。
• handleUpgrade：可选，用于处理同一路由上的 WebSocket 升级请求。
• replaceExisting：可选。允许同一插件替换自己现有的路由注册。
• handler：路由已处理请求时返回 true。

• api.registerHttpHandler(...) 已被移除，并会导致插件加载错误。请改用 api.registerHttpRoute(...)。
• 插件路由必须显式声明 auth。
• 除非设置 replaceExisting: true，否则完全相同的 path + match 冲突会被拒绝，并且一个插件无法替换另一个插件的路由。
• 具有不同 auth 级别的重叠路由会被拒绝。exact/prefix 回退链只能使用同一身份验证级别。
• auth: "plugin" 路由不会自动获得操作员运行时权限范围。它们用于插件管理的 webhook/签名验证，而非特权 Gateway 网关辅助调用。
• auth: "gateway" 路由在 Gateway 网关请求运行时权限范围内运行。默认表面（gatewayRuntimeScopeSurface: "write-default"）有意采用保守策略：
  • 共享密钥持有者身份验证（gateway.auth.mode = "token" / "password"）以及任何非可信代理身份验证方式仅获得一个 operator.write 权限范围，即使调用方发送了 x-openclaw-scopes
  • 未携带显式 x-openclaw-scopes 标头的 trusted-proxy 调用方也会保留旧版仅限 operator.write 的表面
  • 发送 x-openclaw-scopes 的 trusted-proxy 调用方将改为获得声明的权限范围
  • 路由可以选择加入 gatewayRuntimeScopeSurface: "trusted-operator"，以便对于携带身份的身份验证模式始终遵循 x-openclaw-scopes（缺少该标头时回退到完整的 CLI 默认权限范围集）
• 由 auth: "gateway" 路由支持的沙箱隔离外部 Control UI 标签页使用一种短期有效的签名 Cookie 授权，该授权仅由经过身份验证的引导程序签发；插件身份验证标签页则保留其直接 iframe 路径。挂载前，父级会在同一个不透明沙箱中运行路由自有的探测，并在浏览器隐私策略阻止 Cookie 时按关闭策略失败。该授权绑定到所属插件、匹配的路由根路径和当前身份验证代次；其进程随机 Cookie 名称可防止同一主机上受信任的 Gateway 网关相互覆盖，但 Cookie 绝不会隔离 TCP 端口。因此，Gateway 网关主机名构成一个凭据边界：不要在该主机名下共同托管互不信任的服务，包括其他端口上的服务。路由分发会拒绝将授权复用于另一个插件拥有的嵌套路由。由于沙箱后代在 Cookie 语义中属于跨站点，因此该授权仅接受带有 operator.read 的 GET 和 HEAD；变更操作和 WebSocket 升级仍须使用显式经过 Gateway 网关身份验证的表面。该 Cookie 有意不使用 CHIPS：当前浏览器会在分区键中包含跨站点祖先位，因此嵌套的不透明沙箱框架将无法访问同一路由的资源。该 Cookie 需要安全上下文以及浏览器授予的跨站点 Cookie 权限，因此，在纯 HTTP 局域网源或完全阻止第三方 Cookie 的环境下，使用 Gateway 网关身份验证的外部标签页不可用；请使用 HTTPS/Tailscale Serve，或采用兼容 Cookie 策略且受浏览器信任的回环地址。
• 该授权可防止 Gateway 网关持有者令牌泄露以及意外复用路由/权限范围；但它不会在原生插件之间建立安全边界。原生插件代码及其提供的 UI 内容仍属于同一个受信任的进程内插件边界。
• 实用规则：不要假定使用 Gateway 网关身份验证的插件路由隐式具有管理员表面。如果路由需要仅限管理员的行为，请选择加入 trusted-operator 权限范围表面，要求使用携带身份的身份验证模式，并记录明确的 x-openclaw-scopes 标头约定。
• 完成路由匹配和身份验证后，常规处理程序会参与 Gateway 网关根工作准入。处于准备或重启状态的 Gateway 网关会在调用处理程序前返回 503。唯一的有限例外是清单授予权限的 auth: "gateway" 路由，且该路由还选择加入路由特定的 trusted-operator 表面；该路由仍可访问，以免暂停控制分发陷入停滞，而同一插件的常规同级路由仍位于准入边界之后。WebSocket handleUpgrade 所有权使用相同的原子准入边界；处理程序接受套接字后，该套接字的后续生命周期由插件负责，不受此边界跟踪。

​

插件 SDK 导入路径

• index.js — 内置插件入口
• api.js — 辅助函数/类型聚合导出
• runtime-api.js — 仅运行时聚合导出
• setup-entry.js — 设置插件入口

​

消息工具架构

• presentation 用于语义呈现区块（text、context、 divider、chart、table、buttons、select）
• delivery-pin 用于置顶投递请求

​

渠道目标解析

• messaging.inferTargetChatType({ to }) 决定规范化目标 在目录查找前应被视为 direct、group 还是 channel。
• messaging.targetResolver.looksLikeId(raw, normalized) 告知核心某个 输入是否应跳过目录搜索，直接进行类似 ID 的解析。
• messaging.targetResolver.reservedLiterals 列出对该提供商而言属于 渠道/会话引用的裸词。解析会在拒绝保留字面量之前保留已配置的 目录条目，然后在目录未命中时按关闭策略失败。
• messaging.targetResolver.resolveTarget(...) 是当核心 在规范化后或目录未命中后需要最终由提供商负责解析时使用的插件回退。
• messaging.resolveOutboundSessionRoute(...) 在目标解析完成后负责构建 提供商特定的会话路由。

• 对于应在搜索对等方/群组之前进行的类别判断，使用 inferTargetChatType。
• 对于“将其视为显式/原生目标 ID”的检查，使用 looksLikeId。
• 将 resolveTarget 用于提供商特定的规范化回退，而非 宽泛的目录搜索。
• 将聊天 ID、话题 ID、JID、用户名和房间 ID 等提供商原生 ID 保留在 target 值或提供商特定参数中，而不要放入通用 SDK 字段。

​

配置支持的目录

• 由允许列表驱动的私信对等方
• 已配置的渠道/群组映射
• 账户范围的静态目录回退

• 查询筛选
• 应用数量限制
• 去重/规范化辅助函数
• 构建 ChannelDirectoryEntry[]

​

提供商目录

• { provider } 用于单个提供商条目
• { providers } 用于多个提供商条目

• simple：使用普通 API 密钥或由环境变量驱动的提供商
• 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"（以及匹配的来源字段）即可。
• 当凭据通过 SecretRef 配置但在当前命令路径中不可用时，请使用 configured_unavailable。

​

软件包包组

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

• 渠道注册本身
• Gateway 网关开始监听前必须可用的所有 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（自托管）",
      "docsPath": "/channels/nextcloud-talk",
      "docsLabel": "nextcloud-talk",
      "blurb": "通过 Nextcloud Talk webhook Bot 提供自托管聊天。",
      "order": 65,
      "aliases": ["nc-talk", "nc"]
    },
    "install": {
      "npmSpec": "@openclaw/nextcloud-talk",
      "localPath": "<bundled-plugin-local-path>",
      "defaultChoice": "npm"
    }
  }
}

• detailLabel：用于内容更丰富的目录/状态界面的辅助标签
• docsLabel：覆盖文档链接的链接文本
• preferOver：此目录条目应优先于的低优先级插件/渠道 ID
• selectionDocsPrefix、selectionDocsOmitLabel、selectionExtras：选择界面的文案控制项
• markdownCapable：将渠道标记为支持 Markdown，用于出站格式决策
• exposure.configured：设为 false 时，在已配置渠道列表界面中隐藏该渠道
• exposure.setup：设为 false 时，在交互式设置/配置选择器中隐藏该渠道
• exposure.docs：将渠道标记为供文档导航界面使用的内部/私有渠道
• quickstartAllowFrom：使渠道加入标准快速开始 allowFrom 流程
• forceAccountBinding：即使仅存在一个账户，也要求显式绑定账户
• preferSessionLookupForAnnounceTarget：解析公告目标时优先查找会话

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

​

上下文引擎插件

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, sessionKey, availableTools, citationsMode }) {
      return {
        messages,
        estimatedTokens: 0,
        systemPromptAddition: buildMemorySystemPromptAddition({
          availableTools: availableTools ?? new Set(),
          citationsMode,
          agentSessionKey: sessionKey,
        }),
      };
    },
    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, sessionKey, availableTools, citationsMode }) {
      return {
        messages,
        estimatedTokens: 0,
        systemPromptAddition: buildMemorySystemPromptAddition({
          availableTools: availableTools ?? new Set(),
          citationsMode,
          agentSessionKey: sessionKey,
        }),
      };
    },
    async compact(params) {
      return await delegateCompactionToRuntime(params);
    },
  }));
}

​

添加新能力

1. 定义核心契约。 确定核心应负责哪些共享行为： 策略、回退、配置合并、生命周期、面向渠道的语义以及 运行时辅助程序的结构。
2. 添加类型化的插件注册和运行时接口。 使用最小且实用的类型化 能力接口扩展 OpenClawPluginApi 和/或 api.runtime。
3. 连接核心与渠道/功能使用方。 渠道和功能插件 应通过核心使用新能力，而不是直接导入某个供应商的 实现。
4. 注册供应商实现。 然后由供应商插件针对该能力注册其 后端。
5. 添加契约覆盖。 添加测试，使所有权和注册结构 随时间推移仍保持明确。

​

能力检查清单

• src/<capability>/types.ts 中的核心契约类型
• src/<capability>/runtime.ts 中的核心运行器/运行时辅助程序
• src/plugins/types.ts 中的插件 API 注册接口
• src/plugins/registry.ts 中的插件注册表连接
• 当功能/渠道插件需要使用该能力时，在 src/plugins/runtime/* 中 公开插件运行时
• src/test-utils/plugin-registration.ts 中的捕获/测试辅助程序
• src/plugins/contracts/registry.ts 中的所有权/契约断言
• docs/ 中的操作员/插件文档

​

能力模板

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

• 核心负责能力契约和编排
• 供应商插件负责供应商实现
• 功能/渠道插件使用运行时辅助程序
• 契约测试确保所有权保持明确

​

相关内容

• 插件架构 — 公共能力模型和结构
• 插件 SDK 子路径
• 插件 SDK 设置
• 构建插件