Tutoriel complet pour connecter Moltbot à un relais API : 5 étapes pour configurer une interface compatible OpenAI et réduire les coûts de 60 %

Moltbot utilise par défaut l'API officielle d'Anthropic, mais celle-ci présente des inconvénients tels que des restrictions d'accès et des tarifs élevés. Cet article explique en détail comment configurer Moltbot pour se connecter à un relais API (API proxy) via le mode "openai-compatible" afin d'utiliser des services tiers.

Valeur ajoutée : Après avoir lu ce guide, vous saurez comment configurer Moltbot avec un relais API pour bénéficier d'une expérience d'assistant AI plus stable et à moindre coût.

Points clés de la configuration du relais API Moltbot

Avant de commencer la configuration, il est important de comprendre le mécanisme de configuration API de Moltbot et les avantages d'utiliser un relais.

Comparaison des méthodes de configuration de l'API Moltbot

Préparations pour la configuration du relais API Moltbot

Étape 1 : Vérifier que Moltbot est installé

Assurez-vous d'abord que Moltbot est bien installé sur votre machine :

# Vérifier la version de Moltbot
moltbot --version

# Si non installé, lancez l'installation
npm install -g moltbot@latest

Configuration requise : Node.js >= 22

Étape 2 : Obtenir la clé du relais API

Vous devez obtenir une clé API auprès d'un fournisseur de relais API.

🚀 Démarrage rapide : Nous vous recommandons d'utiliser APIYI (apiyi.com) pour obtenir vos clés API. Des crédits gratuits sont offerts à l'inscription, et le service supporte les derniers modèles comme Claude Sonnet 4, Claude Opus 4.5 ou GPT-4o, avec des tarifs 40 à 60 % moins chers que les tarifs officiels.

Une fois votre clé obtenue, notez les informations suivantes :

Méthode de configuration 1 pour le proxy API Moltbot : via le fichier config.json

C'est la méthode la plus recommandée, car elle permet une configuration permanente en une seule fois.

Localiser le fichier de configuration de Moltbot

Le fichier de configuration de Moltbot se trouve généralement ici :

Vous pouvez également le trouver via la ligne de commande :

# Afficher la configuration actuelle
moltbot config list

# Afficher le chemin du fichier de configuration
moltbot config path

Modifier le fichier config.json pour configurer le proxy API

Ouvrez le fichier de configuration et ajoutez ou modifiez la section 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"]
    }
  }
}

Détails des paramètres de configuration

Méthode de configuration 2 pour le proxy API Moltbot : format YAML

Si vous préférez le format YAML, Moltbot prend également en charge le fichier 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

Configuration YAML simplifiée

Si vous n'avez besoin que d'un seul modèle, vous pouvez utiliser une configuration plus concise :

# ~/.moltbot/config.yaml - Version minimaliste
llm:
  provider: openai-compatible
  model: claude-sonnet-4-20250514
  apiKey: sk-your-api-key-here
  baseUrl: https://api.apiyi.com/v1

🎯 Conseil technique : Il est recommandé d'utiliser la configuration complète. Cela vous permet de configurer plusieurs modèles et des stratégies de secours (fallbacks) pour améliorer la stabilité du service. Via APIYI (apiyi.com), vous pouvez accéder simultanément à de nombreux types de modèles comme Claude, GPT, Gemini, etc.

Méthode 3 de configuration du relais API Moltbot : Variables d'environnement

Idéal pour les tests temporaires ou les environnements CI/CD :

# 设置环境变量
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"

# 启动 Moltbot
moltbot gateway start

Ou configurer dans un fichier .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éthode 4 de configuration du relais API Moltbot : Ligne de commande

Utilisez la commande moltbot config set pour une configuration rapide :

# 配置 API 中转站
moltbot config set models.providers.apiyi.baseUrl "https://api.apiyi.com/v1"
moltbot config set models.providers.apiyi.apiKey "sk-your-api-key-here"
moltbot config set models.providers.apiyi.api "openai-completions"

# 设置默认模型
moltbot config set agent.model.primary "apiyi/claude-sonnet-4-20250514"

# 验证配置
moltbot config list

Script de configuration par lot

Créez un script pour automatiser tous les réglages en un clic :

#!/bin/bash
# setup-apiyi.sh - Script de configuration du relais APIYI pour Moltbot

API_KEY="sk-your-api-key-here"
BASE_URL="https://api.apiyi.com/v1"

echo "Configuration du relais API Moltbot..."

# 设置 provider
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

# 设置默认模型
moltbot config set agent.model.primary "apiyi/claude-sonnet-4-20250514"

# 重启 gateway
moltbot gateway restart

echo "Configuration terminée ! Utilisez 'moltbot doctor' pour vérifier la configuration."

Validation de la configuration du relais API Moltbot

Une fois la configuration terminée, il est nécessaire de vérifier si tout fonctionne correctement.

Utiliser moltbot doctor pour vérifier

# Exécuter le diagnostic
moltbot doctor

# Réparer automatiquement les problèmes
moltbot doctor --fix

Exemple de sortie normale :

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

Envoyer un message de test

# Tester la connexion API
moltbot test-llm --provider apiyi --model claude-sonnet-4-20250514

# Envoyer un message de test
moltbot chat "Bonjour, peux-tu te présenter ?"

Vérifier les journaux d'appels API

# Voir les journaux en temps réel
moltbot logs --follow

# Voir les 10 derniers appels API
moltbot logs --filter api-call --last 10

Liste des modèles supportés par le relais API Moltbot

Via le relais APIYI, vous pouvez utiliser les modèles suivants dans Moltbot :

Série de modèles Claude

Série de modèles OpenAI

Série de modèles Google

💡 Conseil de choix : Pour une utilisation quotidienne de Moltbot, nous recommandons Claude Sonnet 4, qui offre un excellent équilibre entre performance et coût. Vous pouvez consulter la liste complète des modèles et les tarifs en temps réel sur APIYI apiyi.com.

Configuration avancée du relais API Moltbot

Configurer une stratégie de repli (Fallback)

Basculez automatiquement vers un modèle de secours lorsque le modèle principal est indisponible :

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

Configurer les règles de routage des modèles

Sélectionnez automatiquement le meilleur modèle en fonction du type de tâche :

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

Configurer les limites de coûts

Évitez les dépenses excessives imprévues :

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

Foire aux questions (FAQ) sur le relais API Moltbot

# Vérifier la clé API
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 "Bonjour"

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

# Voir les statistiques locales
moltbot stats --period today

# Voir l'utilisation détaillée
moltbot stats --detailed --period week

Résolution des problèmes de configuration du proxy API Moltbot

Erreurs courantes et solutions

Mode débogage

Activez les logs détaillés pour faciliter le dépannage :

# Activer le mode débogage
export MOLTBOT_DEBUG=true
moltbot gateway start

# Ou utiliser les arguments de la ligne de commande
moltbot gateway start --debug --log-level verbose

Commandes de vérification de la configuration

# Valider la syntaxe de la configuration
moltbot config validate

# Tester la connexion API
moltbot test-connection --provider apiyi

# Bilan de santé complet (health check)
moltbot doctor --verbose

Comparaison : Proxy API Moltbot vs API Officielle

🎯 Conseil de choix : Pour les utilisateurs ayant besoin d'un support multi-modèles, nous recommandons d'utiliser Moltbot via APIYI (apiyi.com). Non seulement les tarifs sont plus avantageux, mais vous bénéficierez également d'un service plus stable et d'un support technique dédié.

Récapitulatif : points clés de la configuration du relais API pour Moltbot

Grâce à ce tutoriel, vous avez appris la méthode complète pour configurer Moltbot avec un relais API :

1. Préparatifs : installer Moltbot et obtenir une clé API sur APIYI (apiyi.com).
2. Fichier de configuration : éditer config.json ou config.yaml pour ajouter la configuration du fournisseur (provider).
3. Paramètres clés : baseUrl, apiKey, type d'API et liste des modèles.
4. Validation et tests : utiliser moltbot doctor et les commandes de test pour confirmer que la configuration est correcte.
5. Fonctionnalités avancées : stratégies de secours (fallback), routage des modèles et limites de coûts.

Nous vous recommandons d'obtenir vos clés API via APIYI (apiyi.com) pour bénéficier de tarifs avantageux et d'un service stable, afin de tirer le meilleur parti de votre assistant Moltbot.

Ressources complémentaires

1. Documentation officielle de Moltbot : Référence de configuration de la passerelle (Gateway)

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

2. Exemples de configuration Moltbot : Modèles de configuration pour différents scénarios

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

3. Fournisseurs de modèles Moltbot : Détails de la configuration des fournisseurs (Provider)

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

4. Moltbot GitHub : Code source du projet et tickets (Issues)

   • Lien : github.com/moltbot/moltbot

5. Guide de démarrage Moltbot : Tutoriel de prise en main rapide

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

📝 Auteur : Équipe APIYI
🔗 Support technique : Pour obtenir des clés API ou une assistance technique, n'hésitez pas à visiter APIYI (apiyi.com)