Token API secreto para este model_provider. Obténgalo desde el panel de control del model_provider (plataforma de OpenAI, consola de Anthropic, página de claves de OpenRouter, etc.). Se almacena mediante el keyring del sistema operativo cuando es posible; nunca lo incluya directamente en config.toml.

Colócalo sobre cualquier superficie:

zeroclaw config set providers.models.custom.<alias>.api_key    # entrada enmascarada, almacenada cifrada

export ZEROCLAW_providers__models__custom__<alias>__api_key=

Pares arbitrarios de clave/valor reenviados sin modificaciones como un objeto de nivel superior chat_template_kwargs en el cuerpo de la solicitud de proveedores compatibles con OpenAI. Los backends compatibles con plantillas de chat, como vLLM, SGLang y llama.cpp, lo utilizan para pasar variables de plantilla específicas de la familia del modelo que controlan comportamientos no expuestos por otros campos. Debe ser un objeto JSON (tabla insertada de TOML); los valores que no sean objetos se ignoran y se muestra una advertencia. Ejemplo (supresión del razonamiento de Qwen3): chat_template_kwargs = { enable_thinking = false }

Colócalo sobre cualquier superficie:

zeroclaw config set providers.models.custom.<alias>.chat_template_kwargs <value>

export ZEROCLAW_providers__models__custom__<alias>__chat_template_kwargs=

Tamaño de la ventana de contexto (máximo de tokens de entrada) para este modelo. Se rellena automáticamente durante la configuración desde el endpoint /models del proveedor, si está disponible. Sobrescribe manualmente para endpoints personalizados o cuando la detección automática falla.

Colócalo sobre cualquier superficie:

zeroclaw config set providers.models.custom.<alias>.context_window <value>

export ZEROCLAW_providers__models__custom__<alias>__context_window=

Encabezados HTTP adicionales que se envían con cada solicitud. Caso de nicho: se usa para puentes de autenticación, proxies corporativos o gateways personalizados que exigen un encabezado de rastreo. La mayoría de los usuarios nunca lo modifican; edite config.toml directamente si lo necesita.

Colócalo sobre cualquier superficie:

zeroclaw config set providers.models.custom.<alias>.extra_headers    # entrada enmascarada, almacenada cifrada

export ZEROCLAW_providers__models__custom__<alias>__extra_headers=

Lista ordenada de otros alias de proveedor que se intentarán cuando todos los modelos de este alias hayan fallado. Cada entrada es una referencia con puntos <type>.<alias> dentro de providers.models y se resuelve con sus propias credenciales, endpoint y modelo. Un fallback nunca hereda la clave de este alias. El recorrido es en profundidad: primero se agotan los modelos de este alias, luego se desciende por cada alias de fallback en orden (aplicando sus propios fallback_models y fallback). Vacío significa que no hay fallback a nivel de proveedor.

Colócalo sobre cualquier superficie:

zeroclaw config set providers.models.custom.<alias>.fallback <value>

export ZEROCLAW_providers__models__custom__<alias>__fallback=

Modelos alternativos ordenados para probar en ESTE proveedor antes de recurrir a los alias de fallback. Mismo endpoint, clave y encabezados que el model principal. Solo cambia el identificador del modelo. Usa esto cuando un proveedor ofrece un modelo de respaldo (p. ej., una variante más pequeña o antigua) que debería probarse antes de abandonar el proveedor por completo. Vacío significa que solo se prueba model.

Colócalo sobre cualquier superficie:

zeroclaw config set providers.models.custom.<alias>.fallback_models <value>

export ZEROCLAW_providers__models__custom__<alias>__fallback_models=

Implementación de proveedor a instanciar para este perfil. Use esto cuando un slot tipado canónico deba ejecutarse a través de una implementación compatible, p. ej. [providers.models.openai.proxy] kind = "openai-compatible".

Colócalo sobre cualquier superficie:

zeroclaw config set providers.models.custom.<alias>.kind <value>

export ZEROCLAW_providers__models__custom__<alias>__kind=

Obtén los precios de tokens en vivo para los modelos de este proveedor desde su propio listado /models compatible con OpenAI (la pasarela es la fuente de verdad de sus precios), completando las tarifas de seguimiento de costes para los modelos que el operador NO haya fijado bajo [cost.rates] / pricing. Los modelos que la pasarela no tarifa (o los proveedores sin ningún listado HTTP /models, como una pasarela de subproceso como kilocli) recurren al catálogo público de models.dev. Las tarifas configuradas siempre prevalecen; los precios en vivo solo rellenan los huecos. Una tarea en segundo plano actualiza la instantánea de precios cada hora; la ruta de registro de costes lee la instantánea en caché y nunca bloquea en la red. Predeterminado false: desactivado significa que no hay obtención y el comportamiento es idéntico al de una compilación sin la función.

