Model configuration guide · Independent guidance

Change the default OpenClaw model and configure fallbacks

Use `openclaw models list` and `openclaw models status` before changing the default. Select an exact provider/model reference with `openclaw models set`, then verify authentication and a real request. Unknown model references are rejected by current config writers rather than silently saved.

Current snapshotUpdated 2026-08-24Official docs main snapshot · OpenClaw 2026.8.1
01

Change one variable at a time

  1. 1

    List visible models

    Confirm the provider plugin/catalog and exact model reference.

    openclaw models list
  2. 2

    Inspect auth without printing secrets

    Review profile state and provider readiness.

    openclaw models auth list
    openclaw models status --json
  3. 3

    Set the primary model

    Use the exact provider/model identifier shown by the catalog.

    openclaw models set <provider>/<model>
  4. 4

    Validate and smoke test

    Confirm config and run a bounded request before relying on automations.

    openclaw config validate
    openclaw doctor
02

Fallbacks change cost and failure behavior

A fallback can improve availability but also hide provider-specific failures and change cost, latency, privacy, context limits, or tool behavior. Keep the fallback list short, test each route, and record which errors should fail closed instead of routing elsewhere.

Primary sources

Verify against the owner.

Content snapshot follows official docs main at the recorded commit; the current package metadata reported 2026.8.1 when verified. Your installed release and live CLI schema remain authoritative.