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.

GUIDA OPENCLAW

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

Ottieni API key gratuita Leggi la documentazione API

Prompt da copiare · una sola RunAPI key · link al catalogo modelli

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.

{
  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,
          },
        ],
      },
    },
  },
}

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

Copy prompt first /v1

SETUP

Installa RunAPI in OpenClaw con un prompt

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.

Copy prompt

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.

runapi/gpt-5.2

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.

openclaw models status

REFERENCE

Campi di configurazione

Campo	Valore	Scopo
`baseUrl`	`https://runapi.ai/v1`	Punta OpenClaw alla superficie API compatibile con OpenAI di RunAPI.
`apiKey`	`${RUNAPI_API_KEY}`	Legge la API key di RunAPI dall’ambiente.
`api`	`openai-completions`	Usa l’adapter Chat Completions previsto dagli endpoint compatibili con OpenAI.
`agents.defaults.model.primary`	`runapi/gpt-5.2`	Seleziona il modello RunAPI come modello predefinito per le nuove sessioni OpenClaw.

OLTRE GLI LLM

Una sola API key. Immagini, video e musica.

La maggior parte degli utenti OpenClaw installa una GitHub skill separata per ogni modalità — una per le immagini, una per il video, una per la musica. Con RunAPI, la stessa RUNAPI_API_KEY già configurata per la chat chiama anche oltre 113 modelli di immagini, video e musica. Nessuna skill aggiuntiva da installare.

Generazione di immagini

Genera e modifica immagini con Flux Kontext, Imagen 4, Seedream, GPT Image e Nano Banana. Invia un prompt allo stesso endpoint /v1 — RunAPI instrada al modello specificato.

Esplora i modelli di immagini

Generazione di video

Crea video da testo o immagini con Kling 3.0, Seedance 2.0, Veo 3 e Wan 2.7. Stesso ciclo di task, stesso formato di callback, stessa API key.

Esplora i modelli video

Generazione musicale

Genera brani con Suno v4 fino a v5.5. Passa testo, stile e durata — RunAPI restituisce gli URL audio tramite il flusso standard di polling dei task.

Esplora i modelli musicali

GUIDE AI MODELLI

Usa qualsiasi modello in OpenClaw

Ogni guida mostra il prompt, il comando curl, i parametri e le FAQ per chiamare un modello specifico tramite RunAPI all’interno di OpenClaw.

Domande di configurazione di OpenClaw

Usa una sola API key RunAPI dentro OpenClaw.

Esplora il catalogo dei modelli, scegli l’ID del modello e aggiungilo alla configurazione del provider di OpenClaw.

Sfoglia i modelli →

Usa RunAPI in OpenClaw.

Installa RunAPI in OpenClaw con un prompt

Incolla il prompt di configurazione

Controlla la config generata

Verifica la selezione

Campi di configurazione

Una sola API key. Immagini, video e musica.

Generazione di immagini

Generazione di video

Generazione musicale

Usa qualsiasi modello in OpenClaw

Claude

DeepSeek

ElevenLabs

Embedding

Fish Audio

Flux

Flux 2

Flux Kontext

Gemini

Gemini Omni

Gemini TTS

GLM

GPT

GPT Image

GPT Image 2

GPT-4o Image

Grok

Grok Imagine

Hailuo

HappyHorse

Ideogram V3

Imagen 4

InfiniteTalk

Kimi

Kling

Luma

Midjourney

MiMo

MiniMax

MiniMax H3

Nano Banana

OmniHuman

OpenAI Transcription

OpenAI TTS

PixVerse

Producer

Qwen 2

Qwen 3

Qwen Image

Recraft

Runway

Runway Aleph

Seedance

Seedream

Suno

Topaz

Veo 3.1

Volcengine Lip Sync

Wan