OpenClaw Fehlerbehebung — API Key Einrichtungsanleitung

🔧 Häufige Problembehebung

Dein API Key ist konfiguriert aber gibt einen Fehler? Keine Sorge, häufige Probleme sind alle hier.

Häufige Fehler und Lösungen

❌ 401 Unauthorized / Invalid API Key

Ursache:API Key ungültig oder abgelaufen.

Überprüfe dass Dein Key vollständig kopiert wurde (keine extra Leerzeichen oder fehlende Zeichen)
Stelle sicher dass Dein Key nicht deaktiviert oder gelöscht wurde
Bestätige dass baseUrl und API Key zusammenpassen (don't put OpenAI Key in Anthropic address)
Für Coding Plan nutze die Coding Plan Key mit der entsprechenden Coding Plan Adresse

❌ 429 Too Many Requests / Rate Limited

Ursache:Anfragen zu häufig, über Rate Limit hinaus.

Warte eine Weile und versuche es erneut
Wenn Du häufig gedrosselt wirst, erwäge ein Upgrade zu Coding Plan (höhere Rate Limits)
Oder konfiguriere mehrere Anbieter um Anfragen zu verteilen

❌ 402 Payment Required / Insufficient Balance

Ursache:Guthaben zu niedrig.

Gehe zur entsprechenden Plattform und lade auf
Überprüfe ob es unbezahlte Rechnungen gibt
Überprüfe ob kostenloses Guthaben aufgebraucht ist

❌ Connection Timeout / Network Error

Ursache:Netzwerk-Verbindungsproblem.

Internationale Anbieter (OpenAI, Anthropic, Gemini) brauchen möglicherweise VPN in China
Chinesische Anbieter (DeepSeek, MiniMax usw.) sollten ohne VPN funktionieren
Überprüfe dass baseUrl korrekt ist, keine Tippfehler
Versuche curl Befehl zum Testen der Verbindung

❌ 400 Bad Request / Invalid Model

Ursache:Modellname falsch oder Dein Konto hat keinen Zugriff auf das Modell.

Überprüfe dass der Modellname in der models Konfiguration korrekt ist
Stelle sicher dass Dein Konto/Plan das Modell unterstützt
Siehe die verfügbare Modelliste auf der Anbieterseite

Debug Techniken

1. Überprüfe aktuelle Konfiguration:

cat ~/.openclaw/openclaw.json

2. Teste API Verbindung:

# 测试 DeepSeek
curl -s https://api.deepseek.com/v1/models -H "Authorization: Bearer sk-dein-key"

# Teste OpenAI
curl -s https://api.openai.com/v1/models -H "Authorization: Bearer sk-dein-key"

3. Schaue OpenClaw Logs an:

openclaw logs

4. Starte Gateway neu:

openclaw gateway restart

💡 Du findest immer noch keine Lösung?Die meisten Probleme kommen von falscher baseUrl oder unvollständig kopiertem API Key. Überprüfe sorgfältig gegen die Beispiele auf der Anbieterseite.