Nhà cung cấp mô hình

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Quy tắc nhanh

​

Hành vi nhà cung cấp do Plugin sở hữu

​

Xoay vòng khóa API

​

Nhà cung cấp tích hợp sẵn (danh mục pi-ai)

​

OpenAI

• Nhà cung cấp: openai
• Xác thực: OPENAI_API_KEY
• Xoay vòng tùy chọn: OPENAI_API_KEYS, OPENAI_API_KEY_1, OPENAI_API_KEY_2, cộng với OPENCLAW_LIVE_OPENAI_KEY (ghi đè đơn lẻ)
• Mô hình ví dụ: openai/gpt-5.5, openai/gpt-5.4-mini
• Xác minh tài khoản/tính khả dụng của mô hình bằng openclaw models list --provider openai nếu một bản cài đặt hoặc khóa API cụ thể hoạt động khác.
• CLI: openclaw onboard --auth-choice openai-api-key
• Truyền tải mặc định là auto; OpenClaw chuyển lựa chọn truyền tải cho pi-ai.
• Ghi đè theo từng mô hình qua agents.defaults.models["openai/<model>"].params.transport ("sse", "websocket", hoặc "auto")
• Có thể bật xử lý ưu tiên của OpenAI qua agents.defaults.models["openai/<model>"].params.serviceTier
• /fast và params.fastMode ánh xạ các yêu cầu Responses trực tiếp openai/* thành service_tier=priority trên api.openai.com
• Dùng params.serviceTier khi bạn muốn một tầng rõ ràng thay vì nút bật/tắt /fast dùng chung
• Các header ghi nhận nguồn gốc OpenClaw ẩn (originator, version, User-Agent) chỉ áp dụng trên lưu lượng OpenAI gốc đến api.openai.com, không áp dụng cho proxy tương thích OpenAI chung
• Các tuyến OpenAI gốc cũng giữ Responses store, gợi ý bộ nhớ đệm lời nhắc, và định dạng dữ liệu gửi đi tương thích lập luận của OpenAI; tuyến proxy thì không
• openai/gpt-5.3-codex-spark được cố ý ẩn trong OpenClaw vì các yêu cầu API OpenAI thực tế từ chối nó và danh mục Codex hiện tại không hiển thị nó

{
  agents: { defaults: { model: { primary: "openai/gpt-5.5" } } },
}

​

Anthropic

• Nhà cung cấp: anthropic
• Xác thực: ANTHROPIC_API_KEY
• Xoay vòng tùy chọn: ANTHROPIC_API_KEYS, ANTHROPIC_API_KEY_1, ANTHROPIC_API_KEY_2, cộng với OPENCLAW_LIVE_ANTHROPIC_KEY (ghi đè đơn lẻ)
• Mô hình ví dụ: anthropic/claude-opus-4-6
• CLI: openclaw onboard --auth-choice apiKey
• Yêu cầu Anthropic công khai trực tiếp hỗ trợ nút bật/tắt /fast dùng chung và params.fastMode, bao gồm lưu lượng khóa API và lưu lượng được xác thực bằng OAuth gửi đến api.anthropic.com; OpenClaw ánh xạ điều đó sang service_tier của Anthropic (auto so với standard_only)
• Cấu hình Claude CLI được ưu tiên giữ tham chiếu mô hình ở dạng chuẩn và chọn phần phụ trợ CLI riêng: anthropic/claude-opus-4-7 với agentRuntime.id: "claude-cli" theo phạm vi mô hình. Các tham chiếu cũ claude-cli/claude-opus-4-7 vẫn hoạt động để tương thích.

{
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

​

OpenAI Codex OAuth

• Nhà cung cấp: openai-codex
• Xác thực: OAuth (ChatGPT)
• Tham chiếu mô hình PI cũ: openai-codex/gpt-5.5
• Tham chiếu khung chạy máy chủ ứng dụng Codex gốc: openai/gpt-5.5
• Tài liệu khung chạy máy chủ ứng dụng Codex gốc: khung chạy Codex
• Tham chiếu mô hình cũ: codex/gpt-*
• Ranh giới Plugin: openai-codex/* tải Plugin OpenAI; Plugin máy chủ ứng dụng Codex gốc chỉ được chọn bởi môi trường chạy khung chạy Codex hoặc tham chiếu codex/* cũ.
• CLI: openclaw onboard --auth-choice openai-codex hoặc openclaw models auth login --provider openai-codex
• Truyền tải mặc định là auto (ưu tiên WebSocket, dự phòng SSE)
• Ghi đè theo từng mô hình PI qua agents.defaults.models["openai-codex/<model>"].params.transport ("sse", "websocket", hoặc "auto")
• params.serviceTier cũng được chuyển tiếp trên các yêu cầu Responses Codex gốc (chatgpt.com/backend-api)
• Các header ghi nhận nguồn gốc OpenClaw ẩn (originator, version, User-Agent) chỉ được gắn trên lưu lượng Codex gốc đến chatgpt.com/backend-api, không phải proxy tương thích OpenAI chung
• Chia sẻ cùng nút bật/tắt /fast và cấu hình params.fastMode như openai/* trực tiếp; OpenClaw ánh xạ điều đó thành service_tier=priority
• openai-codex/gpt-5.5 dùng contextWindow = 400000 gốc của danh mục Codex và môi trường chạy mặc định contextTokens = 272000; ghi đè giới hạn môi trường chạy bằng models.providers.openai-codex.models[].contextTokens
• Ghi chú chính sách: OpenAI Codex OAuth được hỗ trợ rõ ràng cho công cụ/quy trình làm việc bên ngoài như OpenClaw.
• Đối với tuyến phổ biến dùng gói đăng ký cùng môi trường chạy Codex gốc, đăng nhập bằng xác thực openai-codex nhưng cấu hình openai/gpt-5.5; các lượt tác tử OpenAI chọn Codex theo mặc định.
• Chỉ dùng agentRuntime.id: "pi" của nhà cung cấp/mô hình khi bạn muốn tuyến tương thích qua PI; nếu không, hãy giữ openai/gpt-5.5 trên khung chạy Codex mặc định.
• Các tham chiếu openai-codex/gpt-5.1*, openai-codex/gpt-5.2*, và openai-codex/gpt-5.3* cũ hơn bị ẩn vì tài khoản ChatGPT/Codex OAuth từ chối chúng; hãy dùng openai-codex/gpt-5.5 hoặc tuyến môi trường chạy Codex gốc thay vào đó.

{
  plugins: { entries: { codex: { enabled: true } } },
  agents: {
    defaults: {
      model: { primary: "openai/gpt-5.5" },
    },
  },
}

{
  models: {
    providers: {
      "openai-codex": {
        models: [{ id: "gpt-5.5", contextTokens: 160000 }],
      },
    },
  },
}

​

Các tùy chọn được lưu trữ kiểu đăng ký khác

​

OpenCode

• Xác thực: OPENCODE_API_KEY (hoặc OPENCODE_ZEN_API_KEY)
• Nhà cung cấp môi trường chạy Zen: opencode
• Nhà cung cấp môi trường chạy Go: opencode-go
• Mô hình ví dụ: opencode/claude-opus-4-6, opencode-go/kimi-k2.6
• CLI: openclaw onboard --auth-choice opencode-zen hoặc openclaw onboard --auth-choice opencode-go

{
  agents: { defaults: { model: { primary: "opencode/claude-opus-4-6" } } },
}

​

Google Gemini (khóa API)

• Nhà cung cấp: google
• Xác thực: GEMINI_API_KEY
• Luân phiên tùy chọn: GEMINI_API_KEYS, GEMINI_API_KEY_1, GEMINI_API_KEY_2, dự phòng GOOGLE_API_KEY, và OPENCLAW_LIVE_GEMINI_KEY (ghi đè đơn lẻ)
• Mô hình ví dụ: google/gemini-3.1-pro-preview, google/gemini-3-flash-preview
• Khả năng tương thích: cấu hình OpenClaw cũ dùng google/gemini-3.1-flash-preview được chuẩn hóa thành google/gemini-3-flash-preview
• Bí danh: google/gemini-3.1-pro được chấp nhận và chuẩn hóa thành id Gemini API trực tiếp của Google, google/gemini-3.1-pro-preview
• CLI: openclaw onboard --auth-choice gemini-api-key
• Suy nghĩ: /think adaptive dùng suy nghĩ động của Google. Gemini 3/3.1 bỏ qua thinkingLevel cố định; Gemini 2.5 gửi thinkingBudget: -1.
• Các lần chạy Gemini trực tiếp cũng chấp nhận agents.defaults.models["google/<model>"].params.cachedContent (hoặc cached_content cũ) để chuyển tiếp một handle cachedContents/... nguyên bản của nhà cung cấp; các lần trúng bộ nhớ đệm Gemini hiển thị dưới dạng cacheRead của OpenClaw

​

Google Vertex và Gemini CLI

• Nhà cung cấp: google-vertex, google-gemini-cli
• Xác thực: Vertex dùng gcloud ADC; Gemini CLI dùng luồng OAuth của nó

brew install gemini-cli

npm install -g @google/gemini-cli

openclaw plugins enable google

openclaw models auth login --provider google-gemini-cli --set-default

​

Z.AI (GLM)

• Nhà cung cấp: zai
• Xác thực: ZAI_API_KEY
• Mô hình ví dụ: zai/glm-5.1
• CLI: openclaw onboard --auth-choice zai-api-key
  • Bí danh: z.ai/* và z-ai/* chuẩn hóa thành zai/*
  • zai-api-key tự động phát hiện endpoint Z.AI khớp; zai-coding-global, zai-coding-cn, zai-global, và zai-cn buộc dùng một surface cụ thể

​

Vercel AI Gateway

• Nhà cung cấp: vercel-ai-gateway
• Xác thực: AI_GATEWAY_API_KEY
• Mô hình ví dụ: vercel-ai-gateway/anthropic/claude-opus-4.6, vercel-ai-gateway/moonshotai/kimi-k2.6
• CLI: openclaw onboard --auth-choice ai-gateway-api-key

​

Kilo Gateway

• Nhà cung cấp: kilocode
• Xác thực: KILOCODE_API_KEY
• Mô hình ví dụ: kilocode/kilo/auto
• CLI: openclaw onboard --auth-choice kilocode-api-key
• Base URL: https://api.kilo.ai/api/gateway/
• Danh mục dự phòng tĩnh phát hành kèm kilocode/kilo/auto; khám phá trực tiếp https://api.kilo.ai/api/gateway/models có thể mở rộng thêm danh mục runtime.
• Định tuyến upstream chính xác phía sau kilocode/kilo/auto do Kilo Gateway sở hữu, không được hard-code trong OpenClaw.

​

Các Plugin nhà cung cấp đi kèm khác

​

Những điểm đặc thù cần biết

​

Nhà cung cấp qua models.providers (URL tùy chỉnh/cơ sở)

​

Moonshot AI (Kimi)

• Nhà cung cấp: moonshot
• Xác thực: MOONSHOT_API_KEY
• Mô hình ví dụ: moonshot/kimi-k2.6
• CLI: openclaw onboard --auth-choice moonshot-api-key hoặc openclaw onboard --auth-choice moonshot-api-key-cn

• moonshot/kimi-k2.6
• moonshot/kimi-k2.5
• moonshot/kimi-k2-thinking
• moonshot/kimi-k2-thinking-turbo
• moonshot/kimi-k2-turbo

{
  agents: {
    defaults: { model: { primary: "moonshot/kimi-k2.6" } },
  },
  models: {
    mode: "merge",
    providers: {
      moonshot: {
        baseUrl: "https://api.moonshot.ai/v1",
        apiKey: "${MOONSHOT_API_KEY}",
        api: "openai-completions",
        models: [{ id: "kimi-k2.6", name: "Kimi K2.6" }],
      },
    },
  },
}

​

Kimi coding

• Nhà cung cấp: kimi
• Xác thực: KIMI_API_KEY
• Mô hình ví dụ: kimi/kimi-for-coding

{
  env: { KIMI_API_KEY: "sk-..." },
  agents: {
    defaults: { model: { primary: "kimi/kimi-for-coding" } },
  },
}

​

Volcano Engine (Doubao)

• Nhà cung cấp: volcengine (lập trình: volcengine-plan)
• Xác thực: VOLCANO_ENGINE_API_KEY
• Mô hình ví dụ: volcengine-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice volcengine-api-key

{
  agents: {
    defaults: { model: { primary: "volcengine-plan/ark-code-latest" } },
  },
}

​

BytePlus (Quốc tế)

• Nhà cung cấp: byteplus (lập trình: byteplus-plan)
• Xác thực: BYTEPLUS_API_KEY
• Mô hình ví dụ: byteplus-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice byteplus-api-key

{
  agents: {
    defaults: { model: { primary: "byteplus-plan/ark-code-latest" } },
  },
}

​

Synthetic

• Nhà cung cấp: synthetic
• Xác thực: SYNTHETIC_API_KEY
• Mô hình ví dụ: synthetic/hf:MiniMaxAI/MiniMax-M2.5
• CLI: openclaw onboard --auth-choice synthetic-api-key

{
  agents: {
    defaults: { model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M2.5" } },
  },
  models: {
    mode: "merge",
    providers: {
      synthetic: {
        baseUrl: "https://api.synthetic.new/anthropic",
        apiKey: "${SYNTHETIC_API_KEY}",
        api: "anthropic-messages",
        models: [{ id: "hf:MiniMaxAI/MiniMax-M2.5", name: "MiniMax M2.5" }],
      },
    },
  },
}

​

MiniMax

• MiniMax OAuth (Toàn cầu): --auth-choice minimax-global-oauth
• MiniMax OAuth (CN): --auth-choice minimax-cn-oauth
• Khóa API MiniMax (Toàn cầu): --auth-choice minimax-global-api
• Khóa API MiniMax (CN): --auth-choice minimax-cn-api
• Xác thực: MINIMAX_API_KEY cho minimax; MINIMAX_OAUTH_TOKEN hoặc MINIMAX_API_KEY cho minimax-portal

• Mặc định văn bản/chat vẫn dùng minimax/MiniMax-M2.7
• Tạo hình ảnh là minimax/image-01 hoặc minimax-portal/image-01
• Hiểu hình ảnh là MiniMax-VL-01 do Plugin sở hữu trên cả hai đường dẫn xác thực MiniMax
• Tìm kiếm web vẫn dùng id nhà cung cấp minimax

​

LM Studio

• Nhà cung cấp: lmstudio
• Xác thực: LM_API_TOKEN
• URL cơ sở suy luận mặc định: http://localhost:1234/v1

{
  agents: {
    defaults: { model: { primary: "lmstudio/openai/gpt-oss-20b" } },
  },
}

​

Ollama

• Nhà cung cấp: ollama
• Xác thực: Không yêu cầu (máy chủ cục bộ)
• Mô hình ví dụ: ollama/llama3.3
• Cài đặt: https://ollama.com/download

# Install Ollama, then pull a model:
ollama pull llama3.3

{
  agents: {
    defaults: { model: { primary: "ollama/llama3.3" } },
  },
}

​

vLLM

• Nhà cung cấp: vllm
• Xác thực: Tùy chọn (phụ thuộc vào máy chủ của bạn)
• URL cơ sở mặc định: http://127.0.0.1:8000/v1

export VLLM_API_KEY="vllm-local"

{
  agents: {
    defaults: { model: { primary: "vllm/your-model-id" } },
  },
}

​

SGLang

• Nhà cung cấp: sglang
• Xác thực: Tùy chọn (phụ thuộc vào máy chủ của bạn)
• URL cơ sở mặc định: http://127.0.0.1:30000/v1

export SGLANG_API_KEY="sglang-local"

{
  agents: {
    defaults: { model: { primary: "sglang/your-model-id" } },
  },
}

​

Proxy cục bộ (LM Studio, vLLM, LiteLLM, v.v.)

{
  agents: {
    defaults: {
      model: { primary: "lmstudio/my-local-model" },
      models: { "lmstudio/my-local-model": { alias: "Local" } },
    },
  },
  models: {
    providers: {
      lmstudio: {
        baseUrl: "http://localhost:1234/v1",
        apiKey: "${LM_API_TOKEN}",
        api: "openai-completions",
        timeoutSeconds: 300,
        models: [
          {
            id: "my-local-model",
            name: "Local Model",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 200000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

​

Ví dụ CLI

openclaw onboard --auth-choice opencode-zen
openclaw models set opencode/claude-opus-4-6
openclaw models list

​

Liên quan

• Tham chiếu cấu hình - khóa cấu hình mô hình
• Chuyển đổi dự phòng mô hình - chuỗi dự phòng và hành vi thử lại
• Mô hình - cấu hình mô hình và bí danh
• Nhà cung cấp - hướng dẫn thiết lập theo từng nhà cung cấp