清单提供者字段

清单字段告诉核心提供程序可以做什么以及如何实现它，而无需导入提供程序运行时。 插件清单参考的一部分； 顶级字段引用 列出了每个字段。

生成 provider 元数据参考

generation provider 元数据字段描述的是与匹配的 contracts.*GenerationProviders 列表中声明的 provider 相关的静态 auth 信号。OpenClaw 会在 provider 运行时加载之前读取这些字段，因此核心工具可以在不导入每个 provider 插件的情况下，判断某个 generation provider 是否可用。

仅将这些字段用于便宜、声明式的事实。传输、请求转换、token 刷新、凭证验证以及实际生成行为都保留在插件运行时中。

{  "contracts": {    "imageGenerationProviders": ["example-image"]  },  "imageGenerationProviderMetadata": {    "example-image": {      "aliases": ["example-image-oauth"],      "authProviders": ["example-image"],      "configSignals": [        {          "rootPath": "plugins.entries.example-image.config",          "overlayPath": "image",          "mode": {            "path": "mode",            "default": "local",            "allowed": ["local"]          },          "requiredAny": ["workflow", "workflowPath"],          "required": ["promptNodeId"]        }      ],      "authSignals": [        {          "provider": "example-image"        },        {          "provider": "example-image-oauth",          "providerBaseUrl": {            "provider": "example-image",            "defaultBaseUrl": "https://api.example.com/v1",            "allowedBaseUrls": ["https://api.example.com/v1"]          }        }      ]    }  }}

每个元数据条目支持：

每个 configSignals 条目支持：

配置信号检查标准化 SecretRefs 的提供商和环境可用性。其他非空对象是配置的元数据；仅包含 source 和 id 的对象不会被解释为 SecretRef。 Doctor 修复已声明凭证路径上的遗留引用，而无需重写不透明的插件数据。

每个 mode 守卫支持：

每个 authSignals 条目支持：

每个 providerBaseUrl 守卫支持：

mediaUnderstandingProviderMetadata 参考

当某个媒体理解提供商具有默认模型、自动认证回退优先级，或原生文档支持，而通用核心辅助函数在运行时加载之前就需要这些信息时，请使用 mediaUnderstandingProviderMetadata。这些键也必须在 contracts.mediaUnderstandingProviders 中声明。

{  "contracts": {    "mediaUnderstandingProviders": ["example"]  },  "mediaUnderstandingProviderMetadata": {    "example": {      "capabilities": ["image", "audio"],      "defaultModels": {        "image": "example-vision-latest",        "audio": "example-transcribe-latest"      },      "autoPriority": {        "image": 40      },      "nativeDocumentInputs": ["pdf"],      "documentModels": {        "pdf": {          "textExtraction": "example-doc-text-latest",          "image": "example-doc-vision-latest"        }      }    }  }}

每个提供商条目可以包含：

providerEndpoints 参考

将 providerEndpoints 用于端点分类，通用请求策略必须在 provider 运行时加载之前知晓这一信息。核心仍然负责每个 endpointClass 的含义，而插件清单负责主机和 base URL 元数据。

当操作员设置 models.providers.<id>.baseUrl 时，相同的端点元数据控制隐式模型目录资格。目录、别名和本机模型基本 URL 也算作声明的端点。不匹配的提供者级别 URL 排除清单、发现、静态和生成的目录行；明确创作的模型保留在库存中。没有本机端点声明的插件保留其现有的发现行为。主机和后缀匹配保留其请求分类规则，因此目录资格不会建立确切的来源信任或证明请求可以成功。

官方外部化的 provider 插件会被排除在核心 dist 之外，因此在安装之前，它们的清单是不可见的。它们的 providerEndpoints 也必须镜像到 scripts/lib/official-external-provider-catalog.json 中，这样即使没有插件，端点分类也能继续工作；契约测试会强制校验这份镜像。

端点字段：

providerRequest 参考

将 providerRequest 用于轻量级的请求兼容性元数据，这些元数据是通用请求策略所需的，而无需加载提供方运行时。把与行为相关的载荷重写保留在提供方运行时钩子或共享的提供方家族辅助函数中。

{  "providerRequest": {    "providers": {      "vllm": {        "family": "vllm",        "openAICompletions": {          "supportsStreamingUsage": true        }      }    }  }}

提供方字段：

modelParamsSchema 验证 agents.defaults.models["provider/model"] 和 agents.entries.<agentId>.models["provider/model"] 中的 params。它仅适用于声明的提供程序，并且仅接受插件拥有的提供程序 ID。保留 additionalProperties: true，以便共享运行时参数仍然可用。使用属性 title 和 description 作为标签并帮助进行架构查找。架构默认值是描述性的：验证不会将默认值插入模型覆盖层或更改其继承。此每个模型模式不涵盖全局和每个代理 params。

例如，vLLM 插件在此声明可选布尔值 priorityScheduling。在使用 --scheduling-policy priority 启动服务器后，操作员在确切的 vllm/<model> 条目的 params 下启用它。