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

ข้อมูลอ้างอิงสำหรับผู้ให้บริการ LLM/โมเดล (ไม่ใช่ช่องแชทอย่าง WhatsApp/Telegram) สำหรับกฎการเลือกโมเดล โปรดดู โมเดล

# กฎฉบับย่อ

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

ตรรกะเฉพาะผู้ให้บริการส่วนใหญ่อยู่ใน Plugin ของผู้ให้บริการ (registerProvider(...)) ขณะที่ OpenClaw รักษา inference loop ทั่วไปไว้ Plugin เป็นเจ้าของ onboarding, catalog โมเดล, การแมป auth env-var, การทำ transport/config normalization, การ cleanup tool-schema, การจัดประเภท failover, การ refresh OAuth, การรายงาน usage, profile การคิด/reasoning และอื่นๆ

รายการ hook ของ provider-SDK และตัวอย่าง bundled-plugin ทั้งหมดอยู่ใน Provider plugins ผู้ให้บริการที่ต้องการ request executor แบบ custom ทั้งหมดเป็น extension surface ที่แยกออกไปและลึกกว่า

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

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

OpenClaw มาพร้อมกับ catalog pi-ai ผู้ให้บริการเหล่านี้ไม่ต้องใช้ config models.providers ใดๆ; เพียงตั้งค่า auth และเลือกโมเดล

# OpenAI

