Configuración del proxy de API de MoltBot: Tutorial completo de 3 pasos para integrar Claude Opus y múltiples modelos

¿Quieres conectar MoltBot a Claude Opus 4.5 u otros modelos de lenguaje grandes, pero no sabes cómo configurar el proxy de la API? Este artículo te enseñará paso a paso cómo completar la configuración de múltiples proveedores (Multi-Provider) de MoltBot, permitiendo que tu asistente de IA se conecte a varios servicios de modelos simultáneamente para lograr un cambio inteligente y respaldo ante fallos (failover).

Valor central: Al terminar de leer, dominarás el método de configuración models.providers de MoltBot, aprenderás a establecer modelos principales, modelos de respaldo y alias de modelos para crear un asistente de IA estable y confiable.

Configuración del Proxy de API de MoltBot: Análisis de Conceptos Clave

MoltBot permite el acceso a casi todos los servicios de modelos de lenguaje grandes (LLM) convencionales a través de la API compatible con OpenAI. Entender los siguientes conceptos clave es fundamental para una configuración exitosa.

Sistema de archivos de configuración de MoltBot

Campos clave de la configuración de Proveedores de MoltBot

Cada configuración de Proveedor (Provider) contiene los siguientes campos clave:

Descripción de los tipos de protocolo de API

MoltBot admite dos protocolos principales compatibles con OpenAI:

🎯 Sugerencia de configuración: La mayoría de los servicios de proxy de API (como APIYI apiyi.com) utilizan el protocolo openai-completions. Si estás utilizando una implementación local como LM Studio u Ollama, necesitarás usar openai-responses.

Configuración Multi-Provider de MoltBot: Ejemplo completo

A continuación, presentamos un ejemplo real de configuración multi-provider que conecta simultáneamente los servicios de APIYI y Qwen Portal:

Ejemplo de archivo de configuración completo

{
  "models": {
    "providers": {
      "qwen-portal": {
        "baseUrl": "https://portal.qwen.ai/v1",
        "apiKey": "${QWEN_API_KEY}",
        "api": "openai-completions",
        "models": [
          { "id": "coder-model", "name": "Qwen Coder", "contextWindow": 128000 },
          { "id": "vision-model", "name": "Qwen Vision", "contextWindow": 128000 }
        ]
      },
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "${APIYI_API_KEY}",
        "api": "openai-completions",
        "models": [
          { "id": "claude-opus-4-5-20251101", "name": "Claude Opus 4.5", "contextWindow": 200000 },
          { "id": "claude-sonnet-4-20250514", "name": "Claude Sonnet 4", "contextWindow": 200000 },
          { "id": "gpt-4o", "name": "GPT-4o", "contextWindow": 128000 }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "apiyi/claude-opus-4-5-20251101",
        "fallbacks": ["qwen-portal/vision-model"]
      },
      "models": {
        "apiyi/claude-opus-4-5-20251101": { "alias": "opus" },
        "apiyi/claude-sonnet-4-20250514": { "alias": "sonnet" },
        "qwen-portal/coder-model": { "alias": "qwen" }
      }
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "${TELEGRAM_BOT_TOKEN}"
    }
  }
}

Desglose de la estructura de configuración

1. Sección models.providers

Esta es la parte central donde se definen los servicios proxy de la API:

"providers": {
  "apiyi": {
    "baseUrl": "https://api.apiyi.com/v1",
    "apiKey": "${APIYI_API_KEY}",
    "api": "openai-completions",
    "models": [...]
  }
}

• Provider ID (apiyi): Identificador de servicio personalizado, se utiliza para referencias posteriores.
• baseUrl: Punto de enlace (endpoint) de la API, debe terminar en /v1.
• apiKey: Permite introducirla directamente o usar variables de entorno tipo ${ENV_VAR}.
• models: Lista de modelos compatibles con este proveedor.

2. Sección agents.defaults.model

Define el modelo predeterminado y la estrategia de recuperación ante fallos (failover):

"model": {
  "primary": "apiyi/claude-opus-4-5-20251101",
  "fallbacks": ["qwen-portal/vision-model"]
}

• primary: Modelo principal, con formato provider-id/model-id.
• fallbacks: Matriz de modelos de respaldo; el sistema cambia automáticamente si el modelo principal falla.

3. Sección agents.defaults.models

Define alias para los modelos, facilitando el cambio rápido:

"models": {
  "apiyi/claude-opus-4-5-20251101": { "alias": "opus" },
  "qwen-portal/coder-model": { "alias": "qwen" }
}

Tras configurar los alias, puedes usar el comando /model opus en la conversación para cambiar de modelo rápidamente.

Configuración del proxy de API de MoltBot: tutorial paso a paso

Paso 1: Obtener la clave API (API Key)

Antes de realizar la configuración, necesitas tener preparadas tus claves API:

