clawrouter incluido descubre solo
los modelos permitidos para esa clave, enruta cada modelo mediante su protocolo
declarado e informa el presupuesto de la clave y el uso agregado en las
superficies de uso de OpenClaw.
Las credenciales upstream y el reenvío específico de cada proveedor permanecen en ClawRouter, por lo que
nunca instalas ni autenticas cada plugin de proveedor upstream en el host de
OpenClaw. El plugin se entrega incluido con OpenClaw (enabledByDefault: true);
solo necesitas una credencial emitida de ClawRouter.
| Propiedad | Valor |
|---|---|
| Proveedor | clawrouter |
| Plugin | incluido (incluido en OpenClaw) |
| Auth | CLAWROUTER_API_KEY |
| URL predeterminada | https://clawrouter.openclaw.ai |
| Catálogo de modelos | Con ámbito de credencial mediante /v1/catalog |
| Cuotas | Presupuesto mensual y uso mediante /v1/usage |
Primeros pasos
Obtén una credencial con ámbito
Pide a tu administrador de ClawRouter una credencial cuya política incluya
los proveedores, modelos y presupuesto mensual que debes usar. Las credenciales se
muestran una sola vez cuando se emiten.
Configura OpenClaw
clawrouter está incluido y habilitado de forma predeterminada. Si tu configuración define
plugins.allow, añade clawrouter a esa lista antes de habilitarlo. Para una
implementación personalizada, define models.providers.clawrouter.baseUrl como el
origen de ClawRouter; el valor predeterminado es https://clawrouter.openclaw.ai.Lista los modelos concedidos
clawrouter/openai/gpt-5.5,
clawrouter/anthropic/claude-sonnet-4-6 o
clawrouter/google/gemini-3.5-flash. Si agents.defaults.models es una
lista de permitidos en tu configuración, añade cada referencia seleccionada de ClawRouter.Descubrimiento de modelos
GET /v1/catalog devuelve { providers: [...] }, donde cada entrada de proveedor
lista sus propios models[] (con id upstream, capacidades y precios) y sus
rutas de solicitud admitidas. OpenClaw no entrega una segunda lista fija de
modelos de ClawRouter. Un modelo del catálogo se anuncia como modelo de OpenClaw cuando:
- la política de la credencial concede su proveedor;
- el modelo del catálogo anuncia una capacidad LLM admitida (
llm.responses,llm.chat,llm.messagesollm.streamcon una ruta de streaming coincidente); y - el proveedor expone una ruta coincidente para uno de los transportes siguientes.
Protocolo y plugins de proveedor
ClawRouter posee las credenciales upstream; su catálogo indica a OpenClaw qué transporte usar, por lo que nunca instalas el plugin de autenticación de cada empresa upstream.| Capacidad/ruta del catálogo | Transporte de OpenClaw |
|---|---|
llm.responses (proveedor compatible con OpenAI) | openai-responses |
llm.chat (proveedor compatible con OpenAI) | openai-completions |
llm.messages + ruta anthropic.messages | anthropic-messages |
llm.stream + ruta de streaming google.generate_content | google-generative-ai |
Cuotas y uso
La respuesta/v1/usage de ClawRouter alimenta las superficies normales de uso de proveedor
de OpenClaw: totales de solicitudes, tokens y gasto, además de una ventana de presupuesto mensual cuando
la clave tiene un límite. Las claves sin medición siguen mostrando el uso agregado sin una
ventana porcentual.
La búsqueda de cuota usa la misma clave con ámbito que el descubrimiento de modelos. Un fallo en la
búsqueda de cuota no bloquea la ejecución del modelo.
Consulta la instantánea en vivo con:
/status en el chat y en la
IU de uso de OpenClaw. El presupuesto es para toda la política, por lo que las solicitudes realizadas por otro cliente usando
la misma política de ClawRouter pueden cambiar el porcentaje restante.
Solución de problemas
| Síntoma | Comprobación |
|---|---|
| No hay modelos de ClawRouter | Confirma que el plugin está habilitado y permitido por plugins.allow, y luego comprueba que la credencial esté activa y conceda al menos un proveedor listo. |
| Falta un modelo de ClawRouter configurado | Inspecciona su capacidad y compatibilidad de rutas de /v1/catalog. Los contratos de transporte no admitidos se filtran intencionalmente. |
Unknown model: clawrouter/... | Añade la referencia exacta del catálogo a agents.defaults.models cuando ese mapa de configuración se use como lista de permitidos. |
401 o 403 desde el catálogo o uso | Reemite o vuelve a definir el ámbito de la credencial de ClawRouter; OpenClaw no recurre a claves de proveedor upstream. |
| La llamada al modelo falla después del descubrimiento | Comprueba la conexión del proveedor y el estado del upstream en ClawRouter, y vuelve a intentarlo después de que se recupere su estado de disponibilidad. |
| El uso tiene totales pero no porcentaje | La política no tiene medición; añade un presupuesto mensual en ClawRouter para exponer una ventana porcentual. |
Comportamiento de seguridad
- El descubrimiento del catálogo está limitado a la clave proxy configurada y se almacena en caché por ámbito de credencial (directorio del agente, directorio del workspace, id de perfil de autenticación y URL base).
- La clave proxy se adjunta solo al despachar solicitudes; no se almacena en los metadatos del modelo.
- Los ids de modelos nativos de Anthropic y Gemini se reescriben a sus ids upstream solo al despachar.
- Las filas de catálogo no admitidas o no concedidas fallan de forma cerrada y no son seleccionables.
Relacionado
Proveedores de modelos
Configuración de proveedores y selección de modelos.
Seguimiento de uso
Superficies de uso y estado de OpenClaw.