Tutorial completo para conectar Moltbot a una estación de relevo API: 5 pasos para configurar una interfaz compatible con OpenAI y ahorrar un 60% de costos

Moltbot usa por defecto la API oficial de Anthropic, pero esta presenta problemas como restricciones de acceso y precios elevados. En este artículo te explicaremos detalladamente cómo configurar Moltbot para conectarlo a una estación intermedia de API, utilizando servicios de terceros mediante el modo openai-compatible.

Valor principal: Al terminar de leer este artículo, sabrás cómo configurar Moltbot para usar una estación intermedia de API, logrando una experiencia de asistente de IA más económica y estable.

Puntos clave de la configuración de la estación intermedia de API en Moltbot

Antes de empezar, es importante entender el mecanismo de configuración de API de Moltbot y las ventajas de usar una estación intermedia.

Comparativa de métodos de configuración en Moltbot

Preparativos para la configuración del proxy de la API de Moltbot

Paso 1: Confirmar que Moltbot esté instalado

Primero, asegúrate de tener instalado Moltbot:

# Verificar la versión de Moltbot
moltbot --version

# Si no está instalado, ejecuta la instalación
npm install -g moltbot@latest

Requisitos del sistema: Node.js >= 22

Paso 2: Obtener la clave del proxy de la API

Necesitarás obtener una API Key del proxy de la API.

🚀 Inicio rápido: Recomendamos usar APIYI (apiyi.com) para obtener tu clave de API. Al registrarte recibirás saldo gratuito de regalo. Es compatible con los modelos principales como Claude Sonnet 4, Claude Opus 4.5, GPT-4o, etc., con precios entre un 40% y 60% más bajos que los oficiales.

Una vez que obtengas la clave, anota la siguiente información:

Método 1: Configuración mediante el archivo config.json

Este es el método de configuración más recomendado, ya que se configura una sola vez y los cambios son permanentes.

Ubicar el archivo de configuración de Moltbot

El archivo de configuración de Moltbot suele encontrarse en:

También puedes encontrarlo mediante comandos:

# Ver la configuración actual
moltbot config list

# Ver la ruta del archivo de configuración
moltbot config path

Editar config.json para configurar el proxy de la API

Abre el archivo de configuración y añade o modifica la sección models.providers:

{
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-your-api-key-here",
        "api": "openai-completions",
        "authHeader": true,
        "models": [
          {
            "id": "claude-sonnet-4-20250514",
            "name": "Claude Sonnet 4",
            "contextWindow": 200000,
            "maxTokens": 64000
          },
          {
            "id": "claude-opus-4-5-20251101",
            "name": "Claude Opus 4.5",
            "contextWindow": 200000,
            "maxTokens": 32000
          },
          {
            "id": "gpt-4o",
            "name": "GPT-4o",
            "contextWindow": 128000,
            "maxTokens": 16384
          }
        ]
      }
    }
  },
  "agent": {
    "model": {
      "primary": "apiyi/claude-sonnet-4-20250514",
      "fallbacks": ["apiyi/claude-opus-4-5-20251101", "apiyi/gpt-4o"]
    }
  }
}

Detalle de los parámetros de configuración

Método 2 de configuración de Moltbot con el proxy de API: Formato YAML

Si prefieres el formato YAML, Moltbot también admite el archivo config.yaml:

# ~/.moltbot/config.yaml
models:
  providers:
    apiyi:
      baseUrl: "https://api.apiyi.com/v1"
      apiKey: "sk-your-api-key-here"
      api: openai-completions
      authHeader: true
      models:
        - id: claude-sonnet-4-20250514
          name: Claude Sonnet 4
          contextWindow: 200000
          maxTokens: 64000
        - id: claude-opus-4-5-20251101
          name: Claude Opus 4.5
          contextWindow: 200000
          maxTokens: 32000

agent:
  model:
    primary: apiyi/claude-sonnet-4-20250514
    fallbacks:
      - apiyi/claude-opus-4-5-20251101
      - apiyi/gpt-4o

Versión simplificada de la configuración YAML

Si solo necesitas usar un único modelo, puedes optar por una configuración más sencilla:

# ~/.moltbot/config.yaml - Versión mínima
llm:
  provider: openai-compatible
  model: claude-sonnet-4-20250514
  apiKey: sk-your-api-key-here
  baseUrl: https://api.apiyi.com/v1

