Providers
ClawRouter
ClawRouter da a OpenClaw una clave con alcance de política para varios proveedores de modelos ascendentes. El plugin incluido descubre solo los modelos permitidos para esa clave, enruta cada modelo mediante su protocolo declarado e informa el presupuesto y el uso agregado de la clave en las superficies de uso de OpenClaw.
No instalas ni autenticas cada plugin de proveedor ascendente en el host de
OpenClaw. Las credenciales ascendentes y el reenvío específico del proveedor
permanecen en ClawRouter. OpenClaw solo necesita el plugin incluido
@openclaw/clawrouter y una credencial de ClawRouter emitida.
| Propiedad | Valor |
|---|---|
| Proveedor | clawrouter |
| Paquete | @openclaw/clawrouter |
| Autenticación | CLAWROUTER_API_KEY |
| URL predeterminada | https://clawrouter.openclaw.ai |
| Catálogo de modelos | Con alcance de credencial mediante /v1/catalog |
| Cuotas | Presupuesto mensual y uso mediante /v1/usage |
Primeros pasos
Obtén una credencial con alcance
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
export CLAWROUTER_API_KEY="..."openclaw onboard --auth-choice clawrouter-api-keyopenclaw plugins enable clawrouterEl plugin está incluido con OpenClaw. Si tu configuración establece
plugins.allow, agrega clawrouter a esa lista antes de habilitarlo. Para
una implementación personalizada, establece models.providers.clawrouter.baseUrl
en el origen de ClawRouter; el valor predeterminado es
https://clawrouter.openclaw.ai.
Lista los modelos concedidos
openclaw models list --all --provider clawrouterUsa las referencias de modelo devueltas exactamente como se muestran.
Conservan el espacio de nombres ascendente, como clawrouter/openai/...,
clawrouter/anthropic/... o clawrouter/google/.... Si
agents.defaults.models es una lista de permitidos en tu configuración,
agrega cada referencia de ClawRouter seleccionada.
Selecciona un modelo
openclaw models set clawrouter/<provider>/<model>También puedes seleccionar un modelo devuelto para una ejecución con
openclaw agent --model clawrouter/<provider>/<model> --message "...".
Descubrimiento de modelos
GET /v1/catalog es la fuente de verdad. OpenClaw no distribuye una segunda
lista fija de modelos de ClawRouter. Un modelo configurado en ClawRouter aparece cuando:
- la política de la credencial concede su proveedor;
- la conexión del proveedor está habilitada y lista;
- el modelo del catálogo anuncia una capacidad de LLM compatible; y
- el catálogo expone un contrato de transporte compatible con el plugin.
Por lo tanto, agregar otro modelo a un proveedor de ClawRouter compatible no requiere una versión de OpenClaw ni otro plugin de proveedor. La siguiente actualización del catálogo lo descubre. Un modelo que necesita un nuevo protocolo de comunicación requiere compatibilidad en el plugin de ClawRouter antes de que OpenClaw lo anuncie.
Protocolo y plugins de proveedor
No necesitas instalar el plugin de autenticación de cada empresa ascendente. ClawRouter posee las credenciales ascendentes; su catálogo indica a OpenClaw qué transporte usar. El plugin admite:
| Ruta del catálogo | Transporte de OpenClaw |
|---|---|
| Chat compatible con OpenAI | openai-completions |
| Responses compatible con OpenAI | openai-responses |
| Messages nativo de Anthropic | anthropic-messages |
| Streaming nativo de Google Gemini | google-generative-ai |
El plugin también aplica las políticas de repetición y esquema de herramientas correspondientes para esas familias. Las filas del catálogo que usan otro formato de solicitud/stream no se anuncian intencionalmente como modelos de texto de OpenClaw. Normaliza esos proveedores a uno de los contratos compatibles en ClawRouter en lugar de enviar una carga útil incompatible.
Cuotas y uso
La respuesta /v1/usage de ClawRouter alimenta las superficies normales de uso
de proveedores de OpenClaw. /status y el estado relacionado del panel muestran
la ventana de presupuesto mensual cuando la clave tiene un límite, además de los
totales de solicitudes, tokens y gasto. Las claves sin medición siguen mostrando
uso agregado sin una ventana de porcentaje.
La consulta de cuotas usa la misma clave con alcance que el descubrimiento de modelos. Un error en la consulta de cuotas no bloquea la ejecución del modelo.
Consulta la instantánea en vivo con:
openclaw status --usageopenclaw models statusLa misma instantánea del proveedor está disponible para /status en el chat y
la UI de uso de OpenClaw. El presupuesto se aplica a toda la política, por lo
que las solicitudes realizadas por otro cliente que use 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, luego comprueba que la credencial esté activa y conceda al menos un proveedor listo. |
| Falta un modelo configurado de ClawRouter | Inspecciona su capacidad de /v1/catalog y el formato de ruta. Los contratos de transporte no compatibles se filtran intencionalmente. |
Unknown model: clawrouter/... |
Agrega 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 del catálogo o uso |
Vuelve a emitir o cambia el alcance de la credencial de ClawRouter; OpenClaw no recurre a claves de proveedores ascendentes. |
| La llamada al modelo falla tras el descubrimiento | Comprueba la conexión del proveedor y el estado ascendente en ClawRouter, luego reintenta cuando se recupere su estado de disponibilidad. |
| El uso tiene totales pero no porcentaje | La política no tiene medición; agrega un presupuesto mensual en ClawRouter para exponer una ventana de porcentaje. |
Comportamiento de seguridad
- El descubrimiento del catálogo tiene el alcance de la clave de proxy configurada y se almacena en caché por clave.
- La clave de proxy se adjunta solo en el despacho de la solicitud; no se almacena en los metadatos del modelo.
- Los ids de modelos nativos de Anthropic y Gemini se reescriben a sus ids ascendentes solo en el despacho.
- Las filas de catálogo no compatibles o no concedidas fallan de forma cerrada y no se pueden seleccionar.