🚀 Inicio rápido: Se recomienda usar APIYI apiyi.com como proveedor principal. Una sola clave API te permite llamar a los modelos más importantes como Claude, GPT y Gemini, sin necesidad de registrarte en múltiples plataformas por separado.

Paso 2: Configurar las variables de entorno

Por motivos de seguridad, se recomienda utilizar variables de entorno para almacenar las claves API:

# Linux/macOS - añadir a ~/.bashrc o ~/.zshrc
export APIYI_API_KEY="sk-your-apiyi-key"
export QWEN_API_KEY="your-qwen-key"
export TELEGRAM_BOT_TOKEN="your-telegram-token"

# Aplicar los cambios en la configuración
source ~/.bashrc

# Windows PowerShell
$env:APIYI_API_KEY = "sk-your-apiyi-key"
$env:QWEN_API_KEY = "your-qwen-key"
$env:TELEGRAM_BOT_TOKEN = "your-telegram-token"

Paso 3: Editar el archivo de configuración

Abre o crea el archivo de configuración de MoltBot:

# Abrir el archivo de configuración
nano ~/.moltbot/moltbot.json

# O usar VS Code
code ~/.moltbot/moltbot.json

Pega la siguiente configuración en el archivo:

{
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "${APIYI_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-opus-4-5-20251101",
            "name": "Claude Opus 4.5",
            "contextWindow": 200000
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "apiyi/claude-opus-4-5-20251101"
      }
    }
  }
}

Paso 4: Verificar la configuración

Reinicia MoltBot y verifica si la configuración se ha aplicado correctamente:

# Reiniciar MoltBot
moltbot restart

# Comprobar la configuración de modelos actual
moltbot models list

# Probar la llamada al modelo
moltbot chat "Hola, por favor dime qué modelo eres"

{
  "models": {
    "mode": "merge",
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "${APIYI_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-opus-4-5-20251101",
            "name": "Claude Opus 4.5",
            "contextWindow": 200000,
            "maxTokens": 32000
          },
          {
            "id": "claude-sonnet-4-20250514",
            "name": "Claude Sonnet 4",
            "contextWindow": 200000,
            "maxTokens": 64000
          },
          {
            "id": "gpt-4o",
            "name": "GPT-4o",
            "contextWindow": 128000,
            "maxTokens": 16384
          },
          {
            "id": "gemini-2.5-pro",
            "name": "Gemini 2.5 Pro",
            "contextWindow": 1000000,
            "maxTokens": 65536
          }
        ]
      },
      "qwen-portal": {
        "baseUrl": "https://portal.qwen.ai/v1",
        "apiKey": "${QWEN_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "coder-model",
            "name": "Qwen Coder",
            "contextWindow": 128000
          },
          {
            "id": "vision-model",
            "name": "Qwen Vision",
            "contextWindow": 128000
          }
        ]
      },
      "local-ollama": {
        "baseUrl": "http://localhost:11434/v1",
        "apiKey": "ollama-local",
        "api": "openai-responses",
        "models": [
          {
            "id": "llama3.3:70b",
            "name": "Llama 3.3 70B",
            "contextWindow": 128000
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "apiyi/claude-opus-4-5-20251101",
        "fallbacks": [
          "apiyi/claude-sonnet-4-20250514",
          "qwen-portal/vision-model",
          "local-ollama/llama3.3:70b"
        ]
      },
      "models": {
        "apiyi/claude-opus-4-5-20251101": {
          "alias": "opus",
          "params": { "temperature": 0.7 }
        },
        "apiyi/claude-sonnet-4-20250514": {
          "alias": "sonnet",
          "params": { "temperature": 0.5 }
        },
        "apiyi/gpt-4o": {
          "alias": "gpt"
        },
        "qwen-portal/coder-model": {
          "alias": "qwen"
        },
        "local-ollama/llama3.3:70b": {
          "alias": "llama"
        }
      },
      "imageModel": "apiyi/gpt-4o"
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "${TELEGRAM_BOT_TOKEN}"
    },
    "discord": {
      "enabled": false,
      "token": "${DISCORD_BOT_TOKEN}"
    }
  }
}

💡 Truco de configuración: El uso de "mode": "merge" te permite conservar la configuración de modelos integrada de MoltBot mientras añades tus proveedores personalizados. De esta manera, si tus servicios personalizados no están disponibles, el sistema puede recurrir a la configuración predeterminada.

Configuración de modelos en MoltBot: parámetros avanzados detallados

Campos completos de la entrada de modelo

Configuración de parámetros del modelo (params)

En agents.defaults.models puedes establecer parámetros predeterminados para cada modelo:

"models": {
  "apiyi/claude-opus-4-5-20251101": {
    "alias": "opus",
    "params": {
      "temperature": 0.7,
      "maxTokens": 16000
    }
  }
}

