69 lines
2.3 KiB
Markdown
69 lines
2.3 KiB
Markdown
---
|
||
summary: "CLI reference for `moltbot models` (status/list/set/scan, aliases, fallbacks, auth)"
|
||
read_when:
|
||
- You want to change default models or view provider auth status
|
||
- You want to scan available models/providers and debug auth profiles
|
||
---
|
||
|
||
# `moltbot models`
|
||
|
||
Model discovery, scanning, and configuration (default model, fallbacks, auth profiles).
|
||
|
||
Related:
|
||
- Providers + models: [Models](/providers/models)
|
||
- Provider auth setup: [Getting started](/start/getting-started)
|
||
|
||
## Common commands
|
||
|
||
```bash
|
||
moltbot models status
|
||
moltbot models list
|
||
moltbot models set <model-or-alias>
|
||
moltbot models scan
|
||
```
|
||
|
||
`moltbot models status` shows the resolved default/fallbacks plus an auth overview.
|
||
When provider usage snapshots are available, the OAuth/token status section includes
|
||
provider usage headers.
|
||
Add `--probe` to run live auth probes against each configured provider profile.
|
||
Probes are real requests (may consume tokens and trigger rate limits).
|
||
|
||
Notes:
|
||
- `models set <model-or-alias>` accepts `provider/model` or an alias.
|
||
- 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`).
|
||
- If you omit the provider, Moltbot treats the input as an alias or a model for the **default provider** (only works when there is no `/` in the model ID).
|
||
|
||
### `models status`
|
||
Options:
|
||
- `--json`
|
||
- `--plain`
|
||
- `--check` (exit 1=expired/missing, 2=expiring)
|
||
- `--probe` (live probe of configured auth profiles)
|
||
- `--probe-provider <name>` (probe one provider)
|
||
- `--probe-profile <id>` (repeat or comma-separated profile ids)
|
||
- `--probe-timeout <ms>`
|
||
- `--probe-concurrency <n>`
|
||
- `--probe-max-tokens <n>`
|
||
|
||
## Aliases + fallbacks
|
||
|
||
```bash
|
||
moltbot models aliases list
|
||
moltbot models fallbacks list
|
||
```
|
||
|
||
## Auth profiles
|
||
|
||
```bash
|
||
moltbot models auth add
|
||
moltbot models auth login --provider <id>
|
||
moltbot models auth setup-token
|
||
moltbot models auth paste-token
|
||
```
|
||
`models auth login` runs a provider plugin’s auth flow (OAuth/API key). Use
|
||
`moltbot plugins list` to see which providers are installed.
|
||
|
||
Notes:
|
||
- `setup-token` prompts for a setup-token value (generate it with `claude setup-token` on any machine).
|
||
- `paste-token` accepts a token string generated elsewhere or from automation.
|