Configuración del proveedor TokenLab

Dejar que mi agente lo configureCopy Anchor Link

Copia esta tarea en un agente que ya funcione en tu ordenador:

Lee esta guía y ayúdame a conectar OpenClaw con TokenLab:
https://tokenlab.sh/docs/es/guides/tokenlab-provider
Comprueba primero mi versión instalada y la configuración activa.
Conserva las cuentas, los proveedores, los permisos y los demás ajustes existentes.
Haz una copia de seguridad de los archivos locales y muestra los cambios propuestos.
Las claves API necesarias las introduciré localmente; nunca las pidas, muestres ni pegues en el chat.
Comprueba primero que la configuración se carga correctamente.
Explica por separado el coste de cualquier prueba con peticiones de pago antes de ejecutarla.

Recomendado: instala el pluginCopy Anchor Link

Opcional: instala el complemento publicado 0.1.0. Proporciona TOKENLAB_API_KEY en el entorno del Gateway descrito abajo y selecciona el modelo solo para la sesión. El asistente cambia el modelo predeterminado, por lo que esta guía no ejecuta openclaw onboard. Conserva complementos y permisos existentes; comprueba la carga y la lista de modelos antes de enviar una solicitud.

Revisa las capacidades solicitadas por el instalador y sigue sus confirmaciones. No concedas permisos ajenos a la instalación ni cambies los de otros plugins.

openclaw plugins install @tokenlabai/openclaw-provider@0.1.0
openclaw plugins list
openclaw models list --provider tokenlab

/model tokenlab/claude-sonnet-5 -s
/model default -s

npm · GitHub

Configuración manual del proveedorCopy Anchor Link

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.

Requisitos previosCopy Anchor Link

• Una instancia de OpenClaw autohospedada
• OpenClaw 2026.9.4 requiere Node.js >=24.16.0 <25 || >=26.1.0 (requisitos de versión). Para otras versiones de OpenClaw, consulta sus requisitos específicos.
• Una TokenLab API Key — Get one here

ConfiguraciónCopy Anchor Link

Edita tu configuración de OpenClaw:

• Autohospedado: ~/.openclaw/openclaw.json

Agrega los providers de TokenLab bajo models.providers:

Usa el mismo perfil, OPENCLAW_STATE_DIR y OPENCLAW_CONFIG_PATH que el Gateway activo y copia la configuración. Guarda TOKENLAB_API_KEY en su .env global de confianza o entorno de servicio. El export del terminal o .env del proyecto puede no llegar al proceso de fondo. Consulta el entorno.

Haz una copia de la configuración activa. Añade solo la entrada TokenLab y conserva proveedores, cuentas, modelo predeterminado y permisos existentes. Si el nombre ya está usado, elige otro y ajusta los comandos. Para deshacerlo, elimina solo tu entrada o restaura su copia anterior.

{
  models: {
    mode: "merge",
    providers: {
      tokenlab: {
        api: "openai-completions",
        baseUrl: "https://api.tokenlab.sh/v1",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "gpt-5.6-terra", name: "GPT-5.6 Terra" },
          { id: "deepseek-reasoner", name: "DeepSeek Reasoner" },
          { id: "qwen3-coder-flash", name: "Qwen 3 Coder Flash" }
        ]
      },
      "tokenlab-responses": {
        api: "openai-responses",
        baseUrl: "https://api.tokenlab.sh/v1",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "gpt-5.6-terra", name: "GPT-5.6 Terra (Responses)" },
          { id: "gpt-5.2", name: "GPT-5.2 (Responses)" }
        ]
      },
      "tokenlab-claude": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "claude-sonnet-5", name: "Claude Sonnet 5" },
          { id: "claude-opus-5", name: "Claude Opus 5" }
        ]
      },
      "tokenlab-gemini": {
        api: "google-generative-ai",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "${TOKENLAB_API_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: "${TOKENLAB_API_KEY}",
        models: [
          { id: "minimax-m3", name: "MiniMax M3" }
        ]
      }
    }
  }
}

Uso de modelosCopy Anchor Link

OpenClaw sigue referenciando modelos con el formato provider/model:

En OpenClaw 2026.9.4, selecciona el modelo solo para la sesión actual con -s. Conserva agents.defaults.model, los valores predeterminados del agente y los permisos. Usa /model default -s para recuperar el modelo predeterminado en esta sesión.

/model tokenlab-claude/claude-sonnet-5 -s
/model default -s

Ejemplos de modelosCopy Anchor Link

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

Cuándo usar cada proveedorCopy Anchor Link

• 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 comunesCopy Anchor Link

Verificar la configuraciónCopy Anchor Link

Reinicia esa misma instancia y verifica modelo y proveedor. models status sin --probe no prueba una llamada al modelo. Las pruebas reales y mensajes pueden consumir tokens. Compara respuesta y registro TokenLab. Para restaurar, elige el modelo anterior y elimina solo las entradas añadidas.

openclaw gateway restart
openclaw models status

Próximos pasosCopy Anchor Link

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