docs: explain provider index authority

This commit is contained in:
Shakker
2026-04-26 04:27:32 +01:00
parent 96ac51d23d
commit f1e28370c4

View File

@@ -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`,