提供程序目录

Every model-provider family ZeroClaw ships with. For each: config shape, notes on auth and endpoint behavior, and the slot key to use under [providers.models.<type>.<alias>].

See Configuration for universal fields (api_key, uri, model, …) and resolution order.

Examples below use home as the alias to underline that the alias half is operator-chosen — pick whatever name fits (work, personal, cn, prod, …). Reference it from an agent via model_provider = "<type>.<alias>".

原生

Anthropic — slot anthropic

[providers.models.anthropic.home]
model   = "claude-haiku-4-5-20251001"        # or claude-sonnet-4-6, claude-opus-4-7
api_key = "sk-ant-..."                       # or "sk-ant-oat-..." for OAuth

Supports OAuth tokens (sk-ant-oat*) from Claude Pro/Team subscriptions — no separate API billing. Streaming, tool calls, vision, and reasoning all supported. Custom endpoints (Anthropic-compatible proxies, e.g. Z.AI’s Anthropic API) go on this slot too — set uri to override.

OpenAI — slot openai

[providers.models.openai.home]
model   = "gpt-4o-mini"
api_key = "sk-..."

GPT-4o、GPT-5、o 系列推理模型。推理令牌以 ReasoningDelta 事件形式呈现；详见 流式传输。

OpenAI Codex — openai slot with requires_openai_auth = true

[providers.models.openai.coding]
model                  = "gpt-5-codex"
wire_api               = "responses"
requires_openai_auth   = true

OpenAI Codex subscription auth lives on the openai slot. Set wire_api = "responses" to route through POST /v1/responses and requires_openai_auth = true to pull credentials from OPENAI_API_KEY / ~/.codex/auth.json instead of an api_key field on the entry.

Ollama — slot ollama

[providers.models.ollama.local]
uri              = "http://localhost:11434"
model            = "qwen3.6:35b-a3b"
think            = false                     # disable chain-of-thought on reasoning models
reasoning_effort = "none"

Local inference via Ollama’s native /api/chat. Schema-based structured output via format. No API key.

Bedrock — slot bedrock

[providers.models.bedrock.home]
region = "us-east-1"                         # AWS region template variable
model  = "anthropic.claude-3-5-sonnet-20241022-v2:0"
# Auth via the standard AWS credentials chain (env, IAM role, ~/.aws/credentials).

Gemini — slot gemini

[providers.models.gemini.home]
model   = "gemini-2.5-pro"
api_key = "..."

Google 的 Gemini API。支持视觉和预执行的接地搜索（有关 PreExecutedToolCall 事件，请参阅 流式传输）。

Gemini CLI — slot gemini_cli

[providers.models.gemini_cli.home]
model = "gemini-2.5-pro"

Shells out to the gemini CLI; uses the CLI’s existing auth.

Azure OpenAI — slot azure

[providers.models.azure.home]
resource    = "my-resource"                  # https://{resource}.openai.azure.com/...
deployment  = "gpt-4o"
api_version = "2024-10-01-preview"
api_key     = "..."

resource, deployment, and api_version live in this typed config — they are not read from environment variables.

Copilot — slot copilot

[providers.models.copilot.home]
model = "gpt-4o"

Uses a GitHub Copilot subscription for agent inference. Authentication uses a Copilot OAuth token obtained from GitHub.

Telnyx — slot telnyx

[providers.models.telnyx.home]
model   = "..."
api_key = "..."

面向语音的 AI 端点。与 clawdtalk 通道配对，用于实时 SIP 通话。

KiloCLI — slot kilocli

[providers.models.kilocli.local]
model = "..."

通过 KiloCLI 进行本地推理。

OpenAI-compatible families

Every OpenAI-compatible vendor has its own canonical slot. There is no generic kind = "openai-compatible" selector — pick the slot that matches your provider, or use custom for endpoints not listed here.

Worked example (Groq):

[providers.models.groq.fast]
model   = "llama-3.3-70b-versatile"
api_key = "gsk_..."
# `uri` is omitted — the family's typed endpoint enum supplies the URL.

If your vendor isn’t listed, use custom:

[providers.models.custom.gateway]
uri     = "https://my-gateway.example.com/v1"
model   = "my-model-id"
api_key = "..."

Multi-region families

Several Chinese vendors expose distinct regional endpoints with different default models. Use one canonical slot and pick the region with the typed endpoint field on the alias entry.

Moonshot — slot moonshot

[providers.models.moonshot.cn]
api_key  = "..."
endpoint = "cn"                              # https://api.moonshot.cn/v1

[providers.models.moonshot.intl]
api_key  = "..."
endpoint = "intl"                            # https://api.moonshot.ai/v1

Variants: cn, intl, code.

Qwen / DashScope — slot qwen

[providers.models.qwen.intl]
api_key   = "..."
endpoint  = "intl"                           # variants: cn, intl
auth_mode = "oauth"                          # optional; for OAuth-backed Qwen accounts

OAuth-backed Qwen accounts use the same slot with auth_mode = "oauth".

GLM — slot glm

[providers.models.glm.home]
api_key  = "..."
endpoint = "default"

MiniMax — slot minimax

[providers.models.minimax.intl]
api_key  = "..."
endpoint = "intl"                            # variants: cn, intl

Z.AI — slot zai

[providers.models.zai.home]
api_key  = "..."
endpoint = "global"

For Z.AI’s Anthropic-compatible API, use [providers.models.anthropic.zai] with uri = "https://api.z.ai/api/anthropic" instead.

Doubao / Volcengine — slot doubao

[providers.models.doubao.home]
api_key  = "..."
endpoint = "default"

Other Chinese-region slots

• yi
• hunyuan
• qianfan
• baichuan

Routing layers

OpenRouter is treated as a single first-class provider, not a meta-router. The runtime sees one endpoint; OpenRouter handles vendor fan-out behind that endpoint.

[providers.models.openrouter.home]
model   = "anthropic/claude-sonnet-4-20250514"
api_key = "sk-or-..."

For per-task routing, run multiple agents and let channels pick which agent handles which traffic — see Routing. For a narrower in-config hint mechanism, use [[model_routes]].

缺少某些内容？

• If the endpoint is OpenAI-compatible, use the custom slot with uri set.
• If it has its own canonical slot above, use that — even if you only see one of its regions, the slot’s endpoint enum covers the rest.
• If it speaks a non-OpenAI wire format and needs its own implementation, see Custom providers.