🎯 Consejo técnico: Te recomiendo usar la configuración completa; esto te permite definir múltiples modelos y estrategias de respaldo (fallback), lo que mejora mucho la estabilidad del servicio. A través de APIYI (apiyi.com), puedes centralizar el acceso a varios modelos como Claude, GPT y Gemini a la vez.

Método 3 de configuración de Moltbot con el proxy de API: Variables de entorno

Este método es ideal para pruebas rápidas o entornos de CI/CD:

# Configurar las variables de entorno
export MOLTBOT_LLM_PROVIDER="openai-compatible"
export MOLTBOT_LLM_MODEL="claude-sonnet-4-20250514"
export MOLTBOT_LLM_API_KEY="sk-your-api-key-here"
export MOLTBOT_LLM_BASE_URL="https://api.apiyi.com/v1"

# Iniciar Moltbot
moltbot gateway start

O también puedes configurarlas en un archivo .env:

# ~/.moltbot/.env
MOLTBOT_LLM_PROVIDER=openai-compatible
MOLTBOT_LLM_MODEL=claude-sonnet-4-20250514
MOLTBOT_LLM_API_KEY=sk-your-api-key-here
MOLTBOT_LLM_BASE_URL=https://api.apiyi.com/v1

Método 4 de configuración de la estación de enlace de la API de Moltbot: Configuración por línea de comandos

Configura rápidamente mediante el comando moltbot config set:

# Configurar la estación de enlace de la API
moltbot config set models.providers.apiyi.baseUrl "https://api.apiyi.com/v1"
moltbot config set models.providers.apiyi.apiKey "sk-tu-clave-api-aqui"
moltbot config set models.providers.apiyi.api "openai-completions"

# Establecer el modelo por defecto
moltbot config set agent.model.primary "apiyi/claude-sonnet-4-20250514"

# Verificar la configuración
moltbot config list

Script de configuración por lotes

Crea un script de configuración para completar todos los ajustes en un solo paso:

#!/bin/bash
# setup-apiyi.sh - Script de configuración de la estación de enlace APIYI de Moltbot

API_KEY="sk-tu-clave-api-aqui"
BASE_URL="https://api.apiyi.com/v1"

echo "Configurando la estación de enlace de la API de Moltbot..."

# Configurar el proveedor
moltbot config set models.providers.apiyi.baseUrl "$BASE_URL"
moltbot config set models.providers.apiyi.apiKey "$API_KEY"
moltbot config set models.providers.apiyi.api "openai-completions"
moltbot config set models.providers.apiyi.authHeader true

# Establecer el modelo por defecto
moltbot config set agent.model.primary "apiyi/claude-sonnet-4-20250514"

# Reiniciar el gateway
moltbot gateway restart

echo "¡Configuración completada! Usa 'moltbot doctor' para verificar la configuración"

Verificación de la configuración de la estación de enlace de la API de Moltbot

Una vez finalizada la configuración, es necesario verificar que todo sea correcto.

Comprobación con moltbot doctor

# Ejecutar diagnóstico
moltbot doctor

# Reparar problemas automáticamente
moltbot doctor --fix

Ejemplo de salida normal:

✓ Gateway running on port 18789
✓ Model provider 'apiyi' configured
✓ API key validated
✓ Model 'claude-sonnet-4-20250514' available
✓ Connection test passed

Enviar un mensaje de prueba

# Probar la conexión a la API
moltbot test-llm --provider apiyi --model claude-sonnet-4-20250514

# Enviar un mensaje de prueba
moltbot chat "Hola, preséntate por favor"

Comprobar los registros de llamadas a la API

# Ver registros en tiempo real
moltbot logs --follow

# Ver las últimas 10 llamadas a la API
moltbot logs --filter api-call --last 10

Lista de modelos compatibles con el proxy API de Moltbot

A través del proxy de APIYI, puedes utilizar los siguientes modelos en Moltbot:

Modelos de la serie Claude

Modelos de la serie OpenAI

Modelos de la serie Google

💡 Sugerencia de elección: Para el uso diario de Moltbot, te recomendamos Claude Sonnet 4, ya que logra un equilibrio excelente entre rendimiento y costo. Puedes consultar la lista completa de modelos y sus precios en tiempo real en APIYI (apiyi.com).

Configuración avanzada del proxy de la API de Moltbot

Configuración de la estrategia de Fallback

Cuando el modelo principal no esté disponible, cambia automáticamente al modelo de respaldo:

