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

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.

FAQ

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 →