​

CLI Models

​

Cách chọn mô hình

1. Mô hình Chính (agents.defaults.model.primary hoặc agents.defaults.model).
2. Các mô hình Dự phòng trong agents.defaults.model.fallbacks (theo thứ tự).
3. Chuyển đổi xác thực nhà cung cấp xảy ra trong một nhà cung cấp trước khi chuyển sang mô hình tiếp theo.

• agents.defaults.models là danh sách cho phép/danh mục các mô hình mà OpenClaw có thể sử dụng (cộng với các bí danh).
• agents.defaults.imageModel chỉ được sử dụng khi mô hình chính không thể chấp nhận hình ảnh.
• agents.defaults.imageGenerationModel được sử dụng bởi khả năng tạo hình ảnh chia sẻ. Nếu không có, image_generate vẫn có thể suy ra mặc định nhà cung cấp từ các plugin tạo hình ảnh có xác thực tương thích.
• Mặc định theo từng agent có thể ghi đè agents.defaults.model thông qua agents.list[].model cộng với ràng buộc (xem /concepts/multi-agent).

​

Chính sách mô hình nhanh

• Đặt mô hình chính của bạn là mô hình thế hệ mới mạnh nhất có sẵn.
• Sử dụng dự phòng cho các tác vụ nhạy cảm về chi phí/độ trễ và trò chuyện ít quan trọng hơn.
• Đối với các agent có công cụ hoặc đầu vào không đáng tin cậy, tránh các mô hình cũ/yếu hơn.

​

Hướng dẫn khởi động (khuyến nghị)

openclaw onboard

​

Các khóa cấu hình (tổng quan)

• agents.defaults.model.primary và agents.defaults.model.fallbacks
• agents.defaults.imageModel.primary và agents.defaults.imageModel.fallbacks
• agents.defaults.imageGenerationModel.primary và agents.defaults.imageGenerationModel.fallbacks
• agents.defaults.models (danh sách cho phép + bí danh + tham số nhà cung cấp)
• models.providers (nhà cung cấp tùy chỉnh được ghi vào models.json)

​

”Mô hình không được phép” (và lý do phản hồi dừng)

Model "provider/model" is not allowed. Use /model to list available models.

• Thêm mô hình vào agents.defaults.models, hoặc
• Xóa danh sách cho phép (loại bỏ agents.defaults.models), hoặc
• Chọn một mô hình từ /model list.

{
  agent: {
    model: { primary: "anthropic/claude-sonnet-4-6" },
    models: {
      "anthropic/claude-sonnet-4-6": { alias: "Sonnet" },
      "anthropic/claude-opus-4-6": { alias: "Opus" },
    },
  },
}

​

Chuyển đổi mô hình trong chat (/model)

/model
/model list
/model 3
/model openai/gpt-5.2
/model status

• /model (và /model list) là một bộ chọn nhỏ gọn, có đánh số (gia đình mô hình + nhà cung cấp có sẵn).
• Trên Discord, /model và /models mở một bộ chọn tương tác với các danh sách thả xuống nhà cung cấp và mô hình cùng với bước Gửi.
• /model <#> chọn từ bộ chọn đó.
• /model status là chế độ xem chi tiết (ứng viên xác thực và, khi được cấu hình, điểm cuối nhà cung cấp baseUrl + chế độ api).
• Tham chiếu mô hình được phân tích bằng cách tách trên / đầu tiên. Sử dụng provider/model khi nhập /model <ref>.
• Nếu ID mô hình tự nó chứa / (kiểu OpenRouter), bạn phải bao gồm tiền tố nhà cung cấp (ví dụ: /model 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).

​

Lệnh CLI

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

​

models list

• --all: danh mục đầy đủ
• --local: chỉ các nhà cung cấp địa phương
• --provider <name>: lọc theo nhà cung cấp
• --plain: một mô hình mỗi dòng
• --json: đầu ra có thể đọc được bằng máy

​

models status

claude setup-token
openclaw models status

​

Quét (mô hình miễn phí OpenRouter)

• --no-probe: bỏ qua thăm dò trực tiếp (chỉ metadata)
• --min-params <b>: kích thước tham số tối thiểu (tỷ)
• --max-age-days <days>: bỏ qua các mô hình cũ hơn
• --provider <name>: lọc tiền tố nhà cung cấp
• --max-candidates <n>: kích thước danh sách dự phòng
• --set-default: đặt agents.defaults.model.primary thành lựa chọn đầu tiên
• --set-image: đặt agents.defaults.imageModel.primary thành lựa chọn hình ảnh đầu tiên

1. Hỗ trợ hình ảnh
2. Độ trễ công cụ
3. Kích thước ngữ cảnh
4. Số lượng tham số

• Danh sách OpenRouter /models (lọc :free)
• Yêu cầu khóa API OpenRouter từ hồ sơ xác thực hoặc OPENROUTER_API_KEY (xem /environment)
• Bộ lọc tùy chọn: --max-age-days, --min-params, --provider, --max-candidates
• Kiểm soát thăm dò: --timeout, --concurrency

​

Đăng ký mô hình (models.json)

• baseUrl không rỗng đã có trong models.json của agent sẽ thắng.
• apiKey không rỗng trong models.json của agent chỉ thắng khi nhà cung cấp đó không được quản lý bởi SecretRef trong ngữ cảnh cấu hình/hồ sơ xác thực hiện tại.
• Giá trị apiKey của nhà cung cấp được quản lý bởi SecretRef được làm mới từ các dấu nguồn (ENV_VAR_NAME cho tham chiếu môi trường, secretref-managed cho tham chiếu tệp/thực thi) thay vì duy trì các bí mật đã giải quyết.
• Giá trị tiêu đề của nhà cung cấp được quản lý bởi SecretRef được làm mới từ các dấu nguồn (secretref-env:ENV_VAR_NAME cho tham chiếu môi trường, secretref-managed cho tham chiếu tệp/thực thi).
• apiKey/baseUrl trống hoặc thiếu của agent sẽ quay lại cấu hình models.providers.
• Các trường nhà cung cấp khác được làm mới từ cấu hình và dữ liệu danh mục đã chuẩn hóa.