Colócalo sobre cualquier superficie:

zeroclaw config set providers.models.custom.<alias>.live_pricing <value>

export ZEROCLAW_providers__models__custom__<alias>__live_pricing=

Límite estricto de la longitud de respuesta en tokens. La mayoría de los modelos ya aplican límites integrados razonables; déjelo sin configurar a menos que necesite específicamente recortar salidas largas por razones de costo o latencia.

Colócalo sobre cualquier superficie:

zeroclaw config set providers.models.custom.<alias>.max_tokens <value>

export ZEROCLAW_providers__models__custom__<alias>__max_tokens=

Particularidad específica de ModelProvider: incorpora el prompt del sistema en el primer mensaje del usuario en lugar de enviar un rol system separado. Solo es necesario para modelos que rechazan (o manejan incorrectamente) un rol system independiente, p. ej., ciertas variantes antiguas de Mistral.

Colócalo sobre cualquier superficie:

zeroclaw config set providers.models.custom.<alias>.merge_system_into_user <value>

export ZEROCLAW_providers__models__custom__<alias>__merge_system_into_user=

Identificador de modelo que se envía con cada solicitud: la cadena de ID del catálogo del model_provider (p. ej. gpt-4o, claude-sonnet-4-5, llama-3.3-70b). Debe coincidir con un modelo que el model_provider realmente sirva en esta cuenta.

Colócalo sobre cualquier superficie:

zeroclaw config set providers.models.custom.<alias>.model <value>

export ZEROCLAW_providers__models__custom__<alias>__model=

Anula el valor predeterminado del proveedor para las llamadas nativas a herramientas. None (predeterminado) respeta la opción integrada del proveedor. Some(true) fuerza la activación de las llamadas nativas a herramientas, Some(false) fuerza el fallback a texto. Actualmente solo lo consulta la factory de Groq, que usa por defecto el fallback a texto porque los modelos de Groq de la familia llama rechazan las llamadas nativas a herramientas con HTTP 400. Establecer native_tools = true vuelve a habilitar las llamadas nativas a herramientas para los modelos de Groq que las admiten.

Colócalo sobre cualquier superficie:

zeroclaw config set providers.models.custom.<alias>.native_tools <value>

export ZEROCLAW_providers__models__custom__<alias>__native_tools=

Precios por modelo para el seguimiento de costos, en USD por 1M de tokens. Mapa de clave/valor de formato libre. Las claves son identificadores de modelo definidos por el usuario; un sufijo opcional .input / .output codifica la dimensión de precios cuando el operador desea dividir las tarifas. Una clave sin sufijo se usa como tarifa plana por token cuando no se especifica ninguna dimensión. El valor predeterminado es vacío: el seguimiento de costos recurre a tarifas “unknown” y solo se registra el uso de tokens. Ejemplo: pricing = { opus = 15.0, sonnet = 3.0 } O dividido: pricing = { "opus.input" = 15.0, "opus.output" = 75.0 }

Colócalo sobre cualquier superficie:

zeroclaw config set providers.models.custom.<alias>.pricing <value>

export ZEROCLAW_providers__models__custom__<alias>__pricing=

Parámetros JSON adicionales para incluir en las solicitudes a la API. Se fusionan en el nivel superior del cuerpo de la solicitud, lo que permite funciones específicas del proveedor (enrutamiento, transformaciones, etc.) sin cambios en el código. Ejemplo: provider_extra = { model_provider = { only = ["Anthropic"] } }

Colócalo sobre cualquier superficie:

zeroclaw config set providers.models.custom.<alias>.provider_extra <value>

export ZEROCLAW_providers__models__custom__<alias>__provider_extra=

Si debe reproducirse el razonamiento del asistente almacenado en los mensajes salientes del historial del asistente. Some(false) elimina reasoning_content y reasoning antes de enviarlos. None (predeterminado) respeta el valor predeterminado integrado del proveedor (true para la mayoría de los proveedores compatibles, false para Groq).

Colócalo sobre cualquier superficie:

zeroclaw config set providers.models.custom.<alias>.replay_assistant_reasoning <value>

export ZEROCLAW_providers__models__custom__<alias>__replay_assistant_reasoning=

