CLI mô hình

​

Cách chọn mô hình hoạt động

​

Nguồn lựa chọn và hành vi dự phòng

• Mặc định đã cấu hình (agents.defaults.model.primary và mô hình chính riêng cho tác tử) là điểm bắt đầu thông thường và dùng agents.defaults.model.fallbacks.
• Lựa chọn dự phòng tự động là trạng thái khôi phục tạm thời. Chúng được lưu với modelOverrideSource: "auto" để các lượt sau có thể tiếp tục dùng chuỗi dự phòng mà không thăm dò mô hình chính đã biết lỗi mỗi lần; OpenClaw định kỳ thăm dò lại mô hình chính ban đầu, xóa lựa chọn tự động khi nó khôi phục, và thông báo các chuyển tiếp dự phòng/khôi phục một lần cho mỗi lần thay đổi trạng thái.
• Lựa chọn phiên người dùng là chính xác. /model, bộ chọn mô hình, session_status(model=...), và sessions.patch lưu modelOverrideSource: "user"; nếu nhà cung cấp/mô hình đã chọn đó không truy cập được, OpenClaw sẽ lỗi hiển thị rõ thay vì rơi tiếp sang mô hình đã cấu hình khác.
• Việc thay đổi agents.defaults.model.primary không ghi lại các lựa chọn phiên hiện có. Nếu trạng thái nói This session is pinned to X; config primary Y will apply to new/unpinned sessions., hãy xóa lựa chọn phiên hiện tại bằng /model default để nó kế thừa lại mô hình chính đã cấu hình.
• Cron --model / payload model là mô hình chính theo từng công việc. Nó vẫn dùng các dự phòng đã cấu hình trừ khi công việc cung cấp payload fallbacks tường minh (dùng fallbacks: [] cho một lần chạy cron nghiêm ngặt).
• Bộ chọn mô hình mặc định CLI và danh sách cho phép tôn trọng models.mode: "replace" bằng cách liệt kê models.providers.*.models tường minh thay vì tải toàn bộ danh mục tích hợp sẵn.
• Bộ chọn mô hình của Control UI hỏi Gateway về chế độ xem mô hình đã cấu hình: agents.defaults.models khi có, bao gồm các mục provider/* toàn nhà cung cấp, nếu không thì models.providers.*.models tường minh cộng với các nhà cung cấp có xác thực dùng được. Toàn bộ danh mục tích hợp sẵn được dành cho các chế độ xem duyệt tường minh như models.list với view: "all" hoặc openclaw models list --all.

​

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 nhất mạnh nhất mà bạn có quyền dùng.
• Dùng dự phòng cho các tác vụ nhạy cảm về chi phí/độ trễ và trò chuyện ít rủi ro hơn.
• Với tác tử có công cụ hoặc đầu vào không đáng tin cậy, tránh các tầng mô hình cũ/yếu hơn.

​

Onboarding (khuyến nghị)

openclaw onboard

​

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.pdfModel.primary và agents.defaults.pdfModel.fallbacks
• agents.defaults.imageGenerationModel.primary và agents.defaults.imageGenerationModel.fallbacks
• agents.defaults.videoGenerationModel.primary và agents.defaults.videoGenerationModel.fallbacks
• agents.defaults.models (danh sách cho phép + bí danh + tham số nhà cung cấp + mục nhà cung cấp động provider/*)
• models.providers (nhà cung cấp tùy chỉnh được ghi vào models.json)

​

Sửa danh sách cho phép an toàn

openclaw config set agents.defaults.models '{"openai/gpt-5.4":{}}' --strict-json --merge

​

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

Model "provider/model" is not allowed. Use /models to list providers, or /models <provider> to list models.
Add it with: openclaw config set agents.defaults.models '{"provider/model":{}}' --strict-json --merge

{
  agents: {
    defaults: {
      models: {
        "openai/*": {},
        "vllm/*": {},
      },
    },
  },
}

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

​

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

/model
/model list
/model 3
/model openai/gpt-5.4
/model default
/model status

​

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

​

models status

claude auth login
openclaw models status

​

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

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 /models OpenRouter (bộ lọc :free)
• Thăm dò trực tiếp yêu cầu khóa API OpenRouter từ hồ sơ xác thực hoặc OPENROUTER_API_KEY (xem Biến môi trường)
• Bộ lọc tùy chọn: --max-age-days, --min-params, --provider, --max-candidates
• Điều khiển yêu cầu/thăm dò: --timeout, --concurrency

​

Sổ đăng ký mô hình (models.json)

​

Liên quan

• Runtime agent — OpenClaw, Codex và các runtime vòng lặp agent khác
• Tham chiếu cấu hình — các khóa cấu hình mô hình
• Tạo hình ảnh — cấu hình mô hình hình ảnh
• Chuyển đổi dự phòng mô hình — chuỗi dự phòng
• Nhà cung cấp mô hình — định tuyến nhà cung cấp và xác thực
• Tạo nhạc — cấu hình mô hình nhạc
• Tạo video — cấu hình mô hình video