• ผู้ให้บริการ: openai
• Auth: OPENAI_API_KEY
• การหมุนเวียนแบบเลือกได้: OPENAI_API_KEYS, OPENAI_API_KEY_1, OPENAI_API_KEY_2 รวมถึง OPENCLAW_LIVE_OPENAI_KEY (single 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 (WebSocket ก่อน, fallback เป็น SSE)
• override ต่อโมเดลผ่าน agents.defaults.models["openai/<model>"].params.transport ("sse", "websocket" หรือ "auto")
• ค่าเริ่มต้นของ OpenAI Responses WebSocket warm-up เปิดใช้งานผ่าน params.openaiWsWarmup (true/false)
• สามารถเปิดใช้ OpenAI priority processing ผ่าน agents.defaults.models["openai/<model>"].params.serviceTier
• /fast และ params.fastMode จะแมปคำขอ direct openai/* Responses เป็น service_tier=priority บน api.openai.com
• ใช้ params.serviceTier เมื่อต้องการ tier แบบชัดเจนแทน toggle /fast ที่ใช้ร่วมกัน
• header attribution ของ OpenClaw ที่ซ่อนอยู่ (originator, version, User-Agent) ใช้เฉพาะกับ traffic OpenAI native ไปยัง api.openai.com ไม่ใช่ proxy ที่เข้ากันได้กับ OpenAI แบบทั่วไป
• route OpenAI native ยังคงรักษา Responses store, hint ของ prompt-cache และการจัดรูป payload reasoning-compat ของ OpenAI; route proxy ไม่ทำเช่นนั้น
• openai/gpt-5.3-codex-spark ถูกซ่อนไว้โดยเจตนาใน OpenClaw เพราะคำขอ OpenAI API แบบ live ปฏิเสธโมเดลนี้ และ catalog Codex ปัจจุบันไม่เปิดเผยโมเดลนี้

{
  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 (single override)
• โมเดลตัวอย่าง: anthropic/claude-opus-4-6
• CLI: openclaw onboard --auth-choice apiKey
• คำขอ Anthropic สาธารณะโดยตรงรองรับ toggle /fast ที่ใช้ร่วมกันและ params.fastMode รวมถึง traffic แบบ API key และ OAuth-authenticated ที่ส่งไปยัง api.anthropic.com; OpenClaw จะแมปสิ่งนั้นเป็น Anthropic service_tier (auto เทียบกับ standard_only)
• config Claude CLI ที่แนะนำจะเก็บการอ้างอิงโมเดลให้เป็น canonical และเลือก CLI backend แยกต่างหาก: anthropic/claude-opus-4-7 พร้อม agents.defaults.agentRuntime.id: "claude-cli" การอ้างอิง 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: openai-codex/gpt-5.5
• การอ้างอิง native Codex app-server harness: openai/gpt-5.5 พร้อม agents.defaults.agentRuntime.id: "codex"
• เอกสาร native Codex app-server harness: Codex harness
• การอ้างอิงโมเดล legacy: codex/gpt-*
• ขอบเขต Plugin: openai-codex/* โหลด Plugin OpenAI; Plugin native Codex app-server จะถูกเลือกโดย 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 ถูกส่งต่อบนคำขอ native Codex Responses ด้วย (chatgpt.com/backend-api)
• header attribution ของ OpenClaw ที่ซ่อนอยู่ (originator, version, User-Agent) จะถูกแนบเฉพาะกับ traffic Codex native ไปยัง chatgpt.com/backend-api ไม่ใช่ proxy ที่เข้ากันได้กับ OpenAI แบบทั่วไป
• ใช้ toggle /fast และ config params.fastMode เดียวกันกับ direct openai/*; OpenClaw จะแมปสิ่งนั้นเป็น service_tier=priority
• openai-codex/gpt-5.5 ใช้ contextWindow = 400000 แบบ native ของ catalog Codex และ runtime เริ่มต้น contextTokens = 272000; override cap ของ runtime ด้วย models.providers.openai-codex.models[].contextTokens
• หมายเหตุนโยบาย: OpenAI Codex OAuth รองรับอย่างชัดเจนสำหรับเครื่องมือ/workflow ภายนอกอย่าง OpenClaw
• สำหรับ route subscription บวก native Codex runtime ที่พบบ่อย ให้ลงชื่อเข้าใช้ด้วย auth openai-codex แต่กำหนดค่า openai/gpt-5.5 พร้อม agents.defaults.agentRuntime.id: "codex"
• ใช้ openai-codex/gpt-5.5 เฉพาะเมื่อคุณต้องการ route Codex OAuth/subscription ผ่าน PI; ใช้ openai/gpt-5.5 โดยไม่มีการ override runtime ของ Codex เมื่อการตั้งค่า API key และ catalog ภายในเครื่องของคุณเปิดให้ใช้ route API สาธารณะ
• การอ้างอิง openai-codex/gpt-5.1*, openai-codex/gpt-5.2* และ openai-codex/gpt-5.3* ที่เก่ากว่าจะถูกซ่อนไว้ เพราะบัญชี ChatGPT/Codex OAuth ปฏิเสธโมเดลเหล่านั้น; ใช้ openai-codex/gpt-5.5 หรือ route native Codex runtime แทน

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

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

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

# 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, และ OPENCLAW_LIVE_GEMINI_KEY (การเขียนทับเดี่ยว)
• โมเดลตัวอย่าง: google/gemini-3.1-pro-preview, google/gemini-3-flash-preview
• ความเข้ากันได้: การกำหนดค่า OpenClaw แบบเดิมที่ใช้ google/gemini-3.1-flash-preview จะถูกทำให้เป็นมาตรฐานเป็น google/gemini-3-flash-preview
• นามแฝง: 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 แบบเดิม) เพื่อส่งต่อแฮนเดิล cachedContents/... แบบเนทีฟของผู้ให้บริการ; การพบแคชของ Gemini จะแสดงเป็น cacheRead ของ OpenClaw

# Google Vertex และ Gemini CLI

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

Gemini CLI OAuth ถูกจัดส่งเป็นส่วนหนึ่งของ Plugin google ที่รวมมาให้

brew install gemini-cli

npm install -g @google/gemini-cli

openclaw plugins enable google

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

การตอบกลับ JSON ของ Gemini CLI ถูกแยกวิเคราะห์จาก response; การใช้งานจะย้อนกลับไปใช้ stats โดย stats.cached จะถูกทำให้เป็นมาตรฐานเป็น cacheRead ของ OpenClaw

# Z.AI (GLM)

• ผู้ให้บริการ: zai
• การยืนยันตัวตน: ZAI_API_KEY
• โมเดลตัวอย่าง: zai/glm-5.1
• CLI: openclaw onboard --auth-choice zai-api-key
  • นามแฝง: z.ai/* และ z-ai/* จะถูกทำให้เป็นมาตรฐานเป็น zai/*
  • zai-api-key ตรวจจับปลายทาง 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/
• แค็ตตาล็อกสำรองแบบคงที่จัดส่ง kilocode/kilo/auto; การค้นพบสด https://api.kilo.ai/api/gateway/models สามารถขยายแค็ตตาล็อกรันไทม์เพิ่มเติมได้
• การกำหนดเส้นทางอัปสตรีมที่แน่นอนเบื้องหลัง kilocode/kilo/auto เป็นความรับผิดชอบของ Kilo Gateway ไม่ได้ถูกเขียนตายตัวใน OpenClaw

ดูรายละเอียดการตั้งค่าที่ /providers/kilocode

# Plugin ผู้ให้บริการอื่นที่รวมมาให้

# ข้อควรทราบ

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

ใช้ models.providers (หรือ models.json) เพื่อเพิ่มผู้ให้บริการ แบบกำหนดเอง หรือพร็อกซีที่เข้ากันได้กับ OpenAI/Anthropic

Plugin ผู้ให้บริการที่มาพร้อมแพ็กเกจจำนวนมากด้านล่างเผยแพร่แค็ตตาล็อกเริ่มต้นอยู่แล้ว ใช้รายการ models.providers.<id> แบบชัดเจนเฉพาะเมื่อคุณต้องการแทนที่ URL พื้นฐาน เฮดเดอร์ หรือรายการโมเดลเริ่มต้นเท่านั้น

การตรวจสอบความสามารถของโมเดล Gateway จะอ่านเมทาดาทา models.providers.<id>.models[] แบบชัดเจนด้วย หากโมเดลแบบกำหนดเองหรือพร็อกซียอมรับรูปภาพ ให้ตั้งค่า input: ["text", "image"] บนโมเดลนั้น เพื่อให้เส้นทางไฟล์แนบจาก WebChat และ node-origin ส่งรูปภาพเป็นอินพุตโมเดลแบบเนทีฟแทน refs สื่อแบบข้อความเท่านั้น

# Moonshot AI (Kimi)

Moonshot จัดส่งเป็น Plugin ผู้ให้บริการที่มาพร้อมแพ็กเกจ ใช้ผู้ให้บริการในตัวเป็นค่าเริ่มต้น และเพิ่มรายการ models.providers.moonshot แบบชัดเจนเฉพาะเมื่อคุณต้องการแทนที่ URL พื้นฐานหรือเมทาดาทาโมเดล:

• ผู้ให้บริการ: moonshot
• การยืนยันตัวตน: MOONSHOT_API_KEY
• โมเดลตัวอย่าง: moonshot/kimi-k2.6
• CLI: openclaw onboard --auth-choice moonshot-api-key หรือ openclaw onboard --auth-choice moonshot-api-key-cn

รหัสโมเดล Kimi K2:

• 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

Kimi Coding ใช้เอนด์พอยต์ที่เข้ากันได้กับ Anthropic ของ Moonshot AI:

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

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

Legacy kimi/k2p5 ยังคงได้รับการยอมรับในฐานะ id โมเดลเพื่อความเข้ากันได้

# Volcano Engine (Doubao)

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" } },
  },
}

Onboarding ใช้พื้นผิวการเขียนโค้ดเป็นค่าเริ่มต้น แต่แค็ตตาล็อกทั่วไป volcengine/* จะถูกลงทะเบียนพร้อมกัน

ในตัวเลือกโมเดลของ onboarding/configure ตัวเลือกการยืนยันตัวตน Volcengine จะให้ความสำคัญกับทั้งแถว volcengine/* และ volcengine-plan/* หากโมเดลเหล่านั้นยังไม่ถูกโหลด OpenClaw จะถอยกลับไปใช้แค็ตตาล็อกที่ไม่ถูกกรองแทนการแสดงตัวเลือกที่จำกัดตามผู้ให้บริการแต่ไม่มีรายการ

# BytePlus (ระหว่างประเทศ)

BytePlus ARK ให้การเข้าถึงโมเดลเดียวกับ Volcano Engine สำหรับผู้ใช้ระหว่างประเทศ

• ผู้ให้บริการ: 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" } },
  },
}

Onboarding ใช้พื้นผิวการเขียนโค้ดเป็นค่าเริ่มต้น แต่แค็ตตาล็อกทั่วไป byteplus/* จะถูกลงทะเบียนพร้อมกัน

ในตัวเลือกโมเดลของ onboarding/configure ตัวเลือกการยืนยันตัวตน BytePlus จะให้ความสำคัญกับทั้งแถว byteplus/* และ byteplus-plan/* หากโมเดลเหล่านั้นยังไม่ถูกโหลด OpenClaw จะถอยกลับไปใช้แค็ตตาล็อกที่ไม่ถูกกรองแทนการแสดงตัวเลือกที่จำกัดตามผู้ให้บริการแต่ไม่มีรายการ

# Synthetic

Synthetic ให้โมเดลที่เข้ากันได้กับ Anthropic ภายใต้ผู้ให้บริการ 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 ถูกกำหนดค่าผ่าน models.providers เพราะใช้ endpoint แบบกำหนดเอง:

• 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

ดู /providers/minimax สำหรับรายละเอียดการตั้งค่า ตัวเลือกโมเดล และตัวอย่างการกำหนดค่า

การแบ่งความสามารถที่เป็นของ Plugin:

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

# LM Studio

LM Studio มาพร้อมเป็น Plugin ผู้ให้บริการที่รวมมาให้ ซึ่งใช้ API แบบเนทีฟ:

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

จากนั้นตั้งค่าโมเดล (แทนที่ด้วยหนึ่งใน ID ที่ส่งคืนโดย http://localhost:1234/api/v1/models):

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

OpenClaw ใช้ /api/v1/models และ /api/v1/models/load แบบเนทีฟของ LM Studio สำหรับการค้นพบ + โหลดอัตโนมัติ โดยใช้ /v1/chat/completions สำหรับการอนุมานเป็นค่าเริ่มต้น หากคุณต้องการให้การโหลด JIT, TTL และการขับออกอัตโนมัติของ LM Studio เป็นผู้ดูแล lifecycle ของโมเดล ให้ตั้งค่า models.providers.lmstudio.params.preload: false ดู /providers/lmstudio สำหรับการตั้งค่าและการแก้ปัญหา

# Ollama

Ollama มาพร้อมเป็น Plugin ผู้ให้บริการที่รวมมาให้ และใช้ API แบบเนทีฟของ 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" } },
  },
}

Ollama ถูกตรวจพบภายในเครื่องที่ http://127.0.0.1:11434 เมื่อคุณเลือกใช้ด้วย OLLAMA_API_KEY และ Plugin ผู้ให้บริการที่รวมมาให้จะเพิ่ม Ollama เข้าสู่ openclaw onboard และตัวเลือกโมเดลโดยตรง ดู /providers/ollama สำหรับ onboarding, โหมด cloud/local และการกำหนดค่าแบบกำหนดเอง

# vLLM

vLLM มาพร้อมเป็น Plugin ผู้ให้บริการที่รวมมาให้สำหรับเซิร์ฟเวอร์ภายในเครื่อง/โฮสต์เองที่เข้ากันได้กับ OpenAI:

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

หากต้องการเลือกใช้การค้นพบอัตโนมัติภายในเครื่อง (ใช้ค่าใดก็ได้หากเซิร์ฟเวอร์ของคุณไม่ได้บังคับใช้การยืนยันตัวตน):

export VLLM_API_KEY="vllm-local"

จากนั้นตั้งค่าโมเดล (แทนที่ด้วยหนึ่งใน ID ที่ส่งคืนโดย /v1/models):

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

ดู /providers/vllm สำหรับรายละเอียด

# SGLang

SGLang มาพร้อมเป็น Plugin ผู้ให้บริการที่รวมมาให้สำหรับเซิร์ฟเวอร์โฮสต์เองที่รวดเร็วและเข้ากันได้กับ OpenAI:

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

หากต้องการเลือกใช้การค้นพบอัตโนมัติภายในเครื่อง (ใช้ค่าใดก็ได้หากเซิร์ฟเวอร์ของคุณไม่ได้บังคับใช้การยืนยันตัวตน):

export SGLANG_API_KEY="sglang-local"

จากนั้นตั้งค่าโมเดล (แทนที่ด้วยหนึ่งใน ID ที่ส่งคืนโดย /v1/models):

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

ดู /providers/sglang สำหรับรายละเอียด

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

ตัวอย่าง (เข้ากันได้กับ OpenAI):

{
  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 และพฤติกรรม retry
• โมเดล - การกำหนดค่าโมเดลและ alias
• ผู้ให้บริการ - คู่มือการตั้งค่าแยกตามผู้ให้บริการ