diff --git a/CHANGELOG.md b/CHANGELOG.md
index 667e134e4fe..232bbd32470 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -143,7 +143,7 @@ Docs: https://docs.openclaw.ai
 
 ### Fixes
 
-- CLI/models: keep Chutes and Kilo static catalog rows visible through refreshable manifest catalog metadata while provider-filtered manifest list paths avoid registry/runtime discovery unless a provider requires runtime rows. Thanks @shakkernerd.
+- CLI/models: keep Chutes and Kilo static catalog rows visible through refreshable manifest catalog metadata while provider-filtered refreshable providers remain registry-backed and merge manifest rows as supplements. Thanks @shakkernerd.
 - CLI/models: skip duplicate catalog supplement resolution during broad `models list --all` output so already-listed registry rows do not pay a second registry lookup pass. Thanks @shakkernerd.
 - CLI/models: move OpenAI and OpenCode Go forward-compat list rows into refreshable manifest catalogs and stop broad `models list --all` from loading runtime catalog supplement hooks. Thanks @shakkernerd.
 - CLI/models: keep broad unfiltered `models list --all` on raw registry rows instead of loading every provider runtime normalization hook, while preserving full normalization for provider-filtered and configured model paths. Thanks @shakkernerd.
diff --git a/docs/cli/models.md b/docs/cli/models.md
index c9c505c79e9..f3ceac3aadd 100644
--- a/docs/cli/models.md
+++ b/docs/cli/models.md
@@ -53,8 +53,9 @@ Notes:
   unavailable until matching auth is configured.
 - Broad `models list --all` merges manifest catalog rows over registry rows
   without loading provider runtime supplement hooks. Provider-filtered manifest
-  fast paths use `static` and `refreshable` manifest rows; providers marked
-  `runtime` stay on registry/runtime discovery.
+  fast paths use only providers marked `static`; providers marked `refreshable`
+  stay registry/cache-backed and append manifest rows as supplements, while
+  providers marked `runtime` stay on registry/runtime discovery.
 - `models list` keeps native model metadata and runtime caps distinct. In table
   output, `Ctx` shows `contextTokens/contextWindow` when an effective runtime
   cap differs from the native context window; JSON rows include `contextTokens`
diff --git a/docs/plugins/manifest.md b/docs/plugins/manifest.md
index d68da9c4767..e5440d6288a 100644
--- a/docs/plugins/manifest.md
+++ b/docs/plugins/manifest.md
@@ -784,8 +784,9 @@ Suppression fields:
 Do not put runtime-only data in `modelCatalog`. Use `static` only when manifest
 rows are complete enough for provider-filtered list and picker surfaces to skip
 registry/runtime discovery. Use `refreshable` when manifest rows are useful
-seeds or supplements but a registry/cache refresh may add more rows. Use
-`runtime` when OpenClaw must load provider runtime to know the list.
+listable seeds or supplements but a refresh/cache can add more rows later;
+refreshable rows are not authoritative by themselves. Use `runtime` when OpenClaw
+must load provider runtime to know the list.
 
 ## modelIdNormalization reference