Cuando es verdadero, el cliente toma las credenciales del perfil de autenticación openai-codex almacenado de ZeroClaw en lugar del campo api_key anterior. Importe un inicio de sesión existente de Codex CLI con zeroclaw auth login --model-provider openai-codex --import ~/.codex/auth.json, o ejecute zeroclaw auth login --model-provider openai-codex. Actívelo solo para el model_provider de OpenAI Codex; déjelo desactivado para los model_providers estándar de clave de API.

Colócalo sobre cualquier superficie:

zeroclaw config set providers.models.custom.<alias>.requires_openai_auth <value>

export ZEROCLAW_providers__models__custom__<alias>__requires_openai_auth=

Temperatura de muestreo que se pasa al modelo. Los valores más bajos (0.0–0.3) producen una salida determinista, casi literal, adecuada para código, enrutamiento y resúmenes. Los valores más altos (0.7–1.2) producen una salida más variada, adecuada para conversaciones abiertas.

Colócalo sobre cualquier superficie:

zeroclaw config set providers.models.custom.<alias>.temperature <value>

export ZEROCLAW_providers__models__custom__<alias>__temperature=

Habilita o deshabilita el pensamiento en cadena (chain-of-thought) para los modelos que lo admiten (p. ej., Qwen3, GLM-4). true activa el pensamiento, false lo desactiva. None (predeterminado) deja que el modelo decida. Se envía como enable_thinking en el cuerpo de la solicitud; refleja el campo think del proveedor Ollama.

Colócalo sobre cualquier superficie:

zeroclaw config set providers.models.custom.<alias>.think <value>

export ZEROCLAW_providers__models__custom__<alias>__think=

Tiempo de espera de la solicitud HTTP en segundos. Aumenta este valor para model_providers locales lentos (Ollama en CPU, modelos locales grandes) o redes de alta latencia; déjalo sin configurar en caso contrario.

Colócalo sobre cualquier superficie:

zeroclaw config set providers.models.custom.<alias>.timeout_secs <value>

export ZEROCLAW_providers__models__custom__<alias>__timeout_secs=

Ruta a un certificado de CA codificado en PEM para conexiones TLS a este proveedor. Debe ser una ruta absoluta; no se realiza expansión de shell (p. ej. ~). Déjelo sin configurar para usar el almacén de confianza predeterminado del sistema.

Colócalo sobre cualquier superficie:

zeroclaw config set providers.models.custom.<alias>.tls_ca_cert_path <value>

export ZEROCLAW_providers__models__custom__<alias>__tls_ca_cert_path=

Cómo gestionan los proveedores de chat-completions compatibles de forma nativa los marcadores de imagen en los resultados de role=tool. image_url conserva las partes de imagen estructuradas; omit elimina sus cargas útiles y añade un aviso fijo. Esto no afecta al contenido de imagen directo del usuario ni a los proveedores de OpenAI Responses.

Colócalo sobre cualquier superficie:

zeroclaw config set providers.models.custom.<alias>.tool_result_image_policy <value>

export ZEROCLAW_providers__models__custom__<alias>__tool_result_image_policy=

URI del endpoint al que accede el cliente. Sobrescriba el endpoint predeterminado de la familia cuando apunte a un gateway autoalojado (LiteLLM, vLLM, Ollama), un proxy personalizado o cualquier URL no estándar. Déjelo sin definir para usar el URI predeterminado de la familia desde su implementación de ModelEndpoint. Establezca aquí la URL COMPLETA del endpoint; no existe un campo separado para el sufijo de ruta.

Colócalo sobre cualquier superficie:

zeroclaw config set providers.models.custom.<alias>.uri <value>

export ZEROCLAW_providers__models__custom__<alias>__uri=

Anula la capacidad de visión (entrada de imágenes) del proveedor. None (predeterminado) usa el valor predeterminado integrado de la familia de proveedores. Varias familias (llama.cpp, el endpoint genérico compatible con OpenAI, etc.) asumen capacidad de visión porque pueden servir modelos multimodales. Establece vision = false para un modelo de solo texto servido por dicha familia (p. ej., un LLM de texto detrás de llama.cpp) para que los mensajes de imagen se enruten a un [multimodal] vision_model_provider configurado en lugar de enviarse a un modelo que los rechaza. Some(true) fuerza la activación de visión.

Colócalo sobre cualquier superficie:

zeroclaw config set providers.models.custom.<alias>.vision <value>

export ZEROCLAW_providers__models__custom__<alias>__vision=

Colócalo sobre cualquier superficie:

zeroclaw config set providers.models.custom.<alias>.wire_api <value>

export ZEROCLAW_providers__models__custom__<alias>__wire_api=