mirror of
https://github.com/openclaw/openclaw.git
synced 2026-05-06 07:40:44 +00:00
docs: explain provider index authority
This commit is contained in:
@@ -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`,
|
||||
|
||||
Reference in New Issue
Block a user