OpenClaw
konfigurieren
über CoreAPI
Nutzen Sie CoreAPI als benutzerdefinierten Modellanbieter für OpenClaw: eine API, viele Modelle zu offiziellen Listenpreisen. Dieser Leitfaden folgt dem aktuellen OpenClaw-Onboarding-Ablauf (2026.3.8+) und behandelt Installation, Anbieterkonfiguration, Überprüfung und Modellwechsel.
# Nur Beispiel—vor der Produktion mit Ihrer OpenClaw-Version überprüfen
{
"agents": {
"defaults": {
"model": {
"primary": "coreapi-claude/claude-sonnet-4-5-20250929"
}
}
},
"models": {
"mode": "merge",
"providers": {
"coreapi-openai": {
"baseUrl": "https://unixcore.io/v1",
"apiKey": "${COREAPI_KEY}",
"api": "openai-completions",
"models": [{ "id": "deepseek-flash", "name": "DeepSeek Flash" }]
},
"coreapi-claude": {
"baseUrl": "https://unixcore.io",
"apiKey": "${COREAPI_KEY}",
"api": "anthropic-messages",
"models": [{ "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5" }]
}
}
}
}Leitfadenumfang
und Voraussetzungen
OpenClaw mit CoreAPI konfigurieren
Nutzen Sie CoreAPI als benutzerdefinierten Modellanbieter für OpenClaw, um zu offiziellen Listenpreisen auf viele Modelle in einer API zuzugreifen. Diese Seite folgt dem aktuellen OpenClaw-Onboarding-Ablauf (2026.3.8+).
Voraussetzungen
Node.js >= 22 und ein CoreAPI API-Schlüssel sind erforderlich. Für Daemon-Installationen speichere COREAPI_KEY in ~/.openclaw/.env, damit openclaw.json darauf über $COREAPI_KEY verweisen kann, ohne Geheimnisse fest zu kodieren.
openclaw onboard --install-daemon openclaw gateway status openclaw dashboard printf 'COREAPI_KEY=%s\n' 'your_coreapi_key' >> ~/.openclaw/.env chmod 600 ~/.openclaw/.env
Nach dem Hinzufügen ~/.openclaw/.env oder dem Bearbeiten der Anbieterkonfiguration einmal neu starten mit openclaw gateway restart, dann Diagnose ausführen. Vollständige provider/model-Referenzen in allen Befehlen und Sitzungen verwenden. Bei Versionsdrift die Konfigurationsreferenz.
Warum zwei Anbieter
für einen CoreAPI-Schlüssel
Installieren, onboarden, konfigurieren,
verifizieren, wechseln
OpenClaw verwendet ~/.openclaw/openclaw.json als die von Ihnen bearbeitete Quellkonfiguration. Benutzerdefinierte Anbieter werden in anbieterspezifische models.json Dateien unter ~/.openclaw/agents/<agentId>/materialisiert. Schlüssel und Verhalten nach Upgrades mit dem Konfigurationsreferenz und dem Umgebungsvariablen Leitfaden erneut prüfen. CoreAPI-Base-URLs nur so behandeln, wie sie im Live-Dokumentationdefiniert sind.
{
"agents": {
"defaults": {
"model": {
"primary": "coreapi-claude/claude-sonnet-4-5-20250929"
}
}
},
"models": {
"mode": "merge",
"providers": {
"coreapi-openai": {
"baseUrl": "https://unixcore.io/v1",
"apiKey": "${COREAPI_KEY}",
"api": "openai-completions",
"models": [{ "id": "deepseek-flash", "name": "DeepSeek Flash" }]
},
"coreapi-claude": {
"baseUrl": "https://unixcore.io",
"apiKey": "${COREAPI_KEY}",
"api": "anthropic-messages",
"models": [{ "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5" }]
}
}
}
}Beim Basis-Setup muss auth-profiles.jsonnicht manuell erstellt werden. In Anbietern ${COREAPI_KEY} verwenden und die Variable über ~/.openclaw/.env, Shell oder Service-Manager injizieren.
Live-Preise auf
der CoreAPI-Website
In der folgenden Tabelle werden beispielhafte Zahlen pro Million Token verwendet. Modellkatalog, Preise und SLAs folgen den aktuellen CoreAPI-Bedingungen. CoreAPI-Dokumentation und Konsole den aktuellen Angaben.
Dies vor der
Integration prüfen
Benötige ich auth-profiles.json für dieses Setup?
Nein für das Basis-Setup. OpenClaw kann den Anbieter-apiKey aus models.providers.*.apiKey über $COREAPI_KEY auflösen. auth-profiles.json nur für profilspezifische gespeicherte Secrets oder Rotation verwenden.
Warum gibt es 2 Anbietereinträge für einen Anbieter?
OpenClaw routet nach API-Format-Kompatibilität. Separate Einträge für openai-completions und anthropic-messages beibehalten.
Wo wird die Konfiguration tatsächlich bearbeitet und materialisiert?
~/.openclaw/openclaw.json bearbeiten. Benutzerdefinierte Anbieter werden nach Sync/Load in anbieterspezifische models.json unter ~/.openclaw/agents/<agentId>/ materialisiert.
Welche Modell-IDs werden in diesem Leitfaden verwendet?
deepseek-flash, claude-sonnet-4-5-20250929. Jedes Modell von der CoreAPI-Modellseite kann dem entsprechenden Anbieterblock hinzugefügt werden.