Chuyển đến nội dung chính

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:

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

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

openclaw models aliases list
openclaw models fallbacks list

Hồ sơ xác thực

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.