Synthetic Provider in OpenClaw einrichten

Ich kenne das Problem: Man möchte ein neues Modell ausprobieren, aber die API-Struktur passt hinten und vorne nicht zusammen. Ich habe oft Stunden damit verbracht, Endpoints zu verbiegen, nur um festzustellen, dass der Provider eine völlig eigene Logik nutzt.

Synthetic macht hier Schluss mit dem Chaos. Es nutzt die Anthropic Messages API, was die Integration in OpenClaw extrem entspannt macht. Du registrierst es einfach als synthetic Provider und kannst direkt loslegen.

Voraussetzungen

• Einen Synthetic API Key
• Eine laufende OpenClaw Installation

Schnellstart

In weniger als fünf Minuten ist Synthetic bei dir einsatzbereit. Folge einfach diesen Schritten:

1. Setze deinen API Key in der Shell: export SYNTHETIC_API_KEY="dein-key-hier"
2. Starte das Onboarding:

openclaw onboard --auth-choice synthetic-api-key

Standardmäßig nutzt OpenClaw das Modell synthetic/hf:MiniMaxAI/MiniMax-M2.1. Hier ist ein Beispiel, wie deine Konfiguration in der config.json5 aussehen kann:

{
  env: { SYNTHETIC_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M2.1" },
      models: { "synthetic/hf:MiniMaxAI/MiniMax-M2.1": { alias: "MiniMax M2.1" } },
    },
  },
  models: {
    mode: "merge",
    providers: {
      synthetic: {
        baseUrl: "https://api.synthetic.new/anthropic",
        apiKey: "${SYNTHETIC_API_KEY}",
        api: "anthropic-messages",
        models: [
          {
            id: "hf:MiniMaxAI/MiniMax-M2.1",
            name: "MiniMax M2.1",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 192000,
            maxTokens: 65536,
          },
        ],
      },
    },
  },
}

Ein wichtiger Punkt: Der Anthropic-Client von OpenClaw hängt automatisch /v1 an die URL an. Nutze daher https://api.synthetic.new/anthropic als Base URL. Falls Synthetic die Adresse ändert, kannst du sie unter models.providers.synthetic.baseUrl überschreiben.

Model Catalog

Alle hier gelisteten Modelle haben aktuell Kosten von 0 für Input, Output und Cache.

Model ID	Context window	Max tokens	Reasoning	Input
hf:MiniMaxAI/MiniMax-M2.1	192000	65536	false	text
hf:moonshotai/Kimi-K2-Thinking	256000	8192	true	text
hf:zai-org/GLM-4.7	198000	128000	false	text
hf:deepseek-ai/DeepSeek-R1-0528	128000	8192	false	text
hf:deepseek-ai/DeepSeek-V3-0324	128000	8192	false	text
hf:deepseek-ai/DeepSeek-V3.1	128000	8192	false	text
hf:deepseek-ai/DeepSeek-V3.1-Terminus	128000	8192	false	text
hf:deepseek-ai/DeepSeek-V3.2	159000	8192	false	text
hf:meta-llama/Llama-3.3-70B-Instruct	128000	8192	false	text
hf:meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8	524000	8192	false	text
hf:moonshotai/Kimi-K2-Instruct-0905	256000	8192	false	text
hf:openai/gpt-oss-120b	128000	8192	false	text
hf:Qwen/Qwen3-235B-A22B-Instruct-2507	256000	8192	false	text
hf:Qwen/Qwen3-Coder-480B-A35B-Instruct	256000	8192	false	text
hf:Qwen/Qwen3-VL-235B-A22B-Instruct	250000	8192	false	text + image
hf:zai-org/GLM-4.5	128000	128000	false	text
hf:zai-org/GLM-4.6	198000	128000	false	text
hf:deepseek-ai/DeepSeek-V3	128000	8192	false	text
hf:Qwen/Qwen3-235B-A22B-Thinking-2507	256000	8192	true	text

Fehlerbehebung

Wenn es hakt, liegt es meist an kleinsten Details in der Config. Hier sind zwei Dinge, die du prüfen solltest:

• Falsche Base URL: Achte darauf, dass du kein /v1 am Ende der URL in deiner Config hast. OpenClaw erledigt das für dich.
• Fehlende Modelle: Falls du eine Allowlist unter agents.defaults.models nutzt, musst du jedes Synthetic-Modell dort explizit eintragen.

Modell-Referenzen nutzen immer das Schema synthetic/<modelId>.

Du brauchst Hilfe bei der Einrichtung? Frag unseren AI Setup Assistant.

Nächste Schritte

• Model Providers Konzepte
• Eigene Agents konfigurieren