⚠️ Nota: temperature es un parámetro avanzado. A menos que conozcas la configuración predeterminada del modelo y realmente necesites ajustarla, se recomienda no modificarla.

Configuración de Fallback y Redundancia de MoltBot

El mecanismo de Fallback es una característica clave de MoltBot que garantiza que el asistente de IA esté siempre disponible.

Cómo funciona el Fallback

Petición del usuario
    ↓
Modelo principal (primary)
    ↓ (Fallo)
Modelo de respaldo 1 (fallbacks[0])
    ↓ (Fallo)
Modelo de respaldo 2 (fallbacks[1])
    ↓ (Fallo)
... seguir intentando

Estrategias recomendadas de configuración de Fallback

Configuración recomendada:

"model": {
  "primary": "apiyi/claude-opus-4-5-20251101",
  "fallbacks": [
    "apiyi/claude-sonnet-4-20250514",
    "apiyi/gpt-4o",
    "qwen-portal/vision-model"
  ]
}

💰 Optimización de costes: Al configurar el Fallback a través de APIYI (apiyi.com), puedes alternar automáticamente entre múltiples modelos mientras disfrutas de un sistema de facturación unificado, lo que facilita el control de costes.

Cambio de modelo en MoltBot: Consejos prácticos

Uso de alias para cambios rápidos

Una vez configurados los alias, puedes cambiar de modelo en cualquier momento durante la conversación:

Tú: /model opus
MoltBot: Se ha cambiado a Claude Opus 4.5

Tú: /model sonnet
MoltBot: Se ha cambiado a Claude Sonnet 4

Tú: /model qwen
MoltBot: Se ha cambiado a Qwen Coder

Especificar un modelo para tareas concretas

Tú: /model gpt ayúdame a analizar esta imagen
MoltBot: [Analizando imagen con GPT-4o...]

Tú: /model opus escribe un artículo técnico profundo
MoltBot: [Escribiendo con Claude Opus...]

Ver el estado actual del modelo

# Ver en la línea de comandos
moltbot models list

# Ver durante la conversación
Tú: /model
MoltBot: Modelo actual: apiyi/claude-opus-4-5-20251101 (alias: opus)

Configuración del proxy de API de MoltBot: Preguntas frecuentes

{
  "models": {
    "mode": "merge",
    "providers": {
      "local-ollama": {
        "baseUrl": "http://localhost:11434/v1",
        "apiKey": "ollama-local",
        "api": "openai-responses",
        "models": [...]
      },
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "${APIYI_API_KEY}",
        "api": "openai-completions",
        "models": [...]
      }
    }
  }
}

"agents": {
  "defaults": {
    "model": {
      "primary": "apiyi/claude-opus-4-5-20251101"
    },
    "imageModel": "apiyi/gpt-4o",
    "models": {
      "apiyi/claude-opus-4-5-20251101": { "alias": "opus" },
      "apiyi/gpt-4o": { "alias": "vision" }
    }
  }
}

Configuración del proxy de API de MoltBot: Resumen y sugerencias

A través de este artículo, ya conoces los métodos completos para configurar el proxy de API en MoltBot:

1. Entender la estructura: models.providers define los servicios, y agents.defaults define la estrategia de uso.
2. Configurar múltiples proveedores: Conecta varios servicios de API simultáneamente para mejorar la disponibilidad.
3. Configurar Fallback: Cambia automáticamente a un modelo de respaldo si el modelo principal falla.
4. Usar alias: Cambia rápidamente de modelo mediante /model alias.

Sugerencias de mejores prácticas

Recomendamos usar APIYI (apiyi.com) como tu servicio principal de proxy de API. Esta plataforma ofrece un acceso unificado a los principales modelos como Claude, GPT y Gemini, con una configuración sencilla y planes de facturación flexibles, lo que la hace ideal para los escenarios de cambio entre múltiples modelos de MoltBot.

Referencias

1. Documentación oficial de MoltBot – Models: Explicación detallada de la configuración de modelos

   • Enlace: docs.molt.bot/concepts/models
   • Descripción: Guía oficial de configuración de modelos

2. Documentación oficial de MoltBot – Configuration: Referencia completa de configuración

   • Enlace: docs.molt.bot/gateway/configuration
   • Descripción: Detalle de todos los elementos de configuración

3. Documentación oficial de MoltBot – Model Providers: Configuración de proveedores (Providers)

   • Enlace: docs.molt.bot/concepts/model-providers
   • Descripción: Método de configuración de proveedores personalizados

4. GitHub de MoltBot: Código fuente y discusión de Issues

   • Enlace: github.com/moltbot/moltbot
   • Descripción: Última versión y reporte de problemas

Autor de este artículo: APIYI Team | Para más contenido técnico sobre IA, visita APIYI apiyi.com

Fecha de actualización: enero de 2026