--- read_when: - Anda memerlukan referensi penyiapan model per penyedia - Anda menginginkan contoh konfigurasi atau perintah onboarding CLI untuk penyedia model sidebarTitle: Model providers summary: Ikhtisar penyedia model dengan contoh konfigurasi + alur CLI title: Penyedia model x-i18n: generated_at: "2026-05-11T20:27:18Z" model: gpt-5.5 provider: openai source_hash: 8a3cde106981c2601c0b127116c8b5968a9f95571245fc795e9a181243fc3b7e source_path: concepts/model-providers.md workflow: 16 --- Referensi untuk **penyedia LLM/model** (bukan saluran chat seperti WhatsApp/Telegram). Untuk aturan pemilihan model, lihat [Model](/id/concepts/models). ## Aturan cepat - Referensi model menggunakan `provider/model` (contoh: `opencode/claude-opus-4-6`). - `agents.defaults.models` bertindak sebagai allowlist saat disetel. - Pembantu CLI: `openclaw onboard`, `openclaw models list`, `openclaw models set `. - `models.providers.*.contextWindow` / `contextTokens` / `maxTokens` menetapkan default tingkat penyedia; `models.providers.*.models[].contextWindow` / `contextTokens` / `maxTokens` menimpanya per model. - Aturan fallback, probe cooldown, dan persistensi penimpaan sesi: [Failover model](/id/concepts/model-failover). `openclaw configure` mempertahankan `agents.defaults.model.primary` yang sudah ada saat Anda menambahkan atau mengauth ulang penyedia. `openclaw models auth login` melakukan hal yang sama kecuali Anda meneruskan `--set-default`. Plugin penyedia masih dapat mengembalikan model default yang direkomendasikan dalam patch config auth mereka, tetapi OpenClaw memperlakukannya sebagai "jadikan model ini tersedia" ketika model utama sudah ada, bukan "ganti model utama saat ini." Untuk secara sengaja mengganti model default, gunakan `openclaw models set ` atau `openclaw models auth login --provider --set-default`. Rute keluarga OpenAI bersifat spesifik prefix: - `openai/` menggunakan harness app-server Codex native untuk giliran agen secara default. Ini adalah penyiapan langganan ChatGPT/Codex yang umum. - `openai-codex/` adalah config legacy yang ditulis ulang oleh doctor menjadi `openai/`. - `openai/` plus penyedia/model `agentRuntime.id: "pi"` menggunakan PI untuk API key eksplisit atau rute kompatibilitas. Lihat [OpenAI](/id/providers/openai) dan [Harness Codex](/id/plugins/codex-harness). Jika pemisahan penyedia/runtime membingungkan, baca [Runtime agen](/id/concepts/agent-runtimes) terlebih dahulu. Auto-enable Plugin mengikuti batas yang sama: referensi agen `openai/*` mengaktifkan Plugin Codex untuk rute default, dan penyedia/model eksplisit `agentRuntime.id: "codex"` atau referensi legacy `codex/` juga memerlukannya. GPT-5.5 tersedia melalui harness app-server Codex native secara default pada `openai/gpt-5.5`, dan melalui PI hanya saat kebijakan runtime penyedia/model secara eksplisit memilih `pi`. Runtime CLI menggunakan pemisahan yang sama: pilih referensi model kanonis seperti `anthropic/claude-*`, `google/gemini-*`, atau `openai/gpt-*`, lalu setel kebijakan runtime penyedia/model ke `claude-cli`, `google-gemini-cli`, atau `codex-cli` saat Anda menginginkan backend CLI lokal. Referensi legacy `claude-cli/*`, `google-gemini-cli/*`, dan `codex-cli/*` bermigrasi kembali ke referensi penyedia kanonis dengan runtime dicatat secara terpisah. ## Perilaku penyedia milik Plugin Sebagian besar logika spesifik penyedia berada di Plugin penyedia (`registerProvider(...)`) sementara OpenClaw mempertahankan loop inferensi generik. Plugin memiliki onboarding, katalog model, pemetaan env-var auth, normalisasi transport/config, pembersihan tool-schema, klasifikasi failover, refresh OAuth, pelaporan penggunaan, profil thinking/reasoning, dan lainnya. Daftar lengkap hook SDK penyedia dan contoh Plugin bawaan tersedia di [Plugin penyedia](/id/plugins/sdk-provider-plugins). Penyedia yang membutuhkan eksekutor permintaan yang sepenuhnya kustom adalah permukaan ekstensi terpisah yang lebih dalam. Perilaku runner milik penyedia berada pada hook penyedia eksplisit seperti kebijakan replay, normalisasi tool-schema, pembungkusan stream, dan pembantu transport/request. Static bag legacy `ProviderPlugin.capabilities` hanya untuk kompatibilitas dan tidak lagi dibaca oleh logika runner bersama. ## Rotasi API key Konfigurasikan beberapa key melalui: - `OPENCLAW_LIVE__KEY` (override live tunggal, prioritas tertinggi) - `_API_KEYS` (daftar dipisahkan koma atau titik koma) - `_API_KEY` (key utama) - `_API_KEY_*` (daftar bernomor, mis. `_API_KEY_1`) Untuk penyedia Google, `GOOGLE_API_KEY` juga disertakan sebagai fallback. Urutan pemilihan key mempertahankan prioritas dan menduplikasi nilai dihapus. - Permintaan dicoba ulang dengan key berikutnya hanya pada respons rate-limit (misalnya `429`, `rate_limit`, `quota`, `resource exhausted`, `Too many concurrent requests`, `ThrottlingException`, `concurrency limit reached`, `workers_ai ... quota limit exceeded`, atau pesan batas penggunaan periodik). - Kegagalan non-rate-limit langsung gagal; tidak ada rotasi key yang dicoba. - Saat semua kandidat key gagal, error final dikembalikan dari percobaan terakhir. ## Penyedia bawaan (katalog pi-ai) OpenClaw dikirimkan dengan katalog pi-ai. Penyedia ini **tidak** memerlukan config `models.providers`; cukup setel auth + pilih model. ### OpenAI - Penyedia: `openai` - Auth: `OPENAI_API_KEY` - Rotasi opsional: `OPENAI_API_KEYS`, `OPENAI_API_KEY_1`, `OPENAI_API_KEY_2`, plus `OPENCLAW_LIVE_OPENAI_KEY` (override tunggal) - Contoh model: `openai/gpt-5.5`, `openai/gpt-5.4-mini` - Verifikasi ketersediaan akun/model dengan `openclaw models list --provider openai` jika instalasi atau API key tertentu berperilaku berbeda. - CLI: `openclaw onboard --auth-choice openai-api-key` - Transport default adalah `auto`; OpenClaw meneruskan pilihan transport ke pi-ai. - Override per model melalui `agents.defaults.models["openai/"].params.transport` (`"sse"`, `"websocket"`, atau `"auto"`) - Pemrosesan prioritas OpenAI dapat diaktifkan melalui `agents.defaults.models["openai/"].params.serviceTier` - `/fast` dan `params.fastMode` memetakan permintaan Responses langsung `openai/*` ke `service_tier=priority` pada `api.openai.com` - Gunakan `params.serviceTier` saat Anda menginginkan tingkat eksplisit alih-alih toggle `/fast` bersama - Header atribusi OpenClaw tersembunyi (`originator`, `version`, `User-Agent`) hanya berlaku pada traffic OpenAI native ke `api.openai.com`, bukan proxy kompatibel OpenAI generik - Rute OpenAI native juga mempertahankan `store` Responses, petunjuk prompt-cache, dan pembentukan payload kompatibilitas reasoning OpenAI; rute proxy tidak - `openai/gpt-5.3-codex-spark` sengaja disembunyikan di OpenClaw karena permintaan API OpenAI live menolaknya dan katalog Codex saat ini tidak mengeksposnya ```json5 { agents: { defaults: { model: { primary: "openai/gpt-5.5" } } }, } ``` ### Anthropic - Penyedia: `anthropic` - Auth: `ANTHROPIC_API_KEY` - Rotasi opsional: `ANTHROPIC_API_KEYS`, `ANTHROPIC_API_KEY_1`, `ANTHROPIC_API_KEY_2`, plus `OPENCLAW_LIVE_ANTHROPIC_KEY` (override tunggal) - Contoh model: `anthropic/claude-opus-4-6` - CLI: `openclaw onboard --auth-choice apiKey` - Permintaan Anthropic publik langsung mendukung toggle `/fast` bersama dan `params.fastMode`, termasuk traffic yang diautentikasi dengan API key dan OAuth yang dikirim ke `api.anthropic.com`; OpenClaw memetakannya ke `service_tier` Anthropic (`auto` vs `standard_only`) - Config Claude CLI pilihan mempertahankan referensi model tetap kanonis dan memilih backend CLI secara terpisah: `anthropic/claude-opus-4-7` dengan `agentRuntime.id: "claude-cli"` yang diskopkan ke model. Referensi legacy `claude-cli/claude-opus-4-7` masih berfungsi untuk kompatibilitas. Staf Anthropic memberi tahu kami bahwa penggunaan Claude CLI gaya OpenClaw diizinkan kembali, jadi OpenClaw memperlakukan reuse Claude CLI dan penggunaan `claude -p` sebagai disetujui untuk integrasi ini kecuali Anthropic menerbitkan kebijakan baru. Setup-token Anthropic tetap tersedia sebagai jalur token OpenClaw yang didukung, tetapi OpenClaw sekarang lebih memilih reuse Claude CLI dan `claude -p` saat tersedia. ```json5 { agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } }, } ``` ### OAuth OpenAI Codex - Penyedia: `openai-codex` - Auth: OAuth (ChatGPT) - Referensi model PI legacy: `openai-codex/gpt-5.5` - Referensi harness app-server Codex native: `openai/gpt-5.5` - Dokumen harness app-server Codex native: [Harness Codex](/id/plugins/codex-harness) - Referensi model legacy: `codex/gpt-*` - Batas Plugin: `openai-codex/*` memuat Plugin OpenAI; Plugin app-server Codex native dipilih hanya oleh runtime harness Codex atau referensi legacy `codex/*`. - CLI: `openclaw onboard --auth-choice openai-codex` atau `openclaw models auth login --provider openai-codex` - Transport default adalah `auto` (WebSocket terlebih dahulu, fallback SSE) - Override per model PI melalui `agents.defaults.models["openai-codex/"].params.transport` (`"sse"`, `"websocket"`, atau `"auto"`) - `params.serviceTier` juga diteruskan pada permintaan Responses Codex native (`chatgpt.com/backend-api`) - Header atribusi OpenClaw tersembunyi (`originator`, `version`, `User-Agent`) hanya dilampirkan pada traffic Codex native ke `chatgpt.com/backend-api`, bukan proxy kompatibel OpenAI generik - Berbagi config toggle `/fast` dan `params.fastMode` yang sama seperti `openai/*` langsung; OpenClaw memetakannya ke `service_tier=priority` - `openai-codex/gpt-5.5` menggunakan `contextWindow = 400000` native katalog Codex dan runtime default `contextTokens = 272000`; override batas runtime dengan `models.providers.openai-codex.models[].contextTokens` - Catatan kebijakan: OAuth OpenAI Codex secara eksplisit didukung untuk alat/workflow eksternal seperti OpenClaw. - Untuk rute umum langganan plus runtime Codex native, masuk dengan auth `openai-codex` tetapi konfigurasikan `openai/gpt-5.5`; giliran agen OpenAI memilih Codex secara default. - Gunakan penyedia/model `agentRuntime.id: "pi"` hanya saat Anda menginginkan rute kompatibilitas melalui PI; jika tidak, pertahankan `openai/gpt-5.5` pada harness Codex default. - Referensi `openai-codex/gpt-5.1*`, `openai-codex/gpt-5.2*`, dan `openai-codex/gpt-5.3*` yang lebih lama disembunyikan karena akun OAuth ChatGPT/Codex menolaknya; gunakan `openai-codex/gpt-5.5` atau rute runtime Codex native sebagai gantinya. ```json5 { plugins: { entries: { codex: { enabled: true } } }, agents: { defaults: { model: { primary: "openai/gpt-5.5" }, }, }, } ``` ```json5 { models: { providers: { "openai-codex": { models: [{ id: "gpt-5.5", contextTokens: 160000 }], }, }, }, } ``` ### Opsi hosted bergaya langganan lainnya Z.AI Coding Plan atau endpoint API umum. OAuth MiniMax Coding Plan atau akses API key. Permukaan penyedia Qwen Cloud plus pemetaan endpoint Alibaba DashScope dan Coding Plan. ### OpenCode - Auth: `OPENCODE_API_KEY` (atau `OPENCODE_ZEN_API_KEY`) - Penyedia runtime Zen: `opencode` - Penyedia runtime Go: `opencode-go` - Contoh model: `opencode/claude-opus-4-6`, `opencode-go/kimi-k2.6` - CLI: `openclaw onboard --auth-choice opencode-zen` atau `openclaw onboard --auth-choice opencode-go` ```json5 { agents: { defaults: { model: { primary: "opencode/claude-opus-4-6" } } }, } ``` ### Google Gemini (API key) - Penyedia: `google` - Autentikasi: `GEMINI_API_KEY` - Rotasi opsional: fallback `GEMINI_API_KEYS`, `GEMINI_API_KEY_1`, `GEMINI_API_KEY_2`, `GOOGLE_API_KEY`, dan `OPENCLAW_LIVE_GEMINI_KEY` (penimpaan tunggal) - Model contoh: `google/gemini-3.1-pro-preview`, `google/gemini-3-flash-preview` - Kompatibilitas: konfigurasi lama OpenClaw yang menggunakan `google/gemini-3.1-flash-preview` dinormalisasi menjadi `google/gemini-3-flash-preview` - Alias: `google/gemini-3.1-pro` diterima dan dinormalisasi ke id Gemini API live milik Google, `google/gemini-3.1-pro-preview` - CLI: `openclaw onboard --auth-choice gemini-api-key` - Penalaran: `/think adaptive` menggunakan penalaran dinamis Google. Gemini 3/3.1 menghilangkan `thinkingLevel` tetap; Gemini 2.5 mengirim `thinkingBudget: -1`. - Eksekusi Gemini langsung juga menerima `agents.defaults.models["google/"].params.cachedContent` (atau `cached_content` lama) untuk meneruskan handle native penyedia `cachedContents/...`; hit cache Gemini muncul sebagai OpenClaw `cacheRead` ### Google Vertex dan Gemini CLI - Penyedia: `google-vertex`, `google-gemini-cli` - Autentikasi: Vertex menggunakan gcloud ADC; Gemini CLI menggunakan alur OAuth-nya OAuth Gemini CLI di OpenClaw adalah integrasi tidak resmi. Beberapa pengguna melaporkan pembatasan akun Google setelah menggunakan klien pihak ketiga. Tinjau ketentuan Google dan gunakan akun non-kritis jika Anda memilih untuk melanjutkan. OAuth Gemini CLI dikirim sebagai bagian dari Plugin `google` bawaan. ```bash brew install gemini-cli ``` ```bash npm install -g @google/gemini-cli ``` ```bash openclaw plugins enable google ``` ```bash openclaw models auth login --provider google-gemini-cli --set-default ``` Model default: `google-gemini-cli/gemini-3-flash-preview`. Anda **tidak** menempelkan id klien atau rahasia ke dalam `openclaw.json`. Alur masuk CLI menyimpan token dalam profil autentikasi di host Gateway. Jika permintaan gagal setelah masuk, tetapkan `GOOGLE_CLOUD_PROJECT` atau `GOOGLE_CLOUD_PROJECT_ID` pada host Gateway. Balasan JSON Gemini CLI diurai dari `response`; penggunaan fallback ke `stats`, dengan `stats.cached` dinormalisasi menjadi OpenClaw `cacheRead`. ### Z.AI (GLM) - Penyedia: `zai` - Autentikasi: `ZAI_API_KEY` - Model contoh: `zai/glm-5.1` - CLI: `openclaw onboard --auth-choice zai-api-key` - Alias: `z.ai/*` dan `z-ai/*` dinormalisasi menjadi `zai/*` - `zai-api-key` otomatis mendeteksi endpoint Z.AI yang sesuai; `zai-coding-global`, `zai-coding-cn`, `zai-global`, dan `zai-cn` memaksa permukaan tertentu ### Vercel AI Gateway - Penyedia: `vercel-ai-gateway` - Autentikasi: `AI_GATEWAY_API_KEY` - Model contoh: `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 - Penyedia: `kilocode` - Autentikasi: `KILOCODE_API_KEY` - Model contoh: `kilocode/kilo/auto` - CLI: `openclaw onboard --auth-choice kilocode-api-key` - URL dasar: `https://api.kilo.ai/api/gateway/` - Katalog fallback statis mengirim `kilocode/kilo/auto`; penemuan live `https://api.kilo.ai/api/gateway/models` dapat memperluas katalog runtime lebih lanjut. - Perutean upstream persis di balik `kilocode/kilo/auto` dimiliki oleh Kilo Gateway, bukan di-hard-code di OpenClaw. Lihat [/providers/kilocode](/id/providers/kilocode) untuk detail penyiapan. ### Plugin penyedia bawaan lainnya | Penyedia | Id | Env autentikasi | Contoh model | | ----------------------- | -------------------------------- | ------------------------------------------------------------ | --------------------------------------------- | | BytePlus | `byteplus` / `byteplus-plan` | `BYTEPLUS_API_KEY` | `byteplus-plan/ark-code-latest` | | Cerebras | `cerebras` | `CEREBRAS_API_KEY` | `cerebras/zai-glm-4.7` | | Cloudflare AI Gateway | `cloudflare-ai-gateway` | `CLOUDFLARE_AI_GATEWAY_API_KEY` | - | | DeepInfra | `deepinfra` | `DEEPINFRA_API_KEY` | `deepinfra/deepseek-ai/DeepSeek-V3.2` | | DeepSeek | `deepseek` | `DEEPSEEK_API_KEY` | `deepseek/deepseek-v4-flash` | | GitHub Copilot | `github-copilot` | `COPILOT_GITHUB_TOKEN` / `GH_TOKEN` / `GITHUB_TOKEN` | - | | Groq | `groq` | `GROQ_API_KEY` | - | | Hugging Face Inference | `huggingface` | `HUGGINGFACE_HUB_TOKEN` atau `HF_TOKEN` | `huggingface/deepseek-ai/DeepSeek-R1` | | Kilo Gateway | `kilocode` | `KILOCODE_API_KEY` | `kilocode/kilo/auto` | | Kimi Coding | `kimi` | `KIMI_API_KEY` atau `KIMICODE_API_KEY` | `kimi/kimi-for-coding` | | MiniMax | `minimax` / `minimax-portal` | `MINIMAX_API_KEY` / `MINIMAX_OAUTH_TOKEN` | `minimax/MiniMax-M2.7` | | Mistral | `mistral` | `MISTRAL_API_KEY` | `mistral/mistral-large-latest` | | Moonshot | `moonshot` | `MOONSHOT_API_KEY` | `moonshot/kimi-k2.6` | | NVIDIA | `nvidia` | `NVIDIA_API_KEY` | `nvidia/nvidia/nemotron-3-super-120b-a12b` | | OpenRouter | `openrouter` | `OPENROUTER_API_KEY` | `openrouter/auto` | | Qianfan | `qianfan` | `QIANFAN_API_KEY` | `qianfan/deepseek-v3.2` | | Qwen Cloud | `qwen` | `QWEN_API_KEY` / `MODELSTUDIO_API_KEY` / `DASHSCOPE_API_KEY` | `qwen/qwen3.5-plus` | | StepFun | `stepfun` / `stepfun-plan` | `STEPFUN_API_KEY` | `stepfun/step-3.5-flash` | | Together | `together` | `TOGETHER_API_KEY` | `together/moonshotai/Kimi-K2.5` | | Venice | `venice` | `VENICE_API_KEY` | - | | Vercel AI Gateway | `vercel-ai-gateway` | `AI_GATEWAY_API_KEY` | `vercel-ai-gateway/anthropic/claude-opus-4.6` | | Volcano Engine (Doubao) | `volcengine` / `volcengine-plan` | `VOLCANO_ENGINE_API_KEY` | `volcengine-plan/ark-code-latest` | | xAI | `xai` | `XAI_API_KEY` | `xai/grok-4.3` | | Xiaomi | `xiaomi` | `XIAOMI_API_KEY` | `xiaomi/mimo-v2-flash` | #### Keunikan yang perlu diketahui Menerapkan header atribusi aplikasinya dan penanda Anthropic `cache_control` hanya pada rute `openrouter.ai` yang terverifikasi. Referensi DeepSeek, Moonshot, dan ZAI memenuhi syarat cache-TTL untuk caching prompt yang dikelola OpenRouter, tetapi tidak menerima penanda cache Anthropic. Sebagai jalur kompatibel OpenAI bergaya proksi, jalur ini melewati pembentukan yang hanya untuk OpenAI native (`serviceTier`, Responses `store`, petunjuk prompt-cache, kompatibilitas penalaran OpenAI). Referensi berbasis Gemini hanya mempertahankan sanitasi tanda tangan pemikiran proxy-Gemini. Referensi berbasis Gemini mengikuti jalur sanitasi proxy-Gemini yang sama; `kilocode/kilo/auto` dan referensi lain yang tidak mendukung penalaran proksi melewati injeksi penalaran proksi. Onboarding kunci API menulis definisi model chat M2.7 eksplisit yang hanya teks; pemahaman gambar tetap berada pada penyedia media `MiniMax-VL-01` yang dimiliki plugin. ID model menggunakan namespace `nvidia//` (misalnya `nvidia/nvidia/nemotron-...` bersama `nvidia/moonshotai/kimi-k2.5`); pemilih mempertahankan komposisi literal `/` sementara kunci kanonis yang dikirim ke API tetap berprefiks tunggal. Menggunakan jalur xAI Responses. `grok-4.3` adalah model chat default yang dibundel. `/fast` atau `params.fastMode: true` menulis ulang `grok-3`, `grok-3-mini`, `grok-4`, dan `grok-4-0709` ke varian `*-fast` masing-masing. `tool_stream` aktif secara default; nonaktifkan melalui `agents.defaults.models["xai/"].params.tool_stream=false`. Dikirim sebagai plugin penyedia `cerebras` yang dibundel. GLM menggunakan `zai-glm-4.7`; URL dasar kompatibel OpenAI adalah `https://api.cerebras.ai/v1`. ## Penyedia melalui `models.providers` (URL kustom/dasar) Gunakan `models.providers` (atau `models.json`) untuk menambahkan penyedia **kustom** atau proksi yang kompatibel dengan OpenAI/Anthropic. Banyak plugin penyedia yang dibundel di bawah ini sudah menerbitkan katalog default. Gunakan entri `models.providers.` eksplisit hanya saat Anda ingin mengganti URL dasar default, header, atau daftar model. Pemeriksaan kapabilitas model Gateway juga membaca metadata eksplisit `models.providers..models[]`. Jika model kustom atau proksi menerima gambar, tetapkan `input: ["text", "image"]` pada model tersebut agar jalur lampiran WebChat dan asal node meneruskan gambar sebagai input model native, bukan referensi media yang hanya teks. `agents.defaults.models["provider/model"]` hanya mengontrol visibilitas model, alias, dan metadata per model untuk agen. Itu tidak mendaftarkan model runtime baru dengan sendirinya. Untuk model penyedia kustom, tambahkan juga `models.providers..models[]` dengan setidaknya `id` yang cocok. ### Moonshot AI (Kimi) Moonshot dikirim sebagai plugin penyedia yang dibundel. Gunakan penyedia bawaan secara default, dan tambahkan entri `models.providers.moonshot` eksplisit hanya saat Anda perlu mengganti URL dasar atau metadata model: - Penyedia: `moonshot` - Autentikasi: `MOONSHOT_API_KEY` - Contoh model: `moonshot/kimi-k2.6` - CLI: `openclaw onboard --auth-choice moonshot-api-key` atau `openclaw onboard --auth-choice moonshot-api-key-cn` ID model Kimi K2: [//]: # "moonshot-kimi-k2-model-refs:start" - `moonshot/kimi-k2.6` - `moonshot/kimi-k2.5` - `moonshot/kimi-k2-thinking` - `moonshot/kimi-k2-thinking-turbo` - `moonshot/kimi-k2-turbo` [//]: # "moonshot-kimi-k2-model-refs:end" ```json5 { 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" }], }, }, }, } ``` ### Pengodean Kimi Kimi Coding menggunakan endpoint kompatibel Anthropic milik Moonshot AI: - Penyedia: `kimi` - Autentikasi: `KIMI_API_KEY` - Contoh model: `kimi/kimi-for-coding` ```json5 { env: { KIMI_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "kimi/kimi-for-coding" } }, }, } ``` Legacy `kimi/kimi-code` dan `kimi/k2p5` tetap diterima sebagai id model kompatibilitas dan dinormalisasi ke id model API stabil Kimi. ### Volcano Engine (Doubao) Volcano Engine (火山引擎) menyediakan akses ke Doubao dan model lain di Tiongkok. - Penyedia: `volcengine` (pengodean: `volcengine-plan`) - Autentikasi: `VOLCANO_ENGINE_API_KEY` - Contoh model: `volcengine-plan/ark-code-latest` - CLI: `openclaw onboard --auth-choice volcengine-api-key` ```json5 { agents: { defaults: { model: { primary: "volcengine-plan/ark-code-latest" } }, }, } ``` Onboarding secara default menggunakan permukaan pengodean, tetapi katalog umum `volcengine/*` didaftarkan pada saat yang sama. Di pemilih model onboarding/konfigurasi, pilihan autentikasi Volcengine memprioritaskan baris `volcengine/*` dan `volcengine-plan/*`. Jika model tersebut belum dimuat, OpenClaw kembali ke katalog tanpa filter alih-alih menampilkan pemilih kosong yang dibatasi per penyedia. - `volcengine/doubao-seed-1-8-251228` (Doubao Seed 1.8) - `volcengine/doubao-seed-code-preview-251028` - `volcengine/kimi-k2-5-260127` (Kimi K2.5) - `volcengine/glm-4-7-251222` (GLM 4.7) - `volcengine/deepseek-v3-2-251201` (DeepSeek V3.2 128K) - `volcengine-plan/ark-code-latest` - `volcengine-plan/doubao-seed-code` - `volcengine-plan/kimi-k2.5` - `volcengine-plan/kimi-k2-thinking` - `volcengine-plan/glm-4.7` ### BytePlus (Internasional) BytePlus ARK menyediakan akses ke model yang sama seperti Volcano Engine untuk pengguna internasional. - Penyedia: `byteplus` (pengodean: `byteplus-plan`) - Autentikasi: `BYTEPLUS_API_KEY` - Contoh model: `byteplus-plan/ark-code-latest` - CLI: `openclaw onboard --auth-choice byteplus-api-key` ```json5 { agents: { defaults: { model: { primary: "byteplus-plan/ark-code-latest" } }, }, } ``` Onboarding secara default menggunakan permukaan pengodean, tetapi katalog umum `byteplus/*` didaftarkan pada saat yang sama. Di pemilih model onboarding/konfigurasi, pilihan autentikasi BytePlus memprioritaskan baris `byteplus/*` dan `byteplus-plan/*`. Jika model tersebut belum dimuat, OpenClaw kembali ke katalog tanpa filter alih-alih menampilkan pemilih kosong yang dibatasi per penyedia. - `byteplus/seed-1-8-251228` (Seed 1.8) - `byteplus/kimi-k2-5-260127` (Kimi K2.5) - `byteplus/glm-4-7-251222` (GLM 4.7) - `byteplus-plan/ark-code-latest` - `byteplus-plan/doubao-seed-code` - `byteplus-plan/kimi-k2.5` - `byteplus-plan/kimi-k2-thinking` - `byteplus-plan/glm-4.7` ### Synthetic Synthetic menyediakan model kompatibel Anthropic di balik penyedia `synthetic`: - Penyedia: `synthetic` - Autentikasi: `SYNTHETIC_API_KEY` - Contoh model: `synthetic/hf:MiniMaxAI/MiniMax-M2.5` - CLI: `openclaw onboard --auth-choice synthetic-api-key` ```json5 { 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 dikonfigurasi melalui `models.providers` karena menggunakan endpoint khusus: - MiniMax OAuth (Global): `--auth-choice minimax-global-oauth` - MiniMax OAuth (CN): `--auth-choice minimax-cn-oauth` - Kunci API MiniMax (Global): `--auth-choice minimax-global-api` - Kunci API MiniMax (CN): `--auth-choice minimax-cn-api` - Autentikasi: `MINIMAX_API_KEY` untuk `minimax`; `MINIMAX_OAUTH_TOKEN` atau `MINIMAX_API_KEY` untuk `minimax-portal` Lihat [/providers/minimax](/id/providers/minimax) untuk detail penyiapan, opsi model, dan cuplikan konfigurasi. Pada jalur streaming kompatibel Anthropic milik MiniMax, OpenClaw menonaktifkan thinking secara default kecuali Anda mengaturnya secara eksplisit, dan `/fast on` menulis ulang `MiniMax-M2.7` menjadi `MiniMax-M2.7-highspeed`. Pemisahan kapabilitas milik Plugin: - Default teks/chat tetap di `minimax/MiniMax-M2.7` - Pembuatan gambar adalah `minimax/image-01` atau `minimax-portal/image-01` - Pemahaman gambar adalah `MiniMax-VL-01` milik Plugin pada kedua jalur autentikasi MiniMax - Pencarian web tetap pada id penyedia `minimax` ### LM Studio LM Studio dikirim sebagai Plugin penyedia bawaan yang menggunakan API native: - Penyedia: `lmstudio` - Autentikasi: `LM_API_TOKEN` - URL dasar inferensi default: `http://localhost:1234/v1` Lalu tetapkan model (ganti dengan salah satu ID yang dikembalikan oleh `http://localhost:1234/api/v1/models`): ```json5 { agents: { defaults: { model: { primary: "lmstudio/openai/gpt-oss-20b" } }, }, } ``` OpenClaw menggunakan `/api/v1/models` dan `/api/v1/models/load` native LM Studio untuk penemuan + pemuatan otomatis, dengan `/v1/chat/completions` untuk inferensi secara default. Jika Anda ingin pemuatan JIT, TTL, dan pengosongan otomatis LM Studio memiliki siklus hidup model, tetapkan `models.providers.lmstudio.params.preload: false`. Lihat [/providers/lmstudio](/id/providers/lmstudio) untuk penyiapan dan pemecahan masalah. ### Ollama Ollama dikirim sebagai Plugin penyedia bawaan dan menggunakan API native Ollama: - Penyedia: `ollama` - Autentikasi: Tidak diperlukan (server lokal) - Contoh model: `ollama/llama3.3` - Instalasi: [https://ollama.com/download](https://ollama.com/download) ```bash # Install Ollama, then pull a model: ollama pull llama3.3 ``` ```json5 { agents: { defaults: { model: { primary: "ollama/llama3.3" } }, }, } ``` Ollama dideteksi secara lokal di `http://127.0.0.1:11434` ketika Anda ikut serta dengan `OLLAMA_API_KEY`, dan Plugin penyedia bawaan menambahkan Ollama langsung ke `openclaw onboard` dan pemilih model. Lihat [/providers/ollama](/id/providers/ollama) untuk onboarding, mode cloud/lokal, dan konfigurasi khusus. ### vLLM vLLM dikirim sebagai Plugin penyedia bawaan untuk server lokal/self-hosted yang kompatibel OpenAI: - Penyedia: `vllm` - Autentikasi: Opsional (tergantung server Anda) - URL dasar default: `http://127.0.0.1:8000/v1` Untuk ikut serta dalam penemuan otomatis secara lokal (nilai apa pun berfungsi jika server Anda tidak menerapkan autentikasi): ```bash export VLLM_API_KEY="vllm-local" ``` Lalu tetapkan model (ganti dengan salah satu ID yang dikembalikan oleh `/v1/models`): ```json5 { agents: { defaults: { model: { primary: "vllm/your-model-id" } }, }, } ``` Lihat [/providers/vllm](/id/providers/vllm) untuk detail. ### SGLang SGLang dikirim sebagai Plugin penyedia bawaan untuk server self-hosted cepat yang kompatibel OpenAI: - Penyedia: `sglang` - Autentikasi: Opsional (tergantung server Anda) - URL dasar default: `http://127.0.0.1:30000/v1` Untuk ikut serta dalam penemuan otomatis secara lokal (nilai apa pun berfungsi jika server Anda tidak menerapkan autentikasi): ```bash export SGLANG_API_KEY="sglang-local" ``` Lalu tetapkan model (ganti dengan salah satu ID yang dikembalikan oleh `/v1/models`): ```json5 { agents: { defaults: { model: { primary: "sglang/your-model-id" } }, }, } ``` Lihat [/providers/sglang](/id/providers/sglang) untuk detail. ### Proksi lokal (LM Studio, vLLM, LiteLLM, dll.) Contoh (kompatibel OpenAI): ```json5 { 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, }, ], }, }, }, } ``` Untuk penyedia khusus, `reasoning`, `input`, `cost`, `contextWindow`, dan `maxTokens` bersifat opsional. Jika dihilangkan, OpenClaw secara default menggunakan: - `reasoning: false` - `input: ["text"]` - `cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }` - `contextWindow: 200000` - `maxTokens: 8192` Disarankan: tetapkan nilai eksplisit yang sesuai dengan batas proksi/model Anda. - Untuk `api: "openai-completions"` pada endpoint non-native (`baseUrl` tidak kosong apa pun yang host-nya bukan `api.openai.com`), OpenClaw memaksa `compat.supportsDeveloperRole: false` untuk menghindari error 400 penyedia bagi peran `developer` yang tidak didukung. - Rute kompatibel OpenAI bergaya proksi juga melewati pembentukan permintaan khusus OpenAI native: tanpa `service_tier`, tanpa Responses `store`, tanpa Completions `store`, tanpa petunjuk prompt-cache, tanpa pembentukan payload kompatibilitas reasoning OpenAI, dan tanpa header atribusi OpenClaw tersembunyi. - Untuk proksi Completions kompatibel OpenAI yang memerlukan kolom khusus vendor, tetapkan `agents.defaults.models["provider/model"].params.extra_body` (atau `extraBody`) untuk menggabungkan JSON tambahan ke dalam body permintaan keluar. - Untuk kontrol chat-template vLLM, tetapkan `agents.defaults.models["provider/model"].params.chat_template_kwargs`. Plugin vLLM bawaan secara otomatis mengirim `enable_thinking: false` dan `force_nonempty_content: true` untuk `vllm/nemotron-3-*` ketika level thinking sesi nonaktif. - Untuk model lokal yang lambat atau host LAN/tailnet jarak jauh, tetapkan `models.providers..timeoutSeconds`. Ini memperpanjang penanganan permintaan HTTP model penyedia, termasuk koneksi, header, streaming body, dan abort guarded-fetch total, tanpa meningkatkan timeout runtime agen secara keseluruhan. - Panggilan HTTP penyedia model mengizinkan jawaban DNS fake-IP Surge, Clash, dan sing-box di `198.18.0.0/15` dan `fc00::/7` hanya untuk hostname `baseUrl` penyedia yang dikonfigurasi. Tujuan private, loopback, link-local, dan metadata lainnya tetap memerlukan opt-in eksplisit `models.providers..request.allowPrivateNetwork: true`. - Jika `baseUrl` kosong/dihilangkan, OpenClaw mempertahankan perilaku OpenAI default (yang mengarah ke `api.openai.com`). - Demi keamanan, `compat.supportsDeveloperRole: true` eksplisit tetap ditimpa pada endpoint `openai-completions` non-native. - Untuk `api: "anthropic-messages"` pada endpoint non-langsung (penyedia apa pun selain `anthropic` kanonis, atau `models.providers.anthropic.baseUrl` khusus yang host-nya bukan endpoint publik `api.anthropic.com`), OpenClaw menekan header beta Anthropic implisit seperti `claude-code-20250219`, `interleaved-thinking-2025-05-14`, dan penanda OAuth, sehingga proksi khusus kompatibel Anthropic tidak menolak flag beta yang tidak didukung. Tetapkan `models.providers..headers["anthropic-beta"]` secara eksplisit jika proksi Anda memerlukan fitur beta tertentu. ## Contoh CLI ```bash openclaw onboard --auth-choice opencode-zen openclaw models set opencode/claude-opus-4-6 openclaw models list ``` Lihat juga: [Konfigurasi](/id/gateway/configuration) untuk contoh konfigurasi lengkap. ## Terkait - [Referensi konfigurasi](/id/gateway/config-agents#agent-defaults) - kunci konfigurasi model - [Failover model](/id/concepts/model-failover) - rantai fallback dan perilaku percobaan ulang - [Model](/id/concepts/models) - konfigurasi model dan alias - [Penyedia](/id/providers) - panduan penyiapan per penyedia