---
title: "RunAPI in OpenClaw nutzen - OpenAI-kompatible Setup-Anleitung"
url: "https://runapi.ai/de/openclaw.md"
canonical: "https://runapi.ai/de/openclaw"
locale: "de"
---

# RunAPI in OpenClaw

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.

## Install prompt

Copy this prompt into OpenClaw:

```text
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.5" with display name "RunAPI GPT 5.5".
- Set the default model to "runapi/gpt-5.5" while keeping existing providers available.
- After editing config, run `openclaw models status` and confirm `runapi/gpt-5.5` appears.
- If RUNAPI_API_KEY is missing, ask me to set it before starting OpenClaw.
```

## Configuration

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

## Steps

1. **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.
2. **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.
3. **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.

## FAQ

### 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.


## Links

- [Model catalog](https://runapi.ai/de/models)
- [CLI](https://runapi.ai/de/cli)
- [MCP Server](https://runapi.ai/de/mcp)
- [Pricing](https://runapi.ai/de/pricing)
- [API docs](https://runapi.ai/de/docs)
- [Hermes Agent setup](https://runapi.ai/de/hermes-agent)