MoltBot API-Proxy-Konfiguration: Vollständige Anleitung in 3 Schritten zur Anbindung von Claude Opus und weiteren Modellen

Möchten Sie MoltBot mit Claude Opus 4.5 oder anderen Großen Sprachmodellen verbinden, wissen aber nicht, wie Sie den API-Proxy konfigurieren sollen? In diesem Artikel zeige ich Ihnen Schritt für Schritt, wie Sie die MoltBot Multi-Provider-Konfiguration einrichten, damit Ihr AI-Assistent gleichzeitig auf mehrere Modelldienste zugreifen kann – für intelligentes Umschalten und Ausfallsicherheit.

Kernnutzen: Nach der Lektüre dieses Artikels werden Sie die models.providers-Konfiguration von MoltBot beherrschen. Sie lernen, Primärmodelle, Fallback-Modelle und Modell-Aliase einzurichten, um einen stabilen und zuverlässigen AI-Assistenten aufzubauen.

MoltBot API-Proxy-Konfiguration: Analyse der Kernkonzepte

MoltBot unterstützt die Anbindung an fast alle gängigen Großen Sprachmodelle über eine OpenAI-kompatible API. Das Verständnis der folgenden Kernkonzepte ist entscheidend für eine erfolgreiche Konfiguration.

MoltBot Konfigurationssystem

MoltBot Provider-Konfiguration: Kernfelder

Jede Provider-Konfiguration enthält die folgenden wichtigen Felder:

Erläuterung der API-Protokolltypen

MoltBot unterstützt zwei gängige OpenAI-kompatible Protokolle:

🎯 Konfigurationsempfehlung: Die meisten API-Proxy-Dienste (wie APIYI apiyi.com) verwenden das openai-completions-Protokoll. Wenn Sie ein lokal bereitgestelltes LM Studio oder Ollama verwenden, müssen Sie openai-responses nutzen.

Hier ist ein praxisnahes Beispiel für eine Multi-Provider-Konfiguration, die gleichzeitig die Dienste von APIYI und dem Qwen Portal einbindet:

Beispiel einer vollständigen Konfigurationsdatei

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

Details zur Konfigurationsstruktur

1. Der Bereich models.providers

Dies ist das Kernstück zur Definition der API-Proxy-Dienste:

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

• Provider ID (apiyi): Ein benutzerdefinierter Bezeichner für den Dienst, der später zur Referenzierung verwendet wird.
• baseUrl: Der API-Endpunkt; dieser muss zwingend auf /v1 enden.
• apiKey: Unterstützt die direkte Eingabe oder die Verwendung von ${ENV_VAR} Umgebungsvariablen.
• models: Die Liste der von diesem Provider unterstützten Modelle.

2. Der Bereich agents.defaults.model

Hier werden das Standardmodell und die Failover-Strategie (Ausfallsicherung) definiert:

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

• primary: Das Hauptmodell im Format provider-id/model-id.
• fallbacks: Ein Array von Ersatzmodellen, auf die automatisch umgeschaltet wird, falls das Hauptmodell fehlschlägt.

3. Der Bereich agents.defaults.models

Definiert Modell-Aliase für einen schnellen Wechsel:

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

Nachdem Aliase konfiguriert wurden, können Sie im Chat den Befehl /model opus nutzen, um das Modell blitzschnell zu wechseln.

MoltBot API-Proxy-Konfiguration: Schritt-für-Schritt-Anleitung

Schritt 1: API-Key erhalten

Bevor Sie mit der Konfiguration beginnen, müssen Sie Ihre API-Keys bereithalten:

🚀 Schnellstart: Es wird empfohlen, APIYI (apiyi.com) als Haupt-Provider zu verwenden. Mit einem einzigen API-Key können Sie gängige Modelle wie Claude, GPT und Gemini aufrufen, ohne sich auf mehreren Plattformen einzeln registrieren zu müssen.

Schritt 2: Umgebungsvariablen festlegen

Aus Sicherheitsgründen wird empfohlen, API-Keys in Umgebungsvariablen zu speichern:

# Linux/macOS - Zu ~/.bashrc oder ~/.zshrc hinzufügen
export APIYI_API_KEY="sk-your-apiyi-key"
export QWEN_API_KEY="your-qwen-key"
export TELEGRAM_BOT_TOKEN="your-telegram-token"

# Konfiguration anwenden
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"

Schritt 3: Konfigurationsdatei bearbeiten

Öffnen oder erstellen Sie die MoltBot-Konfigurationsdatei:

# Konfigurationsdatei öffnen
nano ~/.moltbot/moltbot.json

# Oder mit VS Code öffnen
code ~/.moltbot/moltbot.json

Kopieren Sie die folgende Konfiguration in die Datei:

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

Schritt 4: Konfiguration überprüfen

Starten Sie MoltBot neu und überprüfen Sie, ob die Konfiguration übernommen wurde:

# MoltBot neu starten
moltbot restart

# Aktuelle Modellkonfiguration prüfen
moltbot models list

# Modellaufruf testen
moltbot chat "Hallo, bitte sag mir, welches Modell du bist."

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

💡 Konfigurations-Tipp: Mit "mode": "merge" können Sie die integrierten Modellkonfigurationen von MoltBot beibehalten und gleichzeitig Ihre eigenen Provider hinzufügen. So kann das System auf Standardkonfigurationen zurückgreifen, falls Ihre benutzerdefinierten Dienste nicht verfügbar sind.

MoltBot-Modellkonfiguration: Fortgeschrittene Parameter im Detail

Vollständige Felder für Modelleinträge

Modellparameter-Konfiguration (params)

In agents.defaults.models können Sie für jedes Modell Standardparameter festlegen:

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

⚠️ Hinweis: temperature ist ein fortgeschrittener Parameter. Sofern Sie die Standardeinstellungen des Modells nicht genau kennen und eine Anpassung wirklich notwendig ist, wird empfohlen, diesen Wert nicht manuell zu setzen.

MoltBot Fallback-Konfiguration für Ausfallsicherheit

Der Fallback-Mechanismus ist eine wichtige Funktion von MoltBot, die sicherstellt, dass der KI-Assistent jederzeit verfügbar bleibt.

So funktioniert Fallback

Benutzeranfrage
    ↓
Primärmodell (primary)
    ↓ (Fehlgeschlagen)
Backup-Modell 1 (fallbacks[0])
    ↓ (Fehlgeschlagen)
Backup-Modell 2 (fallbacks[1])
    ↓ (Fehlgeschlagen)
...weitere Versuche

Empfohlene Fallback-Strategien

Empfohlene Konfiguration:

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

💰 Kostenoptimierung: Durch die Konfiguration von Fallbacks über APIYI apiyi.com können Sie automatisch zwischen mehreren Modellen wechseln und gleichzeitig von einer einheitlichen Abrechnung profitieren, was die Kostenkontrolle erleichtert.

MoltBot Modellwechsel: Praxistipps

Schneller Wechsel durch Aliase

Sobald Aliase konfiguriert sind, können Sie das Modell jederzeit während eines Gesprächs wechseln:

Du: /model opus
MoltBot: Umgeschaltet auf Claude Opus 4.5

Du: /model sonnet
MoltBot: Umgeschaltet auf Claude Sonnet 4

Du: /model qwen
MoltBot: Umgeschaltet auf Qwen Coder

Modelle für spezifische Aufgaben zuweisen

Du: /model gpt hilf mir, dieses Bild zu analysieren
MoltBot: [Analysiere Bild mit GPT-4o...]

Du: /model opus schreibe einen tiefgehenden technischen Artikel
MoltBot: [Schreibe mit Claude Opus...]

Aktuellen Modellstatus anzeigen

# In der Kommandozeile anzeigen
moltbot models list

# Im Chat anzeigen
Du: /model
MoltBot: Aktuelles Modell: apiyi/claude-opus-4-5-20251101 (Alias: opus)

MoltBot API-Proxy-Konfiguration: Häufig gestellte Fragen (FAQ)

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