{
  "agent": {
    "model": {
      "primary": "apiyi/claude-sonnet-4-20250514",
      "fallbacks": [
        "apiyi/claude-3-5-sonnet-20241022",
        "apiyi/gpt-4o"
      ],
      "fallbackStrategy": "sequential"
    }
  }
}

Configuración de reglas de enrutamiento de modelos

Selecciona automáticamente el mejor modelo según el tipo de tarea:

{
  "agent": {
    "modelRouting": {
      "coding": "apiyi/claude-sonnet-4-20250514",
      "reasoning": "apiyi/claude-opus-4-5-20251101",
      "quick": "apiyi/claude-3-5-haiku-20241022",
      "default": "apiyi/claude-sonnet-4-20250514"
    }
  }
}

Configuración de límites de costos

Evita gastos excesivos inesperados:

{
  "agent": {
    "limits": {
      "maxTokensPerRequest": 32000,
      "maxRequestsPerHour": 100,
      "maxCostPerDay": 10.00
    }
  }
}

Preguntas frecuentes sobre el proxy de la API de Moltbot

# Validar API Key
curl -H "Authorization: Bearer sk-your-key" https://api.apiyi.com/v1/models

moltbot config set agent.model.primary "apiyi/claude-opus-4-5-20251101"
moltbot gateway restart

moltbot chat --model apiyi/gpt-4o "Hola"

{
  "agent": {
    "model": {
      "primary": "apiyi/claude-sonnet-4-20250514",
      "fallbacks": ["openrouter/anthropic/claude-3.5-sonnet"]
    }
  }
}

# Ver estadísticas locales
moltbot stats --period today

# Ver uso detallado
moltbot stats --detailed --period week

Resolución de problemas de configuración de la estación puente de la API de Moltbot

Errores comunes y soluciones

Modo de depuración

Activa los registros detallados para que te ayuden a identificar problemas:

# Activar modo de depuración
export MOLTBOT_DEBUG=true
moltbot gateway start

# O usa parámetros de línea de comandos
moltbot gateway start --debug --log-level verbose

Comandos de verificación de configuración

# Validar la sintaxis de la configuración
moltbot config validate

# Probar la conexión con la API
moltbot test-connection --provider apiyi

# Realizar un chequeo de salud (health check) completo
moltbot doctor --verbose

Comparativa: Estación puente de la API de Moltbot vs. API oficial

🎯 Sugerencia de selección: Para los usuarios que necesitan soporte multimodelo y mayor estabilidad, recomendamos acceder a Moltbot a través de APIYI (apiyi.com). No solo el precio es más competitivo, sino que también obtendrás un servicio más estable y soporte técnico especializado.

Resumen: Repaso de los puntos clave para configurar el proxy de API en Moltbot

Con este tutorial, has aprendido el método completo para conectar Moltbot a un proxy de API:

1. Preparativos: Instalar Moltbot y obtener la API Key de APIYI (apiyi.com).
2. Archivo de configuración: Editar config.json o config.yaml para añadir la configuración del proveedor (provider).
3. Parámetros clave: baseUrl, apiKey, tipo de api y lista de modelos.
4. Verificación y pruebas: Usar moltbot doctor y comandos de prueba para confirmar que la configuración es correcta.
5. Funciones avanzadas: Estrategias de fallback, enrutamiento de modelos y límites de costes.

Te recomendamos obtener tu clave de API a través de APIYI (apiyi.com) para disfrutar de precios más bajos y un servicio más estable, permitiendo que tu asistente Moltbot rinda al máximo.

Referencias

1. Documentación oficial de configuración de Moltbot: Referencia de configuración del Gateway

   • Enlace: docs.molt.bot/gateway/configuration

2. Ejemplos de configuración de Moltbot: Plantillas de configuración para diversos escenarios

   • Enlace: docs.molt.bot/gateway/configuration-examples

3. Proveedores de modelos en Moltbot: Detalles sobre la configuración de providers

   • Enlace: docs.molt.bot/concepts/model-providers

4. GitHub de Moltbot: Código fuente del proyecto e Issues

   • Enlace: github.com/moltbot/moltbot

5. Guía de inicio de Moltbot: Tutorial de inicio rápido

   • Enlace: docs.molt.bot/start/getting-started

📝 Autor: APIYI Team
🔗 Soporte técnico: Si necesitas una clave de API o ayuda técnica, no dudes en visitar APIYI (apiyi.com).