Herramientas de código
Configuración del proveedor de TokenLab
Conecta una instancia de OpenClaw autohospedada a TokenLab
Deja que mi agente realice esta configuración
Copia esta tarea a un agente que ya se esté ejecutando en tu computadora:
Read this guide and help me connect OpenClaw to TokenLab:
https://tokenlab.sh/docs/es/guides/tokenlab-provider
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.Esta guía es para OpenClaw autohospedado. El plugin de TokenLab es la configuración más rápida; la configuración manual está disponible cuando necesites un formato de API específico.
Instalar el plugin
Opcional: instala el plugin de proveedor publicado 0.1.3. Proporciona TOKENLAB_API_KEY a través del mismo entorno de Gateway descrito a continuación y utiliza la selección de modelo solo para la sesión. El asistente de incorporación del plugin cambia el modelo predeterminado, por lo que esta guía no ejecuta openclaw onboard. Mantén las entradas y permisos del plugin existentes. Verifica el plugin instalado y la lista de modelos antes de realizar una solicitud.
Revisa las capacidades solicitadas por el instalador y sigue las indicaciones de confirmación del cliente. No otorgues permisos no relacionados ni cambies los permisos de los plugins existentes.
openclaw plugins install @tokenlabai/openclaw-provider@0.1.3
openclaw plugins list
openclaw models list --provider tokenlab/model tokenlab/claude-sonnet-5 -s
/model default -sConfigurar proveedores manualmente
Utiliza models.providers solo cuando OpenClaw necesite formatos de Responses, Claude Messages, Gemini o MiniMax por separado. Para un chat normal, la entrada tokenlab es suficiente.
| Proveedor | api de OpenClaw | 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 semántica /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 de API nativa de Gemini | https://api.tokenlab.sh |
tokenlab-minimax | anthropic-messages | Modelos MiniMax sobre el formato Messages | https://api.tokenlab.sh |
Utiliza el sufijo /v1 solo para openai-completions y openai-responses.
Los proveedores nativos como anthropic-messages y google-generative-ai deben usar https://api.tokenlab.sh sin /v1, de lo contrario, OpenClaw podría construir una ruta de proveedor incorrecta.
Requisitos previos
- Una instancia de OpenClaw autohospedada
- Para OpenClaw 2026.9.4, utiliza Node.js
>=24.16.0 <25 || >=26.1.0(requisitos de versión). Para otras versiones de OpenClaw, verifica los requisitos de esa versión. - Una API Key de TokenLab — Obtenla aquí
Configuración
Edita tu configuración de OpenClaw:
- Autohospedado:
~/.openclaw/openclaw.json
Agrega los proveedores de TokenLab bajo models.providers:
Utiliza el mismo perfil, OPENCLAW_STATE_DIR y OPENCLAW_CONFIG_PATH que el Gateway en ejecución. Haz una copia de seguridad de la configuración activa antes de fusionar. Coloca TOKENLAB_API_KEY en el .env global de confianza o en el entorno de servicio de esa instancia; una exportación de terminal o un .env de proyecto por sí solos podrían no llegar al Gateway en segundo plano. Consulta el manejo de entornos.
Haz una copia de seguridad de la configuración activa. Agrega solo la entrada de TokenLab y conserva los proveedores, cuentas, selección de modelo predeterminado y permisos existentes. Si el nombre ya está en uso, elige otro nombre y actualiza los comandos. Para deshacer la configuración, elimina solo la entrada que agregaste o restaura su copia de seguridad 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-v4-pro", name: "DeepSeek V4 Pro" },
{ 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.6-flash", name: "Gemini 3.6 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" }
]
}
}
}
}Los 5 proveedores utilizan la misma API Key. Solo necesitas una cuenta de TokenLab.
Las matrices models anteriores solo muestran ejemplos comunes. Agrega más IDs de modelos a cada proveedor según sea necesario.
Uso de modelos
OpenClaw sigue haciendo referencia a los modelos con el formato provider/model:
Para OpenClaw 2026.9.4, selecciona el modelo solo para la sesión actual con -s. Mantén agents.defaults.model, los valores predeterminados del agente y los permisos sin cambios. Usa /model default -s para devolver esta sesión a su valor predeterminado configurado.
/model tokenlab-claude/claude-sonnet-5 -s
/model default -sEjemplos de modelos
| Proveedor | Referencia del modelo | Descripción |
|---|---|---|
tokenlab | tokenlab/gpt-5.6-terra | Compatible con OpenAI (Chat Completions) |
tokenlab-responses | tokenlab-responses/gpt-5.6-terra | API de Responses |
tokenlab-claude | tokenlab-claude/claude-sonnet-5 | Claude Messages |
tokenlab-gemini | tokenlab-gemini/gemini-3.6-flash | Gemini |
tokenlab-minimax | tokenlab-minimax/minimax-m3 | MiniMax sobre Messages |
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 de OpenClaw dependa explícitamente de la semántica de OpenAI Responses.tokenlab-claude: úsalo cuando desees el comportamiento nativo de Messages de Claude.tokenlab-gemini: úsalo cuando desees el formato de solicitud/respuesta nativo de Gemini o integraciones existentes al estilo Gemini.tokenlab-minimax: úsalo cuando desees modelos MiniMax sobre el formato Messages.
Si no necesitas el comportamiento nativo de Gemini, aún puedes llamar a los modelos de Gemini a través de tokenlab/gemini-* en el formato compatible con OpenAI.
Errores comunes
Verificar la configuración
Reinicia esa instancia y luego inspecciona su modelo y proveedor seleccionados. models status sin --probe no realiza una prueba de llamada al modelo. Una --probe en vivo o un mensaje de chat pueden consumir tokens. Verifica una respuesta real contra la solicitud de TokenLab correspondiente antes de declarar que la configuración funciona. Para restaurar, elige el modelo anterior y elimina solo las entradas de TokenLab que agregaste.
openclaw gateway restart
openclaw models statusGenerar imágenes y video en el mismo agente
OpenClaw también puede crear imágenes y videos cortos con el servidor MCP de TokenLab. Cada generación se paga con el mismo saldo de TokenLab.
openclaw mcp add tokenlab \
--command npx \
--arg -y \
--arg @tokenlabai/mcp-server@0.6.48 \
--env TOKENLAB_MCP_TOOL_PROFILE=core \
--env 'TOKENLAB_API_KEY=${TOKENLAB_API_KEY}'
openclaw mcp probe tokenlabMantén las comillas simples. OpenClaw almacena una referencia a la variable, no a la clave, y lee TOKENLAB_API_KEY del entorno en el que se ejecuta cuando inicia el servidor. La prueba enumera las herramientas de TokenLab. Luego intenta:
Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.create_video devuelve un ID de tarea. El agente llama a get_task_status hasta que el video esté listo.
Próximos pasos
Una vez que OpenClaw esté conectado, estas guías te ayudarán a utilizar TokenLab de manera más efectiva:
- Formatos de API — comprende las diferencias entre las rutas de OpenAI, Responses, Anthropic y Gemini
- Compatibilidad con IDE / SDK — mira cuándo
/v1/responseses la mejor opción - Manejo de errores — aprende los modos de falla comunes y los patrones de recuperación
- Descripción general de modelos — explora los IDs de modelos antes de integrarlos en los agentes