---
title: "Usa RunAPI in OpenClaw — Guida di configurazione compatibile con OpenAI"
url: "https://runapi.ai/it/openclaw.md"
canonical: "https://runapi.ai/it/openclaw"
locale: "it"
---

# RunAPI in OpenClaw

RunAPI funziona come endpoint compatibile con OpenAI per OpenClaw. Copia il prompt in OpenClaw, lascia che aggiunga il provider e usa la scheda config solo quando vuoi controllare i campi esatti.

## 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. **Incolla il prompt di configurazione** — Copia il prompt dalla prima scheda in OpenClaw. Indica a OpenClaw di leggere RUNAPI_API_KEY, aggiungere il provider runapi e mantenere disponibili i provider esistenti.
2. **Controlla la config generata** — OpenClaw dovrebbe aggiungere gpt-5.2 come ID del modello locale al provider, quindi selezionarlo tramite il riferimento con prefisso provider runapi/gpt-5.2.
3. **Verifica la selezione** — Esegui openclaw models status, passa al modello RunAPI e avvia una sessione OpenClaw. Se il modello non compare, verifica che la allowlist includa runapi/gpt-5.2.

## FAQ

### OpenClaw può usare RunAPI come provider di modelli personalizzato?

Sì. OpenClaw supporta provider personalizzati compatibili con OpenAI tramite models.providers. Configura RunAPI con l’URL base /v1, imposta api su openai-completions e scegli il riferimento al modello con prefisso provider in agents.defaults.model.primary.

### L’ID del modello deve includere il prefisso del provider dentro models.providers?

No. Dentro models.providers.runapi.models, usa l’ID locale del provider, ad esempio gpt-5.2. Usa il riferimento con prefisso provider runapi/gpt-5.2 quando selezioni il modello nei default o nei comandi di OpenClaw.

### Dove devo salvare la API key di RunAPI?

Salva la chiave in RUNAPI_API_KEY e leggila dalla configurazione di OpenClaw. Così il segreto resta fuori dal controllo versione e la stessa config funziona su shell locali, server e automazioni.

### Posso mantenere i miei modelli OpenClaw esistenti come fallback?

Sì. Lascia models.mode su merge e aggiungi RunAPI come un provider. I provider esistenti restano disponibili e puoi aggiungere fallback sotto agents.defaults.model.fallbacks quando vuoi un comportamento di recovery.


## Links

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