Models CLI¶

Se /concepts/model-failover för auth profil rotation, cooldowns, och hur det interagerar med fallbackar. Snabb leverantörsöversikt + exempel: /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).

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:

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.

”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:

{
  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.

CLI‑kommandon¶

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):

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)
• 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.