---
title: &quot;Gebruik RunAPI in OpenClaw — OpenAI-compatibele setupgids&quot;
url: &quot;https://runapi.ai/nl/openclaw.md&quot;
canonical: &quot;https://runapi.ai/nl/openclaw&quot;
locale: &quot;nl&quot;
---

# RunAPI in OpenClaw

RunAPI werkt als een OpenAI-compatibele endpoint voor OpenClaw. Kopieer de prompt naar OpenClaw, laat de agent de provider toevoegen en gebruik het config-tabblad alleen als je de exacte velden wilt controleren.

## 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 &quot;https://runapi.ai/v1&quot;.
- Use api &quot;openai-completions&quot;.
- Register provider-local model id &quot;gpt-5.5&quot; with display name &quot;RunAPI GPT 5.5&quot;.
- Set the default model to &quot;runapi/gpt-5.5&quot; 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. **Plak de setup-prompt** — Kopieer de prompt uit het eerste tabblad naar OpenClaw. Die laat OpenClaw RUNAPI_API_KEY lezen, de runapi-provider toevoegen en bestaande providers beschikbaar houden.
2. **Controleer de gegenereerde configuratie** — OpenClaw moet gpt-5.2 toevoegen als provider-lokale model-ID en die vervolgens selecteren via de provider-voorvoegselreferentie runapi/gpt-5.2.
3. **Verifieer de selectie** — Voer openclaw models status uit, schakel over naar het RunAPI-model en start een OpenClaw-sessie. Als het model niet verschijnt, controleer dan of de allowlist runapi/gpt-5.2 bevat.

## FAQ

### Kan OpenClaw RunAPI gebruiken als aangepaste modelprovider?

Ja. OpenClaw ondersteunt aangepaste OpenAI-compatibele providers via models.providers. Configureer RunAPI met de /v1 base URL, zet api op openai-completions en kies de provider-voorvoegselmodelreferentie in agents.defaults.model.primary.

### Moet de model-ID in models.providers de providerprefix bevatten?

Nee. Gebruik binnen models.providers.runapi.models de provider-lokale ID, zoals gpt-5.2. Gebruik de provider-voorvoegselreferentie runapi/gpt-5.2 wanneer je het model selecteert in OpenClaw defaults of commando&#39;s.

### Waar moet ik de RunAPI API-key opslaan?

Sla de sleutel op in RUNAPI_API_KEY en lees die in vanuit de OpenClaw-config. Zo blijft de credential buiten versiebeheer en kun je dezelfde configuratie gebruiken in lokale shells, servers en automatisering.

### Kan ik mijn bestaande OpenClaw-modellen behouden als fallbacks?

Ja. Laat models.mode op merge staan en voeg RunAPI toe als één provider. Je bestaande providers blijven beschikbaar en je kunt fallbacks toevoegen onder agents.defaults.model.fallbacks wanneer je herstelgedrag wilt.


## Links

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