Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Descripción general

Para las versiones actuales de OpenClaw, el enfoque recomendado es configurar TokenLab a través de models.providers. Si solo quieres comenzar rápidamente, 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.
ProveedorOpenClaw apiIdeal parabaseUrl
tokenlabopenai-completionsGPT, DeepSeek, Qwen y la mayoría de las llamadas compatibles con OpenAIhttps://api.tokenlab.sh/v1
tokenlab-responsesopenai-responsesFlujos de trabajo de OpenAI Responses que esperan la semántica de /v1/responseshttps://api.tokenlab.sh/v1
tokenlab-claudeanthropic-messagesAPI nativa de Claude Messageshttps://api.tokenlab.sh
tokenlab-geminigoogle-generative-aiFormato nativo de la API de Geminihttps://api.tokenlab.sh
tokenlab-minimaxanthropic-messagesEnrutamiento nativo de MiniMaxhttps://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-32b", name: "Qwen 3 32B" }
        ]
      },
      "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-2.5-flash", name: "Gemini 2.5 Flash" },
          { id: "gemini-3-flash-preview", name: "Gemini 3 Flash Preview" }
        ]
      },
      "tokenlab-minimax": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "minimax-m1", name: "MiniMax M1" }
        ]
      }
    }
  }
}
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-2.5-flash"
      }
    }
  }
}

​
Ejemplos de modelos

ProveedorReferencia del modeloDescripción
tokenlabtokenlab/gpt-4oRuta compatible con OpenAI
tokenlabtokenlab/deepseek-r1Modelo de razonamiento DeepSeek
tokenlab-responsestokenlab-responses/gpt-4oRuta de Responses API
tokenlab-claudetokenlab-claude/claude-sonnet-4-6Ruta nativa de Claude Messages
tokenlab-geminitokenlab-gemini/gemini-2.5-flashRuta nativa de Gemini
tokenlab-minimaxtokenlab-minimax/minimax-m1Ruta 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

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.
openai-responses se mapea a la ruta /v1/responses de TokenLab, por lo que tokenlab-responses debe usar https://api.tokenlab.sh/v1.
anthropic-messages y google-generative-ai deben usar https://api.tokenlab.sh sin /v1. Agregar /v1 puede producir rutas de solicitud incorrectas.
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: