ผู้ให้บริการโมเดล

Documentation Index

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

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

​

กฎแบบย่อ

​

พฤติกรรมผู้ให้บริการที่ Plugin เป็นเจ้าของ

​

การหมุนเวียน API key

​

ผู้ให้บริการในตัว (catalog pi-ai)

​

OpenAI

• ผู้ให้บริการ: openai
• Auth: OPENAI_API_KEY
• การหมุนเวียนแบบไม่บังคับ: OPENAI_API_KEYS, OPENAI_API_KEY_1, OPENAI_API_KEY_2 รวมถึง OPENCLAW_LIVE_OPENAI_KEY (override เดี่ยว)
• โมเดลตัวอย่าง: openai/gpt-5.5, openai/gpt-5.4-mini
• ตรวจสอบความพร้อมใช้งานของบัญชี/โมเดลด้วย openclaw models list --provider openai หาก install หรือ API key เฉพาะทำงานต่างออกไป
• CLI: openclaw onboard --auth-choice openai-api-key
• transport เริ่มต้นคือ auto; OpenClaw ส่งตัวเลือก transport ให้ pi-ai
• override ต่อโมเดลผ่าน agents.defaults.models["openai/<model>"].params.transport ("sse", "websocket" หรือ "auto")
• เปิดใช้ OpenAI priority processing ได้ผ่าน agents.defaults.models["openai/<model>"].params.serviceTier
• /fast และ params.fastMode แมปคำขอ Responses แบบ direct openai/* เป็น service_tier=priority บน api.openai.com
• ใช้ params.serviceTier เมื่อต้องการ tier แบบชัดเจนแทน toggle /fast ที่ใช้ร่วมกัน
• header attribution ของ OpenClaw ที่ซ่อนอยู่ (originator, version, User-Agent) ใช้เฉพาะกับทราฟฟิก OpenAI แบบ native ไปยัง api.openai.com ไม่ใช่ proxy ที่เข้ากันได้กับ OpenAI แบบทั่วไป
• เส้นทาง OpenAI แบบ native ยังคงเก็บ Responses store, hint ของ prompt cache และการปรับ payload reasoning-compat ของ OpenAI; เส้นทาง proxy ไม่ทำเช่นนั้น
• openai/gpt-5.3-codex-spark ถูก suppress ใน OpenClaw โดยตั้งใจ เพราะคำขอ OpenAI API แบบ live ปฏิเสธโมเดลนี้ และ catalog Codex ปัจจุบันไม่ expose โมเดลนี้

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

​

Anthropic

• ผู้ให้บริการ: anthropic
• Auth: ANTHROPIC_API_KEY
• การหมุนเวียนแบบไม่บังคับ: ANTHROPIC_API_KEYS, ANTHROPIC_API_KEY_1, ANTHROPIC_API_KEY_2 รวมถึง OPENCLAW_LIVE_ANTHROPIC_KEY (override เดี่ยว)
• โมเดลตัวอย่าง: anthropic/claude-opus-4-6
• CLI: openclaw onboard --auth-choice apiKey
• คำขอ Anthropic public แบบ direct รองรับ toggle /fast ที่ใช้ร่วมกันและ params.fastMode รวมถึงทราฟฟิกที่ authenticated ด้วย API key และ OAuth ที่ส่งไปยัง api.anthropic.com; OpenClaw แมปสิ่งนั้นเป็น Anthropic service_tier (auto เทียบกับ standard_only)
• config Claude CLI ที่แนะนำจะเก็บการอ้างอิงโมเดลเป็น canonical และเลือก CLI backend แยกต่างหาก: anthropic/claude-opus-4-7 พร้อม agentRuntime.id: "claude-cli" ที่ scoped ตามโมเดล การอ้างอิง legacy claude-cli/claude-opus-4-7 ยังคงทำงานเพื่อความเข้ากันได้

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

​

OpenAI Codex OAuth

• ผู้ให้บริการ: openai-codex
• Auth: OAuth (ChatGPT)
• การอ้างอิงโมเดล PI legacy: openai-codex/gpt-5.5
• การอ้างอิง harness app-server ของ Codex แบบ native: openai/gpt-5.5
• เอกสาร harness app-server ของ Codex แบบ native: Codex harness
• การอ้างอิงโมเดล legacy: codex/gpt-*
• ขอบเขต Plugin: openai-codex/* โหลด Plugin OpenAI; Plugin app-server ของ Codex แบบ native จะถูกเลือกเฉพาะโดย runtime Codex harness หรือการอ้างอิง legacy แบบ codex/*
• CLI: openclaw onboard --auth-choice openai-codex หรือ openclaw models auth login --provider openai-codex
• transport เริ่มต้นคือ auto (WebSocket ก่อน, fallback เป็น SSE)
• override ต่อโมเดล PI ผ่าน agents.defaults.models["openai-codex/<model>"].params.transport ("sse", "websocket" หรือ "auto")
• params.serviceTier จะถูก forward บนคำขอ Codex Responses แบบ native ด้วย (chatgpt.com/backend-api)
• header attribution ของ OpenClaw ที่ซ่อนอยู่ (originator, version, User-Agent) จะถูกแนบเฉพาะกับทราฟฟิก Codex แบบ native ไปยัง chatgpt.com/backend-api ไม่ใช่ proxy ที่เข้ากันได้กับ OpenAI แบบทั่วไป
• ใช้ toggle /fast และ config params.fastMode เดียวกับ direct openai/*; OpenClaw แมปสิ่งนั้นเป็น service_tier=priority
• openai-codex/gpt-5.5 ใช้ Codex catalog native contextWindow = 400000 และ runtime เริ่มต้น contextTokens = 272000; override cap ของ runtime ด้วย models.providers.openai-codex.models[].contextTokens
• หมายเหตุ policy: OpenAI Codex OAuth รองรับอย่างชัดเจนสำหรับเครื่องมือ/workflow ภายนอกอย่าง OpenClaw
• สำหรับเส้นทางทั่วไปแบบ subscription พร้อม runtime Codex แบบ native ให้ลงชื่อเข้าใช้ด้วย auth openai-codex แต่กำหนดค่า openai/gpt-5.5; รอบของ OpenAI agent จะเลือก Codex ตามค่าเริ่มต้น
• ใช้ provider/model agentRuntime.id: "pi" เฉพาะเมื่อต้องการเส้นทางความเข้ากันได้ผ่าน PI; มิฉะนั้นให้คง openai/gpt-5.5 ไว้บน Codex harness เริ่มต้น
• การอ้างอิง openai-codex/gpt-5.1*, openai-codex/gpt-5.2* และ openai-codex/gpt-5.3* ที่เก่ากว่าจะถูก suppress เพราะบัญชี ChatGPT/Codex OAuth ปฏิเสธโมเดลเหล่านั้น; ใช้ openai-codex/gpt-5.5 หรือเส้นทาง runtime Codex แบบ native แทน

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

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

​

ตัวเลือก hosted แบบ subscription อื่นๆ

​

OpenCode

• Auth: OPENCODE_API_KEY (หรือ OPENCODE_ZEN_API_KEY)
• ผู้ให้บริการ Zen runtime: opencode
• ผู้ให้บริการ Go runtime: opencode-go
• โมเดลตัวอย่าง: opencode/claude-opus-4-6, opencode-go/kimi-k2.6
• CLI: openclaw onboard --auth-choice opencode-zen หรือ openclaw onboard --auth-choice opencode-go

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

​

Google Gemini (API key)

• ผู้ให้บริการ: google
• การยืนยันตัวตน: GEMINI_API_KEY
• การหมุนเวียนคีย์แบบไม่บังคับ: GEMINI_API_KEYS, GEMINI_API_KEY_1, GEMINI_API_KEY_2, GOOGLE_API_KEY fallback และ OPENCLAW_LIVE_GEMINI_KEY (override เดี่ยว)
• โมเดลตัวอย่าง: google/gemini-3.1-pro-preview, google/gemini-3-flash-preview
• ความเข้ากันได้: การกำหนดค่า OpenClaw แบบเดิมที่ใช้ google/gemini-3.1-flash-preview จะถูกทำให้เป็นรูปแบบปกติเป็น google/gemini-3-flash-preview
• Alias: google/gemini-3.1-pro ได้รับการยอมรับและถูกทำให้เป็นรูปแบบปกติเป็นรหัส Gemini API สดของ Google คือ google/gemini-3.1-pro-preview
• CLI: openclaw onboard --auth-choice gemini-api-key
• การคิด: /think adaptive ใช้การคิดแบบไดนามิกของ Google Gemini 3/3.1 จะละเว้น thinkingLevel แบบคงที่; Gemini 2.5 ส่ง thinkingBudget: -1
• การรัน Gemini โดยตรงยังยอมรับ agents.defaults.models["google/<model>"].params.cachedContent (หรือ cached_content แบบเดิม) เพื่อส่งต่อ handle cachedContents/... แบบเนทีฟของผู้ให้บริการ; การเข้าถึงแคชของ Gemini จะแสดงเป็น OpenClaw cacheRead

​

Google Vertex และ Gemini CLI

• ผู้ให้บริการ: google-vertex, google-gemini-cli
• การยืนยันตัวตน: Vertex ใช้ gcloud ADC; Gemini CLI ใช้โฟลว์ OAuth ของตัวเอง

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)

• ผู้ให้บริการ: zai
• การยืนยันตัวตน: ZAI_API_KEY
• โมเดลตัวอย่าง: zai/glm-5.1
• CLI: openclaw onboard --auth-choice zai-api-key
  • Alias: z.ai/* และ z-ai/* จะถูกทำให้เป็นรูปแบบปกติเป็น zai/*
  • zai-api-key ตรวจจับ endpoint ของ Z.AI ที่ตรงกันโดยอัตโนมัติ; zai-coding-global, zai-coding-cn, zai-global และ zai-cn จะบังคับใช้พื้นผิวเฉพาะ

​

Vercel AI Gateway

• ผู้ให้บริการ: vercel-ai-gateway
• การยืนยันตัวตน: AI_GATEWAY_API_KEY
• โมเดลตัวอย่าง: 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

• ผู้ให้บริการ: kilocode
• การยืนยันตัวตน: KILOCODE_API_KEY
• โมเดลตัวอย่าง: kilocode/kilo/auto
• CLI: openclaw onboard --auth-choice kilocode-api-key
• URL ฐาน: https://api.kilo.ai/api/gateway/
• แค็ตตาล็อก fallback แบบคงที่จัดส่ง kilocode/kilo/auto; การค้นพบสดที่ https://api.kilo.ai/api/gateway/models สามารถขยายแค็ตตาล็อกรันไทม์เพิ่มเติมได้
• การกำหนดเส้นทาง upstream ที่แน่นอนเบื้องหลัง kilocode/kilo/auto เป็นของ Kilo Gateway ไม่ได้ hard-code ไว้ใน OpenClaw

​

Plugin ผู้ให้บริการอื่นๆ ที่บันเดิลมา

​

ข้อควรรู้เฉพาะทาง

​

ผู้ให้บริการผ่าน models.providers (URL แบบกำหนดเอง/base URL)

​

Moonshot AI (Kimi)

• ผู้ให้บริการ: moonshot
• การรับรองความถูกต้อง: MOONSHOT_API_KEY
• โมเดลตัวอย่าง: moonshot/kimi-k2.6
• CLI: openclaw onboard --auth-choice moonshot-api-key หรือ 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

• ผู้ให้บริการ: kimi
• การยืนยันตัวตน: KIMI_API_KEY
• โมเดลตัวอย่าง: kimi/kimi-for-coding

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

​

Volcano Engine (Doubao)

• ผู้ให้บริการ: volcengine (การเขียนโค้ด: volcengine-plan)
• การยืนยันตัวตน: VOLCANO_ENGINE_API_KEY
• โมเดลตัวอย่าง: volcengine-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice volcengine-api-key

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

​

BytePlus (International)

• ผู้ให้บริการ: byteplus (การเขียนโค้ด: byteplus-plan)
• การยืนยันตัวตน: BYTEPLUS_API_KEY
• โมเดลตัวอย่าง: byteplus-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice byteplus-api-key

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

​

Synthetic

• ผู้ให้บริการ: synthetic
• การยืนยันตัวตน: SYNTHETIC_API_KEY
• โมเดลตัวอย่าง: 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 (Global): --auth-choice minimax-global-oauth
• MiniMax OAuth (CN): --auth-choice minimax-cn-oauth
• MiniMax API key (Global): --auth-choice minimax-global-api
• MiniMax API key (CN): --auth-choice minimax-cn-api
• การยืนยันตัวตน: MINIMAX_API_KEY สำหรับ minimax; MINIMAX_OAUTH_TOKEN หรือ MINIMAX_API_KEY สำหรับ minimax-portal

• ค่าเริ่มต้นของข้อความ/แชตยังอยู่บน minimax/MiniMax-M2.7
• การสร้างภาพคือ minimax/image-01 หรือ minimax-portal/image-01
• ความเข้าใจภาพเป็น MiniMax-VL-01 ที่ Plugin เป็นเจ้าของบนเส้นทางการยืนยันตัวตน MiniMax ทั้งสองเส้นทาง
• การค้นหาเว็บยังอยู่บนรหัสผู้ให้บริการ minimax

​

LM Studio

• ผู้ให้บริการ: lmstudio
• การยืนยันตัวตน: LM_API_TOKEN
• URL ฐานสำหรับ inference เริ่มต้น: http://localhost:1234/v1

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

​

Ollama

• ผู้ให้บริการ: ollama
• การยืนยันตัวตน: ไม่ต้องใช้ (เซิร์ฟเวอร์ภายในเครื่อง)
• โมเดลตัวอย่าง: ollama/llama3.3
• การติดตั้ง: https://ollama.com/download

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

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

​

vLLM

• ผู้ให้บริการ: vllm
• การยืนยันตัวตน: ไม่บังคับ (ขึ้นอยู่กับเซิร์ฟเวอร์ของคุณ)
• URL ฐานเริ่มต้น: http://127.0.0.1:8000/v1

export VLLM_API_KEY="vllm-local"

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

​

SGLang

• ผู้ให้บริการ: sglang
• การยืนยันตัวตน: ไม่บังคับ (ขึ้นอยู่กับเซิร์ฟเวอร์ของคุณ)
• URL ฐานเริ่มต้น: http://127.0.0.1:30000/v1

export SGLANG_API_KEY="sglang-local"

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

​

พร็อกซีภายในเครื่อง (LM Studio, vLLM, LiteLLM ฯลฯ)

{
  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,
          },
        ],
      },
    },
  },
}

​

ตัวอย่าง CLI

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

​

ที่เกี่ยวข้อง

• ข้อมูลอ้างอิงการกำหนดค่า - คีย์การกำหนดค่าโมเดล
• Model failover - เชน fallback และพฤติกรรมการลองใหม่
• โมเดล - การกำหนดค่าโมเดลและ alias
• ผู้ให้บริการ - คู่มือการตั้งค่าแยกตามผู้ให้บริการ