> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Models CLI

# Models CLI

Se [/concepts/model-failover](/concepts/model-failover) för auth profil
rotation, cooldowns, och hur det interagerar med fallbackar.
Snabb leverantörsöversikt + exempel: [/concepts/model-providers](/concepts/model-providers).

## Hur modellval fungerar

OpenClaw väljer modeller i denna ordning:

1. **Primär** modell (`agents.defaults.model.primary` eller `agents.defaults.model`).
2. **Fallbacks** i `agents.defaults.model.fallbacks` (i ordning).
3. **Provider auth failover** sker inom en leverantör innan man går vidare till
   nästa modell.

Relaterat:

* `agents.defaults.models` är tillåtelselistan/katalogen över modeller som OpenClaw kan använda (inklusive alias).
* `agents.defaults.imageModel` används **endast när** den primära modellen inte kan ta emot bilder.
* Standardvärden per agent kan åsidosätta `agents.defaults.model` via `agents.list[].model` samt bindningar (se [/concepts/multi-agent](/concepts/multi-agent)).

## Snabba modellval (anekdotiskt)

* **GLM**: lite bättre för kodning/verktygsanrop.
* **MiniMax**: bättre för skrivande och känsla.

## Setup‑guide (rekommenderas)

Om du inte vill redigera konfig manuellt, kör introduktionsguiden:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard
```

Den kan sätta upp modell + auth för vanliga leverantörer, inklusive **OpenAI Code (Codex)
prenumeration** (OAuth) och **Anthropic** (API‑nyckel rekommenderas; `claude
setup-token` stöds också).

## Konfig-nycklar (översikt)

* `agents.defaults.model.primary` och `agents.defaults.model.fallbacks`
* `agents.defaults.imageModel.primary` och `agents.defaults.imageModel.fallbacks`
* `agents.defaults.models` (tillåtelselista + alias + leverantörsparametrar)
* `models.providers` (anpassade leverantörer skrivs in i `models.json`)

Modell refs normaliseras till gemener. Leverantörens alias som `z.ai/*` normalisera
till `zai/*`.

Exempel på leverantörskonfiguration (inklusive OpenCode Zen) finns i
[/gateway/configuration](/gateway/configuration#opencode-zen-multi-model-proxy).

## ”Model is not allowed” (och varför svar upphör)

Om `agents.defaults.models` är satt, blir det **allowlist** för `/model` och för
session overrides. När en användare väljer en modell som inte är i den tillåtna listan, returnerar
OpenClaw:

```
Model "provider/model" is not allowed. Use /model to list available models.
```

Detta händer **innan** ett normalt svar genereras, så meddelandet kan kännas
som att det “inte svara”. Åtgärden är att antingen:

* Lägga till modellen i `agents.defaults.models`, eller
* Rensa tillåtelselistan (ta bort `agents.defaults.models`), eller
* Välja en modell från `/model list`.

Exempel på tillåtelseliste‑konfig:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agent: {
    model: { primary: "anthropic/claude-sonnet-4-5" },
    models: {
      "anthropic/claude-sonnet-4-5": { alias: "Sonnet" },
      "anthropic/claude-opus-4-6": { alias: "Opus" },
    },
  },
}
```

## Byta modeller i chatten (`/model`)

Du kan byta modell för den aktuella sessionen utan att starta om:

```
/model
/model list
/model 3
/model openai/gpt-5.2
/model status
```

Noteringar:

* `/model` (och `/model list`) är en kompakt, numrerad väljare (modellfamilj + tillgängliga leverantörer).
* `/model <#>` väljer från den väljaren.
* `/model status` är den detaljerade vyn (auth‑kandidater och, när konfigurerat, leverantörens endpoint `baseUrl` + läge `api`).
* Modellrefs tolkas genom att dela på **först** `/`. Använd `provider/model` när du skriver `/model <ref>`.
* Om modell‑ID:t i sig innehåller `/` (OpenRouter‑stil) måste du inkludera leverantörsprefixet (exempel: `/model openrouter/moonshotai/kimi-k2`).
* Om du utelämnar leverantören behandlar OpenClaw inmatningen som ett alias eller en modell för **standardleverantören** (fungerar endast när det inte finns något `/` i modell‑ID:t).

Fullständigt beteende/konfig för kommandon: [Slash commands](/tools/slash-commands).

## CLI‑kommandon

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models list
openclaw models status
openclaw models set <provider/model>
openclaw models set-image <provider/model>

openclaw models aliases list
openclaw models aliases add <alias> <provider/model>
openclaw models aliases remove <alias>

openclaw models fallbacks list
openclaw models fallbacks add <provider/model>
openclaw models fallbacks remove <provider/model>
openclaw models fallbacks clear

openclaw models image-fallbacks list
openclaw models image-fallbacks add <provider/model>
openclaw models image-fallbacks remove <provider/model>
openclaw models image-fallbacks clear
```

`openclaw models` (utan underkommando) är en genväg för `models status`.

### `models list`

Visar konfigurerade modeller som standard. Användbara flaggor:

* `--all`: full katalog
* `--local`: endast lokala leverantörer
* `--provider <name>`: filtrera efter leverantör
* `--plain`: en modell per rad
* `--json`: maskinläsbar utdata

### `models status`

Visar den upplösta primära modellen, fallbackar, bildmodell och en auth översikt
av konfigurerade leverantörer. Den ytbehandlar också OAuth utgångsstatus för profiler som hittats
i auth butiken (varnar inom 24h som standard). `--plain` skriver bara ut
löste primärmodellen.
OAuth status visas alltid (och ingår i `--json` utgång). Om en konfigurerad
-leverantör inte har några inloggningsuppgifter, skriver `models status` ut en **Missing auth**-sektion.
JSON innehåller `auth.oauth` (varna fönster + profiler) och `auth.providers`
(effektiv auth per leverantör).
Använd `--check` för automatisering (exit `1` när det saknas/upphör, `2` vid upphörande).

Föredragen Anthropic‑auth är Claude Code CLI setup‑token (kör var som helst; klistra in på gateway‑värden vid behov):

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
claude setup-token
openclaw models status
```

## Skanning (OpenRouter gratis‑modeller)

`openclaw models scan` inspekterar OpenRouters **katalog över gratis modeller** och kan
valfritt proba modeller för stöd för verktyg och bilder.

Viktiga flaggor:

* `--no-probe`: hoppa över live‑prober (endast metadata)
* `--min-params <b>`: minsta parameterstorlek (miljarder)
* `--max-age-days <days>`: hoppa över äldre modeller
* `--provider <name>`: filter för leverantörsprefix
* `--max-candidates <n>`: storlek på fallback‑lista
* `--set-default`: sätt `agents.defaults.model.primary` till första valet
* `--set-image`: sätt `agents.defaults.imageModel.primary` till första bildvalet

Probing kräver en OpenRouter API-nyckel (från auth profiler eller
`OPENROUTER_API_KEY`). Utan en nyckel, använd `--no-probe` endast för att lista kandidater.

Skanningsresultat rangordnas efter:

1. Bildstöd
2. Verktygslatens
3. Kontextstorlek
4. Antal parametrar

Indata

* OpenRouter `/models`‑lista (filtrera `:free`)
* Kräver OpenRouter API‑nyckel från auth‑profiler eller `OPENROUTER_API_KEY` (se [/environment](/help/environment))
* Valfria filter: `--max-age-days`, `--min-params`, `--provider`, `--max-candidates`
* Probstyrning: `--timeout`, `--concurrency`

När du kör i en TTY, kan du välja fallbackar interaktivt. I icke-interaktivt
-läge, passera `--ja` för att acceptera standardinställningar.

## Modellregister (`models.json`)

Anpassade leverantörer i `models.providers` skrivs in i `models.json` under
agentkatalogen (standard `~/.openclaw/agents/<agentId>/models.json`). Denna fil
slås samman som standard såvida inte `models.mode` är satt till `ersätta`.