From f1e28370c4b1a41d642fecda1be4b46b043eac83 Mon Sep 17 00:00:00 2001 From: Shakker Date: Sun, 26 Apr 2026 04:27:32 +0100 Subject: [PATCH] docs: explain provider index authority --- docs/plugins/manifest.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/docs/plugins/manifest.md b/docs/plugins/manifest.md index b61f15d9593..28aa23573fc 100644 --- a/docs/plugins/manifest.md +++ b/docs/plugins/manifest.md @@ -725,6 +725,25 @@ Do not put runtime-only data in `modelCatalog`. If a provider needs account state, an API request, or local process discovery to know the complete model set, declare that provider as `refreshable` or `runtime` in `discovery`. +### OpenClaw Provider Index + +The OpenClaw Provider Index is OpenClaw-owned preview metadata for providers +whose plugins may not be installed yet. It is not part of a plugin manifest. +Use plugin manifests for installed plugin authority; use the Provider Index only +for installable-provider and pre-install model picker surfaces. + +Catalog authority order: + +1. User config. +2. Installed plugin manifest `modelCatalog`. +3. Model catalog cache from explicit refresh. +4. OpenClaw Provider Index preview rows. + +The Provider Index must not contain secrets, enabled state, runtime hooks, or +live account-specific model data. Providers with live `/models` discovery should +write refreshed rows through the explicit model catalog cache path instead of +making normal listing or onboarding call provider APIs. + Legacy top-level capability keys are deprecated. Use `openclaw doctor --fix` to move `speechProviders`, `realtimeTranscriptionProviders`, `realtimeVoiceProviders`, `mediaUnderstandingProviders`,