OpenClaw es un framework popular para el desarrollo de agentes que permite a los desarrolladores integrar y utilizar una variedad de modelos de lenguaje grandes (LLMs). Si deseas que OpenClaw acceda a estos modelos a través de la plataforma Taotoken, la configuración es un proceso sencillo. A continuación, te guiamos a través de dos métodos principales para lograr esta integración: utilizando la herramienta CLI oficial de Taotoken o editando manualmente los archivos de configuración.

1. Requisitos Previos: Obtener Clave API y ID de Modelo de Taotoken

Antes de comenzar, necesitarás dos datos esenciales de la plataforma Taotoken: tu Clave API (API Key) y el identificador del modelo (Model ID) que deseas utilizar.

Accede a tu cuenta en la plataforma Taotoken. En la sección de "API Keys" de tu panel de control, podrás generar una nueva clave API. Guarda esta clave de forma segura, ya que servirá como credencial de autenticación.

Posteriormente, navega a la sección "Model Marketplace" en la plataforma Taotoken. Aquí podrás explorar y seleccionar los modelos disponibles. Cada modelo tiene un identificador único, como claude-sonnet-4-6 o gpt-4o. Anota el ID del modelo que prefieras para usarlo en la configuración.

2. Configuración Rápida con la CLI de Taotoken (Recomendado)

Para una configuración rápida y sin complicaciones, se recomienda el uso de la herrameinta CLI (Command Line Interface) proporcionada por Taotoken. Esta herramienta automatiza gran parte del proceso de configuración.

Primero, instala la herramienta CLI. Puedes hacerlo globalmente a través de npm o ejecutarla directamente con npx sin necesidad de instalación previa.

# Opción 1: Instalación global
npm install -g @taotoken/taotoken

# Opción 2: Ejecución con npx (sin instalación)
npx @taotoken/taotoken

Una vez instalada, ejecuta el comando taotoken en tu terminal. La herramienta te presentará un menú interactivo donde podrás seleccionar la opción para OpenClaw (puede aparecer como "OpenClaw" o "oc"). Sigue las indicaciones para ingresar tu Clave API y el ID del modelo previamente obtenidos. La herramienta se encargará de escribir la configuración adecuada.

Si prefieres usar parámetros directos en la línea de comandos, puedes emplear subcomandos. A continuación, se muestra un ejemplo. Asegúrate de reemplazar <tu_clave_api> y <tu_id_modelo> con tus datos reales.

taotoken openclaw --key <tu_clave_api> --model <tu_id_modelo>
# O la versión abreviada:
taotoken oc -k <tu_clave_api> -m <tu_id_modelo>

Tras ejecutar este comando, la CLI configurará automáticamente el baseUrl a https://taotoken.net/api/v1 y establecerá el modelo predeterminado en el formato taotoken/<tu_id_modelo>. Para detalles específicos sobre dónde se guarda la configuración y la lógica exacta, consulta la salida de la herramienta o su documentación oficial.

3. Edición Manual del Archivo de Configuración de OpenClaw

Si deseas tener un control más detallado sobre el proceso de configuración o si tienes requisitos específicos para tu entorno, la edición manual de los archivos de configuración es una alternativa directa. En OpenClaw, estos archivos suelen encontrarse en el directorio config o .openclaw en la raíz de tu proyecto, y pueden tener nombres como providers.yaml o config.json.

Debes localizar la sección que define los proveedores de modelos. El paso clave es configurar el tipo de proveedor como custom y especificar correctamente el endpoint de la API de Taotoken.

A continuación, se presenta un fragmento de configuración de ejemplo que ilustra los parámetros esenciales:

# Ejemplo: Fragmento de configuración en providers.yaml
providers:
  custom:
    base_url: "https://taotoken.net/api/v1"
    api_key: "sk-TuClaveAPITaotokenReal"
    default_model: "taotoken/claude-sonnet-4-6"

Presta atención a los siguientes puntos:

• Tipo de Proveedor (provider type): Debe ser custom para poder utilizar un endpoint de API personalizado.
• URL Base (base_url): Este es el parámetro más crítico. Debe ser exactamente https://taotoken.net/api/v1. El sufijo /v1 es parte de la ruta de la API compatible con OpenAI y es indispensable.
• Clave API (api_key): Ingresa la Clave API que generaste en el panel de control de Taotoken.
• Formato del Modelo: Al especificar el modelo, generalmente se requiere prefijar el ID del modelo con taotoken/, por ejemplo, taotoken/claude-sonnet-4-6. Esto ayuda al framework a identificar la procedencia del modelo. Consulta la documentación oficial de OpenClaw o las guías de integración de Taotoken para confirmar el formato exacto.

Después de guardar los cambios en el archivo de configuración, reinicia tu aplicación OpenClaw. Ahora debería ser capaz de comunicarse con la plataforma Taotoken para acceder a los modelos.

4. Verificación de la Configuración y Pasos Siguientes

Una vez completada la configuración, es recomendable ejecutar una tarea de prueba simple para verificar que la conexión funciona correctamente. Puedes crear un agente básico que interactúe con un modelo y observar si recibes una respuesta exitosa.

Si encuentras errores de conexión o problemas para que el modelo sea reconocido, sigue estos pasos para la depuración:

• Verifica la Clave API: Asegúrate de que la clave ingresada sea correcta y no haya expirado.
• Confirma la URL Base: Comprueba que el valor de base_url sea https://taotoken.net/api/v1. Este es un error de configuración muy común.
• Valida el ID del Modelo: Revisa la ortografía del ID del modelo en la página del marketplace de Taotoken.
• Consulta los Registros (Logs): Examina los logs de ejecución de OpenClaw, ya que suelen contener información detallada sobre los errores.

Con una configuración exitosa, podrás utilizar OpenClaw para llamar a diversos LLMs disponibles en Taotoken, simplificando la gestión de múltiples proveedores. Para funcionalidades avanzadas, como el cambio dinámico de modelos en tiempo de ejecución o la gestión de cuotas de uso, consulta la documentación de la API de Taotoken y las guías de uso de OpenClaw.

Esperamos que esta guía te sea útil para completar la configuración. Para obtener más detalles e información sobre los modelos soportados, visita la plataforma oficial de Taotoken.