OpenClaw API-Key & Modell
Vollständiger Installationsleitfaden 2026
Nach der Installation ist OpenClaw ohne angebundenes Modell nur eine leere Hülle. Ein falscher API-Key, ein nicht gestarteter lokaler Inferenzdienst oder ein Standardmodell, das zur Aufgabe nicht passt, lassen OpenClaw kaputt wirken. Dieser Leitfaden bleibt eine vollständige Installations- und Konfigurationsanleitung für 2026 — mit besonderem Fokus auf die Kette Modell, Schlüssel und Erstabnahme: wann Cloud oder lokal sinnvoll ist, wie Sie Schlüssel sicher aufbewahren und wie das Dashboard beweist, dass das Modell wirklich aufgerufen wird.
Schlüssel → Provider → Modell-ID → Netzwerk → Logs
Dashboard und Health-Check
Cloud / lokal / hybrid
1Installation fertig ≠ Modell erreichbar
Ob OpenClaw wirklich nutzbar ist, hängt stärker davon ab, ob die Modellkette verbunden ist, Schlüssel sicher liegen und das Standardmodell zur Aufgabe passt, als davon, ob npm install -g openclaw durchlief. Eine laufende Gateway und ein OK auf Port 18789 bedeuten nur: die Hülle steht. Für echte Arbeit brauchen Sie eine gültige provider/model-Referenz und Authentifizierung. Die folgenden Abschnitte führen diese Kette im vollen Installationsablauf durch.
openclaw models status oder einen minimalen Agent-Aufruf aus und prüfen Sie in den Logs ausgehende HTTP-Anfragen und Token-Nutzung.
2Vor der Installation: Modell und Schlüssel vorbereiten
Vor dem Start: ① die von Ihrer OpenClaw-Version unterstützten Provider (offizielle Doku); ② einen Cloud-API-Key und den passenden Umgebungsvariablennamen; ③ bei lokaler Inferenz einen kompatiblen HTTP-Endpunkt, der bereits lauscht, plus ausreichend RAM; ④ Netzwerkzugang zur Provider-API oder zum lokalen Port. Bei Hybrid-Setups klar festlegen: Welche Maschine hostet die Gateway, welche die Inferenz?
3Offizielle Installation und Onboarding
Installieren Sie Node 24 und die CLI, dann openclaw onboard (optional mit --install-daemon) für Standardmodell und Gateway. Prüfen Sie node -v und ob launchd Ihre Umgebungsvariablen erbt — sonst fehlen Schlüssel nach einem Neustart. Details zu Node 24 und Port 18789 im
Kaltstart-Runbook.
4Cloud-Modelle und API-Key
Integrierte Provider brauchen meist nur Auth: openclaw onboard --auth-choice openai-api-key (genaue Flags folgen dem Assistenten), oder export OPENAI_API_KEY="sk-your-placeholder" und danach openclaw models set provider/model. Für einen eigenen Proxy models.providers definieren und Schlüssel per ${ENV}-Platzhalter referenzieren — nie als Klartext. Validieren mit openclaw models status.
5Lokales Modell anbinden
Lokale Inferenz eignet sich für Datenschutz und Kostenkontrolle; die Geschwindigkeit hängt von der Hardware ab. In models.providers ein lokales baseUrl setzen (z. B. http://127.0.0.1:PORT/v1) und die Modell-id. Zuerst den Endpunkt per curl testen, dann OpenClaw starten.
6Cloud, lokal und hybrid abnehmen
| Prüfpunkt | Cloud-Modell | Lokales Modell | Hybrid |
|---|---|---|---|
| Authentifizierung | models status zeigt Provider als authentifiziert |
Lokaler Endpunkt ohne Key oder nur internes Token | Beide Konfigurationen in status sichtbar |
| Konnektivität | Ausgehender Zugriff auf Provider-API | curl auf lokales baseUrl |
Jeden Pfad getrennt prüfen — Schritte nicht mischen |
| Dashboard | 18789 OK + Session mit Upstream-Anfragen | Logs mit lokalen HTTP-Aufrufen | Hauptmodell in der Cloud, sensible Schritte lokalüblich |
| Kosten / Datenschutz | Nutzungsabhängige Abrechnung; Daten verlassen die Maschine | Strom und Hardware; Daten bleiben lokal | Festlegen, welche Tasks welchen Pfad nutzen |
Das Dashboard liegt standardmäßig unter 127.0.0.1:18789 (Gateway-Status und Logs). Lädt die Seite, antwortet aber nichts, gehen Sie die Tabelle Zeile für Zeile durch.
7Ersttest nach der Einrichtung
openclaw agent --local --session-id smoke-test --message "Antworte nur: Modell OK" --timeout 90 — zeigt das JSON den erwarteten provider/model und die Logs ausgehende Anfragen, ist die Modellkette in Ordnung.
8Modellfehler vs. Installationsfehler
openclaw models list und Schreibweise provider/model; bei Custom-Provider models.providers.*.models[].id prüfen.lsof -iTCP:18789, dann launchd — kein Modell-API-Problem; Schlüssel nicht zuerst rotieren.9Laufende Wartung
Schlüssel regelmäßig rotieren, Katalogänderungen mit models list verfolgen, Abrechnung im Blick behalten. Nach einem neuen Provider mit openclaw models set das Standard-Hauptmodell anpassen.
- 1Schlüssel, Netzwerk und (optional) lokalen Endpunkt vor der Installation klären
- 2In vier Schritten abnehmen:
onboard→models status→ Dashboard → minimaler Agent - 3Fehlersuche: Schlüssel → Provider → Modell-ID → Netzwerk/lokaler Dienst → Logs
- 4Keine Secrets ins Repo; Modellprobleme von Port-/Berechtigungsfehlern trennen
Auf dem Mac mini läuft die Modellkette runder
Gateway und lokale Inferenz auf macOS teilen einen klaren Weg: Node 24, launchd und Vererbung der Umgebungsvariablen greifen ineinander. Der Unified Memory des Mac mini M4 eignet sich für mittelgroße lokale Modellversuche; rund 4 W im Leerlauf für 24/7-Gateways; Gatekeeper / FileVault begrenzen das Risiko für Schlüssel. Wenn Onboarding und Dashboard-Abnahme stabil bleiben sollen, ist der Mac mini M4 ein starkes Fundament — jetzt lohnt sich der Einstieg in diese Hardware.