From ec15fc076730a11a8d7f52b4bf3b78a2c23edd97 Mon Sep 17 00:00:00 2001 From: Florian Hines Date: Tue, 10 Mar 2026 14:05:03 -0500 Subject: [PATCH] docs(kiloclaw): add model commands section to Control UI page (#6888) * docs(kiloclaw): add model commands section to Control UI page Add a 'Changing Models' section to control-ui.md documenting the /model and /models slash commands for browsing and switching between 335+ models via the Control UI Chat. Add cross-reference from dashboard.md's 'Changing the Model' section pointing to the new docs. * docs(kiloclaw): add per-session note, default model config, and OpenClaw link Remove inline screenshot placeholder. Add note that /model switches apply per-session only, explain how to change the default model via openclaw.json, and link out to OpenClaw Model Providers docs for advanced configuration. * Apply suggestions from code review * Apply suggestions from code review --- .../kilo-docs/pages/kiloclaw/control-ui.md | 18 ++++++++++++++++++ packages/kilo-docs/pages/kiloclaw/dashboard.md | 2 ++ 2 files changed, 20 insertions(+) diff --git a/packages/kilo-docs/pages/kiloclaw/control-ui.md b/packages/kilo-docs/pages/kiloclaw/control-ui.md index c20a36e0410..03aec4885ca 100644 --- a/packages/kilo-docs/pages/kiloclaw/control-ui.md +++ b/packages/kilo-docs/pages/kiloclaw/control-ui.md @@ -27,6 +27,24 @@ For more details, please see the official [OpenClaw documentation](https://docs. Do not use the **Update** feature in the Control UI to update KiloClaw. Use **Redeploy** from the [KiloClaw Dashboard](/docs/kiloclaw/dashboard#redeploy) instead. Updating via the Control UI will not apply the correct KiloClaw platform image and may break your instance. {% /callout %} +## Changing Models + +The Control UI Chat tab doubles as a command line for model management. KiloClaw exposes 335+ models through the `kilocode` provider and you can browse and switch between them without leaving the chat. + +| Command | Description | +| ------------------------------------ | ------------------------------------------------------------------------------- | +| `/model status` | View the currently active model and provider | +| `/models kilocode` | Browse available models (paginated, 20 per page) | +| `/models kilocode ` | Jump to a specific page (e.g. `/models kilocode 2`) | +| `/model kilocode//` | Switch to a specific model (e.g. `/model kilocode/anthropic/claude-sonnet-4.6`) | +| `/models kilocode all` | List every available model at once | + +Each `/models` response includes helper text at the bottom with shortcuts for switching, paging, and listing all models. + +To change the default model for all new sessions, edit `agents.defaults.model.primary` in your `openclaw.json` via **Config** in the Control UI (or the [KiloClaw Dashboard](/docs/kiloclaw/dashboard#changing-the-model) for a quick dropdown pick). + +For the full list of providers, advanced configuration, and CLI commands, see the [OpenClaw Model Providers documentation](https://docs.openclaw.ai/providers). + ## Authentication Auth is handled via token or password on the WebSocket handshake. Remote connections require one-time device pairing — the pairing request appears on the [KiloClaw Dashboard](/docs/kiloclaw/dashboard#pairing-requests) or in the Control UI itself. diff --git a/packages/kilo-docs/pages/kiloclaw/dashboard.md b/packages/kilo-docs/pages/kiloclaw/dashboard.md index 2f44ac1271b..b051c715867 100644 --- a/packages/kilo-docs/pages/kiloclaw/dashboard.md +++ b/packages/kilo-docs/pages/kiloclaw/dashboard.md @@ -80,6 +80,8 @@ Gateway process info is only available when the machine is running. Select a model from the dropdown and click **Save & Provision**. The API key is platform-managed and refreshes automatically when you save — you never need to enter one. The key has a 30-day expiry. +For access to the full catalog of 335+ models, use the `/model` and `/models` commands in the [Control UI Chat](/docs/kiloclaw/control-ui#changing-models). + ### Channels You can connect Telegram, Discord, and Slack by entering bot tokens in the Settings tab. See [Connecting Chat Platforms](/docs/kiloclaw/chat-platforms) for setup instructions.