OpenClaw mit OmniaKey einrichten: Provider und Modell-Allowlist
Richten Sie OmniaKey als OpenAI-kompatiblen Provider in OpenClaw ein. Anleitung für openclaw.json, Modell-Allowlist, doctor und den Fehler model not allowed.
Bei der Suche nach OpenClaw API einrichten werden zwei Schritte oft vermischt: den Provider definieren und das Modell in der Allowlist freigeben. OpenClaw liefert den Agent-Loop und die Tools; das angeschlossene Modell liefert die eigentliche Antwort.
OmniaKey als Provider eintragen
Die Konfiguration liegt in ~/.openclaw/openclaw.json. Ergänze OmniaKey unter models.providers:
{
"models": {
"mode": "merge",
"providers": {
"omniakey": {
"baseUrl": "https://api.omniakey.com/v1",
"apiKey": "your-omniakey-api-key",
"api": "openai-completions",
"models": [
{ "id": "claude-opus-4-8" },
{ "id": "gpt-5.5" },
{ "id": "gemini-3.1-pro-preview" },
{ "id": "grok-4.5" }
]
}
}
}
}
mode: merge ergänzt den Provider, ohne die vorhandene Konfiguration zu ersetzen. Trage deinen echten Key ein, aber speichere ihn nicht in Git oder öffentlichen Nachrichten. Verwende eine exakte Modell-ID aus dem aktuellen Katalog.
Der oft fehlende Schritt: Modell freigeben
Die Provider-Definition allein reicht nicht. OpenClaw verlangt zusätzlich eine Allowlist. Füge agents als Geschwister von models in derselben Datei hinzu:
{
"agents": {
"defaults": {
"models": [
"omniakey/claude-opus-4-8",
"omniakey/gpt-5.5",
"omniakey/gemini-3.1-pro-preview",
"omniakey/grok-4.5"
],
"model": "omniakey/claude-opus-4-8"
}
}
}
Der Request verwendet die Modell-ID; provider/model-id ist der interne OpenClaw-Verweis. Beide Einträge sind erforderlich. Fehlt die Allowlist, erscheint oft model not allowed, obwohl der Key korrekt ist.
Prüfen
openclaw doctor
openclaw models list
doctor prüft Datei, Provider, Key-Format, Live-Verbindung und Modellzugriff. Danach kannst du unter agents.defaults z. B. omniakey/gpt-5.5 als aktives Modell setzen.
Bearbeite ~/.openclaw/agents/main/agent/models.json nicht manuell. Die Datei wird aus openclaw.json erzeugt und kann überschrieben werden.
Warum OmniaKey für OpenClaw?
Ein Key und ein Guthaben decken Claude, GPT, Gemini und Grok ab; abgerechnet wird nach Tokens. Die freigegebene Modell-ID läuft tatsächlich, ohne stillen Wechsel zu einem vermeintlich gleichwertigen Modell.
Weitere Tool-Konfigurationen stehen im Guide für Coding-Agents.