Kann OpenClaw RunAPI als eigenen Modell-Provider nutzen?

Ja. OpenClaw unterstützt eigene OpenAI-kompatible Provider über models.providers. Konfiguriere RunAPI mit der /v1 Base URL, setze api auf openai-completions und wähle die provider-präfixierte Modellreferenz in agents.defaults.model.primary.

Soll die Modell-ID in models.providers den Provider-Präfix enthalten?

Nein. Innerhalb von models.providers.runapi.models verwendest du die provider-lokale ID, zum Beispiel gpt-5.2. Die provider-präfixierte Referenz runapi/gpt-5.2 nutzt du erst bei OpenClaw Defaults oder Befehlen.

Wo sollte ich den RunAPI API Key speichern?

Speichere den Key in RUNAPI_API_KEY und lies ihn aus der OpenClaw-Konfiguration. So bleibt das Credential aus der Versionskontrolle heraus und dieselbe Konfiguration funktioniert in lokalen Shells, auf Servern und in Automation.

Kann ich bestehende OpenClaw-Modelle als Fallbacks behalten?

Ja. Belasse models.mode auf merge und füge RunAPI als einen Provider hinzu. Bestehende Provider bleiben verfügbar; Fallbacks kannst du unter agents.defaults.model.fallbacks ergänzen.

OPENCLAW GUIDE

RunAPI in OpenClaw nutzen.

RunAPI funktioniert als OpenAI-kompatibler Endpoint für OpenClaw. Kopiere den Prompt in OpenClaw, lasse den Provider hinzufügen und nutze den Config-Tab nur, wenn du die exakten Felder prüfen willst.

Kostenlosen API Key erhalten Dokumentation lesen

Prompt kopieren · ein RunAPI Key · Links zum Modellkatalog

Configure this OpenClaw workspace to use RunAPI.

Requirements:
- Read the API key from RUNAPI_API_KEY. Do not hardcode the key.
- Add a model provider named runapi.
- Use baseUrl "https://runapi.ai/v1".
- Use api "openai-completions".
- Register provider-local model id "gpt-5.2" with display name "RunAPI GPT 5.2".
- Set the default model to "runapi/gpt-5.2" while keeping existing providers available.
- After editing config, run `openclaw models status` and confirm `runapi/gpt-5.2` appears.
- If RUNAPI_API_KEY is missing, ask me to set it before starting OpenClaw.

{
  agents: {
    defaults: {
      model: { primary: "runapi/gpt-5.2" },
      models: {
        "runapi/gpt-5.2": { alias: "RunAPI GPT 5.2" },
      },
    },
  },
  models: {
    mode: "merge",
    providers: {
      runapi: {
        baseUrl: "https://runapi.ai/v1",
        apiKey: "${RUNAPI_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "gpt-5.2",
            name: "RunAPI GPT 5.2",
            reasoning: false,
            input: ["text"],
            contextWindow: 128000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

export RUNAPI_API_KEY="runapi_xxx"
openclaw models status
openclaw models set runapi/gpt-5.2
openclaw

Copy prompt first /v1

ÜBERBLICK

Was dieses Setup ändert

OpenClaw kann eigene OpenAI-kompatible Modell-Provider über seine Provider-Konfiguration aufrufen. Am schnellsten kopierst du den RunAPI Setup-Prompt in OpenClaw und lässt den Agent seine Konfiguration aktualisieren. Die Provider-ID bleibt lokal in deiner OpenClaw-Konfiguration, die Modellreferenz wird runapi/gpt-5.2, und der API Key bleibt in RUNAPI_API_KEY.

SETUP

RunAPI per Prompt in OpenClaw installieren

Setup-Prompt einfügen

Kopiere den Prompt aus dem ersten Tab in OpenClaw. Er weist OpenClaw an, RUNAPI_API_KEY zu lesen, den runapi Provider hinzuzufügen und bestehende Provider verfügbar zu lassen.

Prompt kopieren

Generierte Konfiguration prüfen

OpenClaw sollte gpt-5.2 als provider-lokale Modell-ID hinzufügen und das Modell dann über die provider-präfixierte Referenz runapi/gpt-5.2 auswählen.

runapi/gpt-5.2

Auswahl verifizieren

Führe openclaw models status aus, wechsle zum RunAPI-Modell und starte eine OpenClaw-Session. Falls das Modell nicht erscheint, prüfe, ob die Allowlist runapi/gpt-5.2 enthält.

openclaw models status

REFERENZ

Konfigurationsfelder

Feld	Wert	Zweck
`baseUrl`	`https://runapi.ai/v1`	Leitet OpenClaw auf RunAPIs OpenAI-kompatible API-Oberfläche.
`apiKey`	`${RUNAPI_API_KEY}`	Liest den RunAPI API Key aus der Umgebung.
`api`	`openai-completions`	Nutzt den Chat-Completions-Adapter für OpenAI-kompatible Endpoints.
`agents.defaults.model.primary`	`runapi/gpt-5.2`	Setzt das RunAPI-Modell als Standardmodell für neue OpenClaw-Sessions.

FAQ

Fragen zum OpenClaw Setup

Ein RunAPI Key in OpenClaw.

Durchsuche den Modellkatalog, wähle die Modell-ID und füge sie deiner OpenClaw-Provider-Konfiguration hinzu.

Modelle durchsuchen →