OpenClaw-Anbindung an die Claude-API

Dokumentation gepflegt von 1ZheAI. Quellen und Korrekturen.

Fehler gefunden? Support kontaktieren mit Seitenadresse und Beschreibung. Senden Sie keine API-Schlüssel oder Kontodaten.

Verwende die Funktion für benutzerdefinierte Anbieter in OpenClaw, um dich mit 1折AI zu verbinden. Erstelle zuerst einen API-Schlüssel und bestätige die aktuell verfügbaren Modelle; die nachfolgenden Modell-IDs sind Beispiele, passe sie an die Berechtigungen deines Schlüssels an.

Datum der Überprüfung der offiziellen Konfiguration: 2026-10-15. Die folgende Konfiguration basiert auf der offiziellen Dokumentation; die End-to-End-Verifizierung auf dieser Website ist noch nicht abgeschlossen; führe zuerst eine kurze Frage-Antwort- und Tool-Aufruf-Verifizierung durch, bevor du sie für lange Aufgaben verwendest. OpenAI-/GPT-Modelle sind live, Modellliste und Preise siehe Modellbeschreibung.

Gemäß benutzerdefiniertem Anbieter und Konfigurationsbeispiel in ~/.openclaw/openclaw.json zusammenführen:

json

{
  "agents": {
    "defaults": {
      "model": { "primary": "onezhe/claude-sonnet-4-6" },
      "models": { "onezhe/claude-sonnet-4-6": { "alias": "1折AI Claude" } }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "onezhe": {
        "baseUrl": "https://1zheai.com",
        "apiKey": "${ONEZHE_API_KEY}",
        "api": "anthropic-messages",
        "models": [
          { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }
        ]
      }
    }
  }
}

Stelle sicher, dass der Prozess, der tatsächlich das Gateway ausführt, ONEZHE_API_KEY lesen kann; Umgebungsvariablen im Terminal werden nicht unbedingt an einen bereits laufenden Hintergrunddienst weitergegeben. Die offizielle Synthetic-Dokumentation legt fest, dass der Anthropic-Client automatisch /v1 anhängt, daher wird hier kein /v1 mitgeführt und kein vollständiges /v1/messages eingetragen.

Bei der Umstellung auf Chat Completions paarweise ersetzen durch baseUrl: "https://1zheai.com/v1" und api: "openai-completions". Obwohl der Name completions enthält, entspricht dieser Adapter /v1/chat/completions; wähle nicht fälschlich openai-responses. Eine vorhandene Modell-Allowlist muss die übrigen Einträge behalten und das neue Modell hinzufügen. Das Beispiel erfindet keine Kosten- oder Kontextparameter; falls die Validierung der aktuell installierten Version zusätzliche Metadaten erfordert, überprüfe zuerst die tatsächlichen Modellfähigkeiten, bevor du ergänzt.

Verbindung verifizieren und Fehler beheben

1. Konfiguration speichern und neu laden, bestätige, dass der aktuell ausgewählte Anbieter onezhe oder dein hinzugefügtes benutzerdefiniertes Modell ist.
2. Sende eine kurze Frage und bestätige, dass eine Antwort zurückkommt; versuche anschließend eine kleine, rückgängig zu machende Aufgabe und bestätige Tool-Aufrufe und Mehrrunden-Dialoge getrennt.
3. Öffne die Aufrufprotokolle und prüfe Anfragezeit, Modell, Status und Verbrauch. Ein erfolgreicher Textantwort bedeutet nicht, dass alle Agent-Fähigkeiten kompatibel sind.
4. Bei 404 Adresse und Protokoll dieser Seite auf passende Kombination prüfen; bei 401 Herkunft des Schlüssels und ob der Prozess die Umgebungsvariablen gelesen hat prüfen; bei 429 Rate-Limit-Informationen ansehen und dann erneut versuchen. Weitere Fälle siehe Fehlercodes und Fehlerbehebung.

Schlüssel nur in der lokalen Umgebung oder im Anmeldeinformationenspeicher des Tools speichern, nicht in Code-Repositorys, Screenshots oder öffentliche Protokolle einreichen. Hintergrunddienste erben möglicherweise die Terminal-Umgebungsvariablen nicht; Hilfsmodelle, Suche und andere Tools können ebenfalls eigene Anbieter-Einstellungen haben und müssen separat geprüft werden.

Kosten und andere Anbindungsmethoden

Siehe Claude-API-Echtzeitpreise und Abrechnungsregeln. Für andere Clients zurück zum Tool-Anbindungsverzeichnis; zum eigenständigen Programmieren nutze SDK- und Entwicklungsleitfaden.