> ## 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

# `openclaw models`

Khám phá, quét và cấu hình mô hình (mô hình mặc định, fallback, hồ sơ xác thực).

Liên quan:

* Nhà cung cấp + mô hình: [Models](/providers/models)
* Thiết lập xác thực nhà cung cấp: [Getting started](/start/getting-started)

## Các lệnh thường dùng

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models status
openclaw models list
openclaw models set <model-or-alias>
openclaw models scan
```

`openclaw models status` hiển thị các giá trị mặc định/dự phòng đã được phân giải cùng với tổng quan xác thực.
Khi có ảnh chụp mức sử dụng của nhà cung cấp, phần trạng thái OAuth/token sẽ bao gồm các header sử dụng của nhà cung cấp.
Thêm `--probe` để chạy các probe xác thực trực tiếp đối với từng profile nhà cung cấp đã cấu hình.
Các probe là các yêu cầu thật (có thể tiêu tốn token và kích hoạt giới hạn tốc độ).
Dùng `--agent <id>` để kiểm tra trạng thái model/xác thực của một agent đã cấu hình. Khi bỏ qua,
lệnh sẽ dùng `OPENCLAW_AGENT_DIR`/`PI_CODING_AGENT_DIR` nếu được đặt, nếu không thì dùng agent mặc định đã cấu hình.

Ghi chú:

* `models set <model-or-alias>` chấp nhận `provider/model` hoặc một bí danh.
* Tham chiếu model được phân tích bằng cách tách theo dấu `/` **đầu tiên**. Nếu ID model chứa `/` (kiểu OpenRouter), hãy bao gồm tiền tố nhà cung cấp (ví dụ: `openrouter/moonshotai/kimi-k2`).
* Nếu bạn bỏ qua nhà cung cấp, OpenClaw coi đầu vào là một bí danh hoặc một mô hình cho **nhà cung cấp mặc định** (chỉ hoạt động khi không có `/` trong ID mô hình).

### `models status`

Tùy chọn:

* `--json`
* `--plain`
* `--check` (thoát 1=hết hạn/thiếu, 2=sắp hết hạn)
* `--probe` (probe trực tiếp các hồ sơ xác thực đã cấu hình)
* `--probe-provider <name>` (probe một nhà cung cấp)
* `--probe-profile <id>` (lặp lại hoặc các id hồ sơ phân tách bằng dấu phẩy)
* `--probe-timeout <ms>`
* `--probe-concurrency <n>`
* `--probe-max-tokens <n>`
* `--agent <id>` (id tác tử đã cấu hình; ghi đè `OPENCLAW_AGENT_DIR`/`PI_CODING_AGENT_DIR`)

## Bí danh + fallback

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models aliases list
openclaw models fallbacks list
```

## Hồ sơ xác thực

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models auth add
openclaw models auth login --provider <id>
openclaw models auth setup-token
openclaw models auth paste-token
```

`models auth login` chạy luồng xác thực của plugin nhà cung cấp (OAuth/API key). Dùng
`openclaw plugins list` để xem những nhà cung cấp nào đã được cài đặt.

Ghi chú:

* `setup-token` sẽ yêu cầu giá trị setup-token (tạo bằng `claude setup-token` trên bất kỳ máy nào).
* `paste-token` chấp nhận một chuỗi token được tạo ở nơi khác hoặc từ tự động hóa.