From 87ff1957199e5ab52d434606e4952b215fa05933 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-sync[bot]" Date: Wed, 29 Apr 2026 17:08:28 +0000 Subject: [PATCH] chore(sync): mirror docs from openclaw/openclaw@a16f7fb6cd72804d2defcd7532a4aa84ff8a9a95 --- .openclaw-sync/source.json | 4 ++-- docs/concepts/models.md | 4 ++-- docs/tools/slash-commands.md | 2 +- docs/web/control-ui.md | 2 +- 4 files changed, 6 insertions(+), 6 deletions(-) diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json index 4fc984d88..09aabf3dd 100644 --- a/.openclaw-sync/source.json +++ b/.openclaw-sync/source.json @@ -1,5 +1,5 @@ { "repository": "openclaw/openclaw", - "sha": "df0074768c97326b582b3431655e047dd65fe9e5", - "syncedAt": "2026-04-29T16:26:47.005Z" + "sha": "a16f7fb6cd72804d2defcd7532a4aa84ff8a9a95", + "syncedAt": "2026-04-29T17:06:49.106Z" } diff --git a/docs/concepts/models.md b/docs/concepts/models.md index 0a3d7b41b..b4d30ecec 100644 --- a/docs/concepts/models.md +++ b/docs/concepts/models.md @@ -63,7 +63,7 @@ The same `provider/model` can mean different things depending on where it came f - User session selections are exact. `/model`, the model picker, `session_status(model=...)`, and `sessions.patch` store `modelOverrideSource: "user"`; if that selected provider/model is unreachable, OpenClaw fails visibly instead of falling through to another configured model. - Cron `--model` / payload `model` is a per-job primary. It still uses configured fallbacks unless the job supplies explicit payload `fallbacks` (use `fallbacks: []` for a strict cron run). - CLI default-model and allowlist pickers respect `models.mode: "replace"` by listing explicit `models.providers.*.models` instead of loading the full built-in catalog. -- The Control UI model picker asks the Gateway for its configured model view: `agents.defaults.models` when present, otherwise explicit `models.providers.*.models`, otherwise the full catalog so fresh installs are not blank. +- The Control UI model picker asks the Gateway for its configured model view: `agents.defaults.models` when present, otherwise explicit `models.providers.*.models` plus providers with usable auth. The full built-in catalog is reserved for explicit browse views such as `models.list` with `view: "all"` or `openclaw models list --all`. ## Quick model policy @@ -219,7 +219,7 @@ openclaw models image-fallbacks clear ### `models list` -Shows configured models by default. Useful flags: +Shows configured/auth-available models by default. Useful flags: Full catalog. Includes bundled provider-owned static catalog rows before auth is configured, so discovery-only views can show models that are unavailable until you add matching provider credentials. diff --git a/docs/tools/slash-commands.md b/docs/tools/slash-commands.md index 8e387a980..f340d9dc2 100644 --- a/docs/tools/slash-commands.md +++ b/docs/tools/slash-commands.md @@ -141,7 +141,7 @@ Current source-of-truth: - `/elevated [on|off|ask|full]` toggles elevated mode. Alias: `/elev`. - `/exec host= security= ask= node=` shows or sets exec defaults. - `/model [name|#|status]` shows or sets the model. - - `/models [provider] [page] [limit=|size=|all]` lists providers or models for a provider. + - `/models [provider] [page] [limit=|size=|all]` lists configured/auth-available providers or models for a provider; add `all` to browse that provider's full catalog. - `/queue ` manages queue behavior (`steer`, `interrupt`, `followup`, `collect`, `steer-backlog`) plus options like `debounce:2s cap:25 drop:summarize`. diff --git a/docs/web/control-ui.md b/docs/web/control-ui.md index e5bba9bf9..4c41a0d72 100644 --- a/docs/web/control-ui.md +++ b/docs/web/control-ui.md @@ -155,7 +155,7 @@ Imported themes are stored only in the current browser profile. They are not wri - During an active send and the final history refresh, the chat view keeps local optimistic user/assistant messages visible if `chat.history` briefly returns an older snapshot; the canonical transcript replaces those local messages once the Gateway history catches up. - `chat.inject` appends an assistant note to the session transcript and broadcasts a `chat` event for UI-only updates (no agent run, no channel delivery). - The chat header model and thinking pickers patch the active session immediately through `sessions.patch`; they are persistent session overrides, not one-turn-only send options. - - The chat model picker requests the Gateway's configured model view. If `agents.defaults.models` is present, that allowlist drives the picker. Otherwise the picker shows explicit `models.providers.*.models` entries before falling back to the full catalog for fresh installs. + - The chat model picker requests the Gateway's configured model view. If `agents.defaults.models` is present, that allowlist drives the picker. Otherwise the picker shows explicit `models.providers.*.models` entries plus providers with usable auth. The full catalog stays available through the debug `models.list` RPC with `view: "all"`. - When fresh Gateway session usage reports show high context pressure, the chat composer area shows a context notice and, at recommended compaction levels, a compact button that runs the normal session compaction path. Stale token snapshots are hidden until the Gateway reports fresh usage again.