Coding Agents einrichten

OpenClaw einrichten: API Key, Base URL und eigene Modelle

Konfiguriere models.providers in OpenClaw, BetterToken API Key, Base URL und Modelle für OpenAI Responses oder Chat Completions und prüfe das Gateway.

openai-responses: /v1/responses; openai-completions: /v1/chat/completions. Base URL: https://bettertoken.ai/v1.

Wichtige Einstellungen

Feld	Wert
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Modell	`YOUR_MODEL_ID`

Voraussetzungen

Installiere die aktuelle Version von OpenClaw
Erstelle einen BetterToken API Key
Kopiere eine Modell-ID aus dem model plaza oder dem Dialog Setup des Key

Registrieren und BetterToken API Key erhalten

Du hast bereits ein Konto? Melde dich an, lade Guthaben auf und erstelle dann einen Schlüssel in der Konsole.

Die Beispiele verwenden zur Veranschaulichung einen API-Key-Platzhalter. Für gespeicherte Konfigurationen empfiehlt OpenClaw eine SecretRef oder die Ersetzung durch eine Umgebungsvariable für models.providers.bettertoken.apiKey. Folge den offiziellen Hinweisen zu Zugangsdaten, statt einen echten Key in einer gemeinsam genutzten Datei abzulegen.

Installation

macOS / Linux

curl -fsSL https://openclaw.ai/install.sh | bash

Windows

iwr -useb https://openclaw.ai/install.ps1 | iex

Konfiguration über die Befehlszeile

Das automatische BetterToken-Konfigurationsskript schreibt die OpenClaw-Konfiguration. Es benötigt Node.js. Wenn du API Key oder Modell-ID nicht als Argument übergibst, fragt das Skript danach.

macOS / Linux

curl -fsSL "https://bettertoken.ai/install-openclaw-provider.sh" | bash

Windows

iwr "https://bettertoken.ai/install-openclaw-provider.ps1" -OutFile "$env:TEMP\install-openclaw-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-openclaw-provider.ps1"

Prüfe, ob agents.defaults.model.primary die in Setup angezeigte YOUR_MODEL_ID verwendet. Führe danach die folgenden Befehle zur Validierung und zum Neustart des Gateway aus.

Manuelle Konfiguration

OpenClaw konfigurieren

Bearbeite ~/.openclaw/openclaw.json. Verwende nur das Beispiel, das zum Anbieter deiner Modell-ID passt.

Responses API

{
  "models": {
    "mode": "merge",
    "providers": {
      "bettertoken": {
        "baseUrl": "https://bettertoken.ai/v1",
        "apiKey": "YOUR_API_KEY",
        "api": "openai-responses",
        "models": [
          {
            "id": "YOUR_MODEL_ID",
            "name": "YOUR_MODEL_ID"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bettertoken/YOUR_MODEL_ID"
      }
    }
  }
}

Chat Completions

{
  "models": {
    "mode": "merge",
    "providers": {
      "bettertoken": {
        "baseUrl": "https://bettertoken.ai/v1",
        "apiKey": "YOUR_API_KEY",
        "api": "openai-completions",
        "models": [
          {
            "id": "YOUR_MODEL_ID",
            "name": "YOUR_MODEL_ID"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bettertoken/YOUR_MODEL_ID"
      }
    }
  }
}

openai-responses: /v1/responses; openai-completions: /v1/chat/completions. Base URL: https://bettertoken.ai/v1.

Verbindung prüfen

Führe Folgendes aus:

openclaw config validate
openclaw gateway restart
openclaw models list
openclaw models status

Die Konfiguration ist aktiv, wenn die Validierung erfolgreich ist, das Gateway neu startet und bettertoken/YOUR_MODEL_ID in Modellliste und Status erscheint. Wenn eine vorhandene Sitzung weiterhin ein altes Modell verwendet, starte eine neue Sitzung und prüfe erneut.

Modelle wechseln

Füge das neue Modell zu models.providers.bettertoken.models hinzu und ändere agents.defaults.model.primary in bettertoken/YOUR_MODEL_ID. Speichere, validiere die Konfiguration und starte das Gateway neu.

Häufige Fehler

Fehler	Lösung
`config validate` schlägt fehl	Prüfe Kommas, Anführungszeichen und Klammern im JSON.
`401`	Kopiere `apiKey` erneut und entferne Leerzeichen.
`404`	`openai-responses`: `/v1/responses`; `openai-completions`: `/v1/chat/completions`. Base URL: `https://bettertoken.ai/v1`.
Modell fehlt	Prüfe, ob es sowohl in der Modellliste des Anbieters als auch in `agents.defaults.model.primary` vorhanden ist.
Vorhandene Sitzung verwendet das alte Modell	Führe `openclaw gateway restart` aus und erstelle eine neue Sitzung.