Provider Catalog

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>".

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`

GPT-4o, GPT-5, o-series reasoning models. Reasoning tokens surfaced as ReasoningDelta events; see Streaming.

OpenAI Codex: `openai` slot with `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 use the Codex subscription login (from the Codex CLI’s own ~/.codex/auth.json) instead of an api_key field on the entry. The subscription path does not read OPENAI_API_KEY; that variable applies only to the metered openai API-key mode. See Provider Configuration → OAuth and subscription auth for the credential model.

Ollama: slot `ollama`

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

Bedrock: slot `bedrock`

Gemini: slot `gemini`

Google’s Gemini API. Supports vision and pre-executed grounded search (see Streaming for PreExecutedToolCall events).

Gemini CLI: slot `gemini_cli`

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

Azure OpenAI: slot `azure`

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

Copilot: slot `copilot`

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

Telnyx: slot `telnyx`

Voice-oriented AI endpoint. Pair with the clawdtalk channel for real-time SIP calls.

KiloCLI: slot `kilocli`

Local inference via KiloCLI.

Kilo AI Gateway: slot `kilo`

[providers.models.kilo.home]
model   = "anthropic/claude-sonnet-4-6"
api_key = "..."
# endpoint = "gateway"  # default → https://api.kilo.ai/api/gateway

Cloud API via Kilo AI Gateway. Bearer-token auth with multiple model tiers (free, balanced, pro). The /models endpoint is public (PUBLIC_MODEL_LISTING), so model listing works without a credential. Because it is queried live, it is the source that carries pricing into the cost-rates editor. The shared models.dev catalog (kilo key) is only a fallback for when the live endpoint is unreachable, and it does not include pricing.

Naming migration: kilo now refers to this gateway provider. The KiloCLI subprocess provider keeps its kilocli slot (synonym kilo-cli). If you previously configured the CLI provider under the kilo shorthand, switch to kilocli.

All slots

Every canonical slot, its default endpoint, whether it runs locally, and its full config field set, generated from the provider registry and the config schema. Click a slot to expand its fields; click a field to see how to set it. Slots with no fixed default need uri set on the alias entry (Azure, custom, multi-region families, CLI shims).

Shared fields

Every provider slot accepts these fields. Slot-specific extras are listed per provider below.

api_key 🔑 secret · default —

Secret API token for this model_provider. Grab it from the model_provider’s dashboard (OpenAI platform, Anthropic console, OpenRouter keys page, etc.). Stored via the OS keyring when possible; never commit it to config.toml directly.

Set it on any surface:

Keyboard shortcuts

ZeroClaw Docs