Configuration du proxy API MoltBot : Tutoriel complet en 3 étapes pour intégrer Claude Opus et d’autres modèles

Vous souhaitez connecter MoltBot à Claude Opus 4.5 ou à d'autres grands modèles de langage, mais vous ne savez pas comment configurer le proxy API ? Cet article va vous guider pas à pas pour réussir la configuration multi-fournisseurs (Multi-Provider) de MoltBot. Vous apprendrez à connecter votre assistant IA à plusieurs services de modèles simultanément, tout en profitant du basculement intelligent et de la redondance.

Valeur ajoutée : En lisant cet article, vous maîtriserez la méthode de configuration models.providers de MoltBot. Vous saurez comment définir un modèle principal, des modèles de secours (fallback) et des alias de modèles pour créer un assistant IA stable et fiable.

Configuration du proxy API MoltBot : Analyse des concepts clés

MoltBot permet de se connecter à presque tous les services de grands modèles de langage via une API compatible OpenAI. Comprendre les concepts suivants est essentiel pour réussir votre configuration.

Système de fichiers de configuration de MoltBot

Champs essentiels de la configuration Provider de MoltBot

Chaque configuration de fournisseur (Provider) contient les champs clés suivants :

Explication des types de protocoles API

MoltBot supporte deux protocoles principaux compatibles OpenAI :

🎯 Conseil de configuration : La plupart des services de proxy API (comme APIYI apiyi.com) utilisent le protocole openai-completions. Si vous utilisez une installation locale de LM Studio ou d'Ollama, vous devrez utiliser openai-responses.

Configuration multi-Provider MoltBot : Exemple complet

Voici un exemple concret de configuration multi-provider, connectant simultanément les services APIYI et Qwen Portal :

Exemple complet de fichier de configuration

{
  "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}"
    }
  }
}

Détails de la structure de configuration

1. Section models.providers

C'est la partie centrale pour définir les services de proxy API :

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

• ID du Provider (apiyi) : Identifiant de service personnalisé, utilisé pour les références ultérieures.
• baseUrl : Point de terminaison (endpoint) de l'API, doit impérativement se terminer par /v1.
• apiKey : Prend en charge la saisie directe de la clé ou l'utilisation de variables d'environnement via ${ENV_VAR}.
• models : La liste des modèles pris en charge par ce fournisseur.

2. Section agents.defaults.model

Définit le modèle utilisé par défaut et la stratégie de secours (failover) :

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

• primary : Le modèle principal, au format provider-id/model-id.
• fallbacks : Un tableau de modèles de secours. Le système bascule automatiquement dessus si le modèle principal échoue.

3. Section agents.defaults.models

Définit des alias pour les modèles, afin de faciliter le basculement rapide :

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

Une fois les alias configurés, vous pouvez utiliser la commande /model opus directement dans la conversation pour changer rapidement de modèle.

Configuration du proxy API MoltBot : tutoriel pas à pas

Étape 1 : Obtenir votre clé API

Avant de commencer la configuration, vous devez préparer votre clé API :

🚀 Démarrage rapide : Nous recommandons d'utiliser APIYI (apiyi.com) comme fournisseur principal. Une seule clé API suffit pour appeler les modèles majeurs comme Claude, GPT et Gemini, sans avoir à s'inscrire sur plusieurs plateformes.

Étape 2 : Configurer les variables d'environnement

Par mesure de sécurité, il est conseillé de stocker vos clés API dans des variables d'environnement :

# Linux/macOS - Ajouter à ~/.bashrc ou ~/.zshrc
export APIYI_API_KEY="sk-your-apiyi-key"
export QWEN_API_KEY="your-qwen-key"
export TELEGRAM_BOT_TOKEN="your-telegram-token"

# Appliquer la configuration
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"

Étape 3 : Éditer le fichier de configuration

Ouvrez ou créez le fichier de configuration MoltBot :

# Ouvrir le fichier de configuration
nano ~/.moltbot/moltbot.json

# Ou utiliser VS Code
code ~/.moltbot/moltbot.json

Copiez et collez la configuration suivante dans le fichier :

{
  "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"
      }
    }
  }
}

Étape 4 : Valider la configuration

Redémarrez MoltBot et vérifiez que la configuration est bien prise en compte :

# Redémarrer MoltBot
moltbot restart

# Vérifier la configuration actuelle des modèles
moltbot models list

# Tester un appel au modèle
moltbot chat "Bonjour, quel modèle es-tu ?"

{
  "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}"
    }
  }
}

💡 Astuce de configuration : Utiliser "mode": "merge" permet de conserver les configurations de modèles intégrées à MoltBot tout en ajoutant vos fournisseurs personnalisés. Ainsi, même si un service personnalisé est indisponible, le système peut revenir à la configuration par défaut.

Configuration des modèles MoltBot : détails des paramètres avancés

Champs complets d'une entrée de modèle

Paramètres de configuration des modèles MoltBot Comparaison des champs obligatoires et optionnels

Paramètre Type Requis Exemple de valeur

CHAMPS OBLIGATOIRES

id string OUI « claude-opus-4-5-20251101 »

name string OUI « Claude Opus 4.5 »

baseUrl string OUI « https://api.apiyi.com/v1 »

CHAMPS OPTIONNELS

contextWindow number NON 200000

maxTokens number NON 32000

reasoning boolean NON true

input array NON [« text », « image »]

Doit être fourni Utilise la valeur par défaut si non défini

Conseil : définissez explicitement contextWindow et maxTokens pour correspondre aux limites de votre proxy/modèle afin d’obtenir de meilleurs résultats

APIYI apiyi.com

Configuration des paramètres du modèle (params)

Vous pouvez définir des paramètres par défaut pour chaque modèle dans agents.defaults.models :

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

⚠️ Attention : temperature est un paramètre avancé. À moins que vous ne connaissiez les paramètres par défaut du modèle et que vous ayez réellement besoin de les ajuster, il est recommandé de ne pas y toucher.

Configuration de basculement (Fallback) MoltBot

Le mécanisme de Fallback est une fonctionnalité essentielle de MoltBot, garantissant que votre assistant IA reste toujours disponible.

Fonctionnement du Fallback

Requête utilisateur
    ↓
Modèle principal (primary)
    ↓ (Échec)
Modèle de secours 1 (fallbacks[0])
    ↓ (Échec)
Modèle de secours 2 (fallbacks[1])
    ↓ (Échec)
... Continuer les tentatives

Stratégies de configuration Fallback recommandées

Configuration recommandée :

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

💰 Optimisation des coûts : En configurant le Fallback via APIYI (apiyi.com), vous pouvez basculer automatiquement entre plusieurs modèles tout en bénéficiant d'une facturation unifiée, ce qui facilite grandement la gestion des coûts.

Changement de modèle MoltBot : Astuces pratiques

Utiliser des alias pour un changement rapide

Une fois les alias configurés, vous pouvez changer de modèle à tout moment au cours d'une conversation :

Vous : /model opus
MoltBot : Passage au modèle Claude Opus 4.5

Vous : /model sonnet
MoltBot : Passage au modèle Claude Sonnet 4

Vous : /model qwen
MoltBot : Passage au modèle Qwen Coder

Assigner un modèle pour une tâche spécifique

Vous : /model gpt Aide-moi à analyser cette image
MoltBot : [Analyse de l'image en cours avec GPT-4o...]

Vous : /model opus Écris un article technique approfondi
MoltBot : [Rédaction en cours avec Claude Opus...]

Consulter l'état du modèle actuel

# Via la ligne de commande
moltbot models list

# Pendant une conversation
Vous : /model
MoltBot : Modèle actuel : apiyi/claude-opus-4-5-20251101 (alias : opus)

Configuration du proxy API MoltBot : Foire aux questions

{
  "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" }
    }
  }
}

Configuration du proxy API MoltBot : Résumé et conseils

Grâce à cet article, vous maîtrisez désormais la méthode complète pour configurer un proxy API dans MoltBot :

1. Comprendre la structure de configuration : models.providers définit les services, agents.defaults définit la stratégie d'utilisation.
2. Configurer plusieurs fournisseurs : Connectez plusieurs services API simultanément pour augmenter la disponibilité.
3. Configurer le Fallback : Basculez automatiquement vers un modèle de secours en cas d'échec du modèle principal.
4. Utiliser les alias : Changez rapidement de modèle via la commande /model alias.

Conseils de bonnes pratiques

Nous vous recommandons d'utiliser APIYI (apiyi.com) comme principal service de proxy API. Cette plateforme offre un accès unifié aux modèles majeurs comme Claude, GPT et Gemini. La configuration est simple et supporte des modes de facturation flexibles, ce qui est particulièrement adapté au scénario de basculement multi-modèles de MoltBot.

Ressources

1. Documentation officielle de MoltBot – Models : Détails de la configuration des modèles

   • Lien : docs.molt.bot/concepts/models
   • Description : Guide officiel de configuration des modèles

2. Documentation officielle de MoltBot – Configuration : Référence complète de configuration

   • Lien : docs.molt.bot/gateway/configuration
   • Description : Détails de toutes les options de configuration

3. Documentation officielle de MoltBot – Model Providers : Configuration des fournisseurs

   • Lien : docs.molt.bot/concepts/model-providers
   • Description : Méthode de configuration des fournisseurs personnalisés

4. GitHub de MoltBot : Code source et discussions sur les issues

   • Lien : github.com/moltbot/moltbot
   • Description : Dernière version et retours sur les problèmes

Auteur de cet article : Équipe APIYI | Pour plus de partages techniques sur l'IA, visitez APIYI apiyi.com

Date de mise à jour : Janvier 2026