Configuración del proveedor TokenLab

Esta guía es para usuarios de OpenClaw autohospedado que desean conectar TokenLab como su proveedor de IA.

Recomendado: instala el plugin

Para la ejecución estándar de agentes en OpenClaw, instala el plugin de proveedor de TokenLab:

openclaw plugins install @tokenlabai/openclaw-provider
openclaw onboard --tokenlab-api-key "$TOKENLAB_API_KEY"

El plugin obtiene el catálogo activo de modelos de chat de TokenLab y conserva 18 modelos de respaldo para el descubrimiento sin conexión. Los modelos usan el formato tokenlab/<model-id>. Paquete npm · Ficha en ClawHub · Código fuente

Configuración manual del proveedor

Usa las entradas manuales de models.providers que aparecen a continuación solo cuando necesites rutas independientes para Responses API, Claude nativo, Gemini nativo o MiniMax nativo. Si eliges la configuración manual, configurar únicamente tokenlab es suficiente. Añade los otros providers solo cuando necesites explícitamente el comportamiento de Responses API, Claude nativo, Gemini nativo o MiniMax nativo.

Proveedor	OpenClaw `api`	Ideal para	baseUrl
`tokenlab`	`openai-completions`	GPT, DeepSeek, Qwen y la mayoría de las llamadas compatibles con OpenAI	`https://api.tokenlab.sh/v1`
`tokenlab-responses`	`openai-responses`	Flujos de trabajo de OpenAI Responses que esperan la semántica de `/v1/responses`	`https://api.tokenlab.sh/v1`
`tokenlab-claude`	`anthropic-messages`	API nativa de Claude Messages	`https://api.tokenlab.sh`
`tokenlab-gemini`	`google-generative-ai`	Formato nativo de la API de Gemini	`https://api.tokenlab.sh`
`tokenlab-minimax`	`anthropic-messages`	Enrutamiento nativo de MiniMax	`https://api.tokenlab.sh`

Usa el sufijo /v1 solo para openai-completions y openai-responses.Los providers nativos como anthropic-messages y google-generative-ai deben usar https://api.tokenlab.sh sin /v1, de lo contrario OpenClaw puede construir una ruta upstream incorrecta.

Requisitos previos

Una instancia de OpenClaw autohospedada
Una TokenLab API Key — Get one here

Configuración

Edita tu configuración de OpenClaw:

Autohospedado: ~/.openclaw/openclaw.json

Agrega los providers de TokenLab bajo models.providers:

{
  agents: {
    defaults: {
      model: {
        primary: "tokenlab-claude/claude-sonnet-4-6"
      }
    }
  },
  models: {
    mode: "merge",
    providers: {
      tokenlab: {
        api: "openai-completions",
        baseUrl: "https://api.tokenlab.sh/v1",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "gpt-4o", name: "GPT-4o" },
          { id: "deepseek-r1", name: "DeepSeek R1" },
          { id: "qwen3-coder-flash", name: "Qwen 3 Coder Flash" }
        ]
      },
      "tokenlab-responses": {
        api: "openai-responses",
        baseUrl: "https://api.tokenlab.sh/v1",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "gpt-4o", name: "GPT-4o (Responses)" },
          { id: "gpt-5.2", name: "GPT-5.2 (Responses)" }
        ]
      },
      "tokenlab-claude": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "claude-sonnet-4-6", name: "Claude Sonnet 4.6" },
          { id: "claude-opus-4-6", name: "Claude Opus 4.6" }
        ]
      },
      "tokenlab-gemini": {
        api: "google-generative-ai",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "gemini-3.5-flash", name: "Gemini 3.5 Flash" },
          { id: "gemini-2.5-pro", name: "Gemini 2.5 Pro" }
        ]
      },
      "tokenlab-minimax": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "minimax-m3", name: "MiniMax M3" }
        ]
      }
    }
  }
}

Los 5 providers usan la misma API Key. Solo necesitas una cuenta de TokenLab.

Los arrays models de arriba solo muestran ejemplos comunes. Añade más IDs de modelos a cada provider según sea necesario.

Uso de modelos

OpenClaw sigue referenciando modelos con el formato provider/model:

{
  agents: {
    defaults: {
      model: {
        primary: "tokenlab-gemini/gemini-3.5-flash"
      }
    }
  }
}

Ejemplos de modelos

Proveedor	Referencia del modelo	Descripción
`tokenlab`	`tokenlab/gpt-4o`	Ruta compatible con OpenAI
`tokenlab`	`tokenlab/deepseek-r1`	Modelo de razonamiento DeepSeek
`tokenlab-responses`	`tokenlab-responses/gpt-4o`	Ruta de Responses API
`tokenlab-claude`	`tokenlab-claude/claude-sonnet-4-6`	Ruta nativa de Claude Messages
`tokenlab-gemini`	`tokenlab-gemini/gemini-3.5-flash`	Ruta nativa de Gemini
`tokenlab-minimax`	`tokenlab-minimax/minimax-m3`	Ruta nativa de MiniMax

Explora todos los modelos disponibles en tokenlab.sh/models.

Cuándo usar cada proveedor

tokenlab: elección predeterminada para la mayoría de los casos de uso generales de agentes y chat.
tokenlab-responses: úsalo cuando tu flujo de trabajo en OpenClaw dependa explícitamente de la semántica de OpenAI Responses.
tokenlab-claude: úsalo cuando quieras el comportamiento nativo de Messages de Claude.
tokenlab-gemini: úsalo cuando necesites el formato de request/response nativo de Gemini o integraciones existentes al estilo Gemini.
tokenlab-minimax: úsalo cuando quieras MiniMax en su ruta nativa.

Si no necesitas el comportamiento nativo de Gemini, aún puedes llamar a modelos de Gemini a través de tokenlab/gemini-* en la ruta compatible con OpenAI.

Errores comunes

Aún usando el antiguo array top-level providers

La documentación actual de OpenClaw usa models.providers. Si mantienes el formato anterior del array top-level providers, OpenClaw puede ignorar la configuración o no resolver los prefijos de provider como se espera.

Olvidar /v1 en tokenlab-responses

openai-responses se mapea a la ruta /v1/responses de TokenLab, por lo que tokenlab-responses debe usar https://api.tokenlab.sh/v1.

Agregar /v1 a tokenlab-claude, tokenlab-gemini o tokenlab-minimax

anthropic-messages y google-generative-ai deben usar https://api.tokenlab.sh sin /v1. Agregar /v1 puede producir rutas de solicitud incorrectas.

¿OpenClaw aún soporta Gemini nativo?

Sí. La documentación actual de OpenClaw todavía incluye el provider integrado google y también soporta providers personalizados usando api: "google-generative-ai". Así que tokenlab-gemini sigue siendo una ruta Gemini nativa válida para los usuarios de OpenClaw.

Verificar la configuración

Después de guardar la configuración, reinicia tu instancia de OpenClaw y prueba con un mensaje simple. Si ves una respuesta, el provider está configurado correctamente.

# Autoalojado: reinicia el servicio
systemctl --user restart openclaw    # Linux
launchctl stop cc.tokenlab.openclaw && launchctl start cc.tokenlab.openclaw  # macOS

Próximos pasos

Una vez que OpenClaw esté conectado, estas guías te ayudarán a usar TokenLab de forma más eficaz:

Formatos de API — comprende las diferencias entre las rutas OpenAI, Responses, Anthropic y Gemini
IDE / SDK Compatibility — consulta cuándo /v1/responses es la mejor opción
Manejo de errores — aprende modos de fallo comunes y patrones de recuperación
Resumen de modelos — explora los IDs de modelos antes de integrarlos en los agents

​Recomendado: instala el plugin

​Configuración manual del proveedor

​Requisitos previos

​Configuración

​Uso de modelos

​Ejemplos de modelos

​Cuándo usar cada proveedor

​Errores comunes

​Verificar la configuración

​Próximos pasos

Recomendado: instala el plugin

Configuración manual del proveedor

Requisitos previos

Configuración

Uso de modelos

Ejemplos de modelos

Cuándo usar cada proveedor

Errores comunes

Verificar la configuración

Próximos pasos