{
  "title": "`openclaw models`",
  "content": "Model discovery, scanning, and configuration (default model, fallbacks, auth profiles).\n\n* Providers + models: [Models](/providers/models)\n* Provider auth setup: [Getting started](/start/getting-started)\n\n`openclaw models status` shows the resolved default/fallbacks plus an auth overview.\nWhen provider usage snapshots are available, the OAuth/token status section includes\nprovider usage headers.\nAdd `--probe` to run live auth probes against each configured provider profile.\nProbes are real requests (may consume tokens and trigger rate limits).\nUse `--agent <id>` to inspect a configured agent’s model/auth state. When omitted,\nthe command uses `OPENCLAW_AGENT_DIR`/`PI_CODING_AGENT_DIR` if set, otherwise the\nconfigured default agent.\n\n* `models set <model-or-alias>` accepts `provider/model` or an alias.\n* Model refs are parsed by splitting on the **first** `/`. If the model ID includes `/` (OpenRouter-style), include the provider prefix (example: `openrouter/moonshotai/kimi-k2`).\n* If you omit the provider, OpenClaw treats the input as an alias or a model for the **default provider** (only works when there is no `/` in the model ID).\n\n* `--json`\n* `--plain`\n* `--check` (exit 1=expired/missing, 2=expiring)\n* `--probe` (live probe of configured auth profiles)\n* `--probe-provider <name>` (probe one provider)\n* `--probe-profile <id>` (repeat or comma-separated profile ids)\n* `--probe-timeout <ms>`\n* `--probe-concurrency <n>`\n* `--probe-max-tokens <n>`\n* `--agent <id>` (configured agent id; overrides `OPENCLAW_AGENT_DIR`/`PI_CODING_AGENT_DIR`)\n\n## Aliases + fallbacks\n\n`models auth login` runs a provider plugin’s auth flow (OAuth/API key). Use\n`openclaw plugins list` to see which providers are installed.\n\n* `setup-token` prompts for a setup-token value (generate it with `claude setup-token` on any machine).\n* `paste-token` accepts a token string generated elsewhere or from automation.",
  "code_samples": [
    {
      "code": "`openclaw models status` shows the resolved default/fallbacks plus an auth overview.\nWhen provider usage snapshots are available, the OAuth/token status section includes\nprovider usage headers.\nAdd `--probe` to run live auth probes against each configured provider profile.\nProbes are real requests (may consume tokens and trigger rate limits).\nUse `--agent <id>` to inspect a configured agent’s model/auth state. When omitted,\nthe command uses `OPENCLAW_AGENT_DIR`/`PI_CODING_AGENT_DIR` if set, otherwise the\nconfigured default agent.\n\nNotes:\n\n* `models set <model-or-alias>` accepts `provider/model` or an alias.\n* Model refs are parsed by splitting on the **first** `/`. If the model ID includes `/` (OpenRouter-style), include the provider prefix (example: `openrouter/moonshotai/kimi-k2`).\n* If you omit the provider, OpenClaw treats the input as an alias or a model for the **default provider** (only works when there is no `/` in the model ID).\n\n### `models status`\n\nOptions:\n\n* `--json`\n* `--plain`\n* `--check` (exit 1=expired/missing, 2=expiring)\n* `--probe` (live probe of configured auth profiles)\n* `--probe-provider <name>` (probe one provider)\n* `--probe-profile <id>` (repeat or comma-separated profile ids)\n* `--probe-timeout <ms>`\n* `--probe-concurrency <n>`\n* `--probe-max-tokens <n>`\n* `--agent <id>` (configured agent id; overrides `OPENCLAW_AGENT_DIR`/`PI_CODING_AGENT_DIR`)\n\n## Aliases + fallbacks",
      "language": "unknown"
    },
    {
      "code": "## Auth profiles",
      "language": "unknown"
    }
  ],
  "headings": [
    {
      "level": "h2",
      "text": "Common commands",
      "id": "common-commands"
    },
    {
      "level": "h3",
      "text": "`models status`",
      "id": "`models-status`"
    },
    {
      "level": "h2",
      "text": "Aliases + fallbacks",
      "id": "aliases-+-fallbacks"
    },
    {
      "level": "h2",
      "text": "Auth profiles",
      "id": "auth-profiles"
    }
  ],
  "url": "llms-txt#`openclaw-models`",
  "links": []
}