OpenClaw-Konfiguration
OpenClaw ist ein Terminal-/Web-UI-Tool, das für Programmierszenarien entwickelt wurde. Es unterstützt mehrere Modellprotokolle, daher besteht der Schwerpunkt der Konfiguration nicht nur im Eintragen einer Adresse, sondern darin, dass baseUrl und api paarweise zueinander passen.
Worum es sich bei diesem Tool handelt und wofür es verwendet wird
Zuerst festlegen, welches Protokoll gewählt werden soll
| Szenarien | So ermitteln Sie die Base URL | So wählen Sie das API-Feld aus |
|---|---|---|
| OpenAI Nativ | Verwenden Sie die vom Provider bereitgestellte OpenAI- / OpenAI-kompatible API-Adresse; ob /v1 enthalten sein muss, hängt vom Backend ab | openai-responses |
| Claude Nativ | Verwenden Sie die vom Provider bereitgestellte Anthropic- / Claude-Schnittstellenadresse | anthropic-messages |
| Gemini Nativ | Verwenden Sie die vom Provider bereitgestellte Google- / Gemini-Schnittstellenadresse | google-generative-ai |
| Kompatibilitätsmodus | Die OpenAI-kompatible Schnittstellenadresse des Providers | openai-completions |
Wenn auf der Seite des Providers die OpenAI-, Claude- und Gemini-Schnittstellen getrennt aufgeführt sind, kopieren Sie nicht nur den Domainnamen, sondern auch die vollständige Adresse für das entsprechende Protokoll.
Referenz für Konfigurations-Snippets
Konfigurationsdateien befinden sich normalerweise unter ~/. openclaw/openclaw.json Wenn der Initialisierungsassistent die Provider-Adresse nicht korrekt eintragen kann, können Sie die Modellauswahl zunächst überspringen und die Konfigurationsdatei anschließend manuell bearbeiten.
"models": { "providers": { "mz-openai": { "baseUrl": "https://YOUR_PROVIDER_API_URL", "apiKey": "YOUR_KEY", "auth": "api-key", "api": "openai-responses", "models": [ { "id": "MODEL_ID_FROM_PROVIDER_DASHBOARD", "name": "DISPLAY_NAME", "reasoning": false, "input": [], "contextWindow": 128000, "maxTokens": 32000 } ] } } }So prüfen Sie die Einstellungen nach dem Speichern
- Konfigurieren Sie zunächst nur einen Provider und fügen Sie nicht zu viele Modelle auf einmal hinzu.
- Öffnen Sie das Testprojekt und wählen Sie das neu hinzugefügte Modell aus.
- Senden Sie eine möglichst kurze Testfrage wie z. B. „Bitte antworte nur mit: Konfiguration erfolgreich.“
- Falls ein Protokollfehler gemeldet wird, prüfen Sie zuerst, ob das api-Feld und die Base URL vom selben Schnittstellentyp stammen.
Häufige Fragen für Einsteiger
| Phänomen | Prioritätsprüfung | Lösung |
|---|---|---|
| Protokollbezogener Fehler | Ob das api-Feld zur Base URL passt | Kombinieren Sie OpenAI, Claude und Gemini nicht miteinander; tragen Sie die Werte passend zum Protokoll des jeweiligen Providers ein |
| Die Modellliste ist leer | Unterstützt der Provider das Abrufen der Modellliste? | Geben Sie die vom Backend bereitgestellte Modell-ID / den Modellnamen manuell ein, wenn das automatische Abrufen fehlschlägt |
| Die Konfigurationsdatei wurde geändert, wird aber nicht wirksam | Wurde tatsächlich die von OpenClaw ausgelesene Konfigurationsdatei bearbeitet? | Starten Sie OpenClaw neu und testen Sie erneut; ändern Sie nicht mehrere Konfigurationseinstellungen gleichzeitig |
| Key ist korrekt, schlägt aber trotzdem fehl | Die Felder auth und apiKey des aktuellen Providers | Stellen Sie sicher, dass der Key zum aktuellen Protokoll und zum aktuellen Provider gehört |