Model Provider in OpenClaw konfigurieren

Kennst du das? Du möchtest eigentlich nur ein neues Modell testen, aber verbringst die erste Stunde damit, API-Endpunkte zu suchen und Header zu debuggen. Es ist frustrierend, wenn das Setup komplexer ist als die eigentliche Entwicklung. Wir wollen, dass du dich auf den Code konzentrierst, nicht auf die Config-Hölle.

Hier erfährst du, wie du verschiedene LLM-Provider effizient in OpenClaw einbindest – egal ob Cloud-API oder lokaler Host.

Voraussetzungen

• OpenClaw CLI installiert
• API-Keys für deine gewünschten Provider (z. B. OpenAI, Anthropic oder Google)
• Installierte Plugins für spezifische OAuth-Flows (falls benötigt)

Schnellstart

In weniger als 5 Minuten ist dein erster Provider startklar. Folge diesem Pfad:

1. Onboarding starten: Nutze openclaw onboard --auth-choice <provider-key>, um die Authentifizierung direkt im Terminal zu erledigen.
2. Modell wählen: Setze dein Standardmodell mit openclaw models set provider/model.
3. Status prüfen: Checke deine Konfiguration mit openclaw models list.

Eingebaute Provider (pi-ai catalog)

OpenClaw kommt mit dem pi‑ai catalog. Für diese Provider musst du keine models.providers in der Config anlegen. Du setzt einfach die Auth-Daten und wählst ein Modell.

OpenAI & Anthropic

Modelle werden immer nach dem Schema provider/model referenziert.

OpenAI Setup:

• Provider: openai
• Auth: OPENAI_API_KEY
• CLI: openclaw onboard --auth-choice openai-api-key

{
  agents: { defaults: { model: { primary: "openai/gpt-5.1-codex" } } },
}

Anthropic Setup:

• Provider: anthropic
• Auth: ANTHROPIC_API_KEY oder claude setup-token
• CLI: openclaw onboard --auth-choice token

{
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

Google Gemini & Vertex

Für Google-Dienste gibt es verschiedene Wege. Während Gemini oft über einen API-Key läuft, nutzen Vertex oder Antigravity spezialisierte Flows.

• Gemini API: Nutze google als Provider und den GEMINI_API_KEY.
• Vertex/Antigravity: Hierfür musst du oft Plugins aktivieren.

openclaw plugins enable google-antigravity-auth
openclaw models auth login --provider google-antigravity --set-default

Hinweis: Du musst keine Client-ID in die openclaw.json kopieren. Der Login-Flow speichert die Tokens direkt auf dem Gateway-Host.

Eigene Provider über models.providers

Wenn du Proxies oder OpenAI-kompatible Dienste wie Moonshot AI nutzt, konfigurierst du diese manuell in der openclaw.json.

Moonshot AI (Kimi)

Moonshot nutzt OpenAI-kompatible Endpunkte. So sieht die Einbindung aus:

{
  agents: {
    defaults: { model: { primary: "moonshot/kimi-k2.5" } },
  },
  models: {
    mode: "merge",
    providers: {
      moonshot: {
        baseUrl: "https://api.moonshot.ai/v1",
        apiKey: "${MOONSHOT_API_KEY}",
        api: "openai-completions",
        models: [{ id: "kimi-k2.5", name: "Kimi K2.5" }],
      },
    },
  },
}

Lokale Modelle mit Ollama

Ollama wird automatisch erkannt, wenn es lokal unter http://127.0.0.1:11434/v1 läuft.

1. Installiere Ollama und lade ein Modell: ollama pull llama3.3.
2. Nutze es in OpenClaw:

{
  agents: {
    defaults: { model: { primary: "ollama/llama3.3" } },
  },
}

Local Proxies (LM Studio, vLLM)

Für Tools wie LM Studio definierst du die Parameter explizit. Wir empfehlen, Werte für contextWindow und maxTokens anzugeben, die zu deinem lokalen Setup passen.

{
  agents: {
    defaults: {
      model: { primary: "lmstudio/minimax-m2.1-gs32" },
      models: { "lmstudio/minimax-m2.1-gs32": { alias: "Minimax" } },
    },
  },
  models: {
    providers: {
      lmstudio: {
        baseUrl: "http://localhost:1234/v1",
        apiKey: "LMSTUDIO_KEY",
        api: "openai-completions",
        models: [
          {
            id: "minimax-m2.1-gs32",
            name: "MiniMax M2.1",
            contextWindow: 200000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

Fehlerbehebung

• Plugin fehlt: Wenn du OAuth-Provider wie qwen-portal oder google-antigravity nutzt und der Login fehlschlägt, stelle sicher, dass das entsprechende Plugin aktiviert ist (openclaw plugins enable <name>).
• Modell nicht in der Allowlist: Wenn du agents.defaults.models definierst, fungiert dies als Allowlist. Andere Modelle können dann nicht aufgerufen werden.

Hast du Fragen zu einem spezifischen Provider? Frag den AI Setup Assistant.

Nächste Schritte

• Modell-Auswahlregeln verstehen
• Gateway-Konfiguration im Detail