Claude visitors: new accounts receive $1.00 in bonus API credit within 30 days. One per person; usage credits only.

GUIDA OPENCLAW

Usa RunAPI in OpenClaw.

Collega OpenClaw a 250+ modelli AI tramite RunAPI. Genera video, immagini, musica e audio direttamente dal tuo agente OpenClaw con una sola API key.

Ottieni API key gratuita Vedi la documentazione

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

Prompt di configurazione

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

Modelli disponibili per OpenClaw

HappyHorse/happyhorse-1.0-i2v

Accesso all'API di HappyHorse per generazione video da testo, da immagine ed edit-video con output 720p/1080p e clip guidate da personaggi.

Qwen 2/qwen-2-edit-image

Accesso all'API di Qwen 2 per text-to-image e modifica delle immagini dalla famiglia di modelli visivi di Alibaba.

Producer/fuzz-0.8

Accesso all'API Producer per generare musica FUZZ da testi forniti integralmente o da brief di produzione per brani strumentali.

ElevenLabs/text-to-dialogue-v3

ElevenLabs offre sintesi vocale multilingue e dialoghi con più voci tramite RunAPI.

Qwen/qwen3.5-122b-a10b

Accesso API Qwen tramite RunAPI: modelli linguistici open-weight Qwen3.5, Qwen3.6, Qwen3-VL e Qwen3-Coder-Next su Chat Completions compatibile OpenAI.

Qwen/qwen3.5-27b

Accesso API Qwen tramite RunAPI: modelli linguistici open-weight Qwen3.5, Qwen3.6, Qwen3-VL e Qwen3-Coder-Next su Chat Completions compatibile OpenAI.

COME FUNZIONA

Connettiti in 3 passaggi

Configura

Aggiungi la chiave API RunAPI alla configurazione di OpenClaw. Una chiave consente di accedere a tutti i modelli.
Seleziona i modelli

Scegli i modelli utilizzabili dal tuo agente. Filtra per modalità, qualità o costo.
Genera

Il tuo agente OpenClaw genera contenuti tramite l’API unificata di RunAPI. I risultati vengono consegnati tramite webhook o interrogazioni periodiche.

CASI D'USO

Contenuti automatizzati

Lascia che OpenClaw generi automaticamente video di marketing, immagini di prodotto e contenuti audio.

Flussi di lavoro multimodali

Concatena la generazione di video, immagini e musica in un'unica conversazione dell'agente.

Routing ottimizzato sui costi

OpenClaw può confrontare i prezzi dei modelli e scegliere l'opzione più conveniente.

Domande di configurazione di OpenClaw

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.

OpenClaw può generare immagini tramite RunAPI senza installare skill aggiuntive?

Sì. Lo stesso RUNAPI_API_KEY e l’endpoint /v1 configurati per la chat accettano anche richieste di immagini. Specifica un modello come flux-kontext-pro o imagen-4 e OpenClaw lo chiamerà tramite il provider RunAPI esistente, senza skill GitHub né chiavi API separate. La guida completa è nella pagina di generazione immagini di OpenClaw.

Come fa l’agente OpenClaw a sapere quando un’attività di immagini o video è pronta?

Le attività di immagini, video e musica sono asincrone. RunAPI restituisce un ID attività alla prima chiamata. L’agente OpenClaw interroga l’endpoint di stato fino al completamento, poi riceve l’URL del risultato. Il RunAPI SDK gestisce automaticamente il polling se lo utilizzi.

Altri modi per eseguire RunAPI da un agente

Automazione dei flussi

Hermes Agent

Inoltra i passaggi di generazione tramite Hermes e lascia che scelga il modello per ogni attività. Stessa chiave, stesso saldo, nessuna configurazione aggiuntiva.

Assistente del team

WorkBuddy

Dai a un assistente dello spazio di lavoro condiviso accesso ai modelli video, immagini e LLM con limiti di spesa per chiave.

SDK o MCP

Costruisci il tuo

Collega qualsiasi agente con l’ SDK di RunAPI o il server MCP — strumenti, polling e webhook inclusi.

Stai costruendo con un team?

Ti aiutiamo con la configurazione enterprise, le integrazioni e le domande tecniche.